Core - v1.2.0
ArtisanPack UI Core Documentation
The foundation package every other ArtisanPack UI package depends on. Provides unified configuration, structured logging, Blade directive helpers, a diagnostic runner, cross-package compatibility analysis, Packagist-backed update checking, a shared base service provider, and the package-management Artisan commands.
Core 1.2 — package management. Adds the
ArtisanPackServiceProviderbase class, theConfigurationManager+ConfigurationSchemavalidation pipeline, theLoggerFactory/ArtisanPackLoggerlogging stack, theBladeDirectiveRegistrarhelper, theDiagnosticRunner, theCompatibilityChecker, theUpdateChecker, the sharedConstants/ Enums / Exceptions surface, theArtisanPackTestCasetesting utilities, and theartisanpack:diagnose,artisanpack:check-compatibility,artisanpack:check-updates, andartisanpack:make-packagecommands. See CHANGELOG.md for the full release notes.
What's in this package
- Unified configuration —
config/artisanpack.php, theConfigurationManagerservice, theConfigurationSchemavalidator, theArtisanPackConfigfacade, and theartisanpack_config()helper - Shared base service provider —
ArtisanPackServiceProviderremoves the boilerplate every sibling package previously hand-rolled (config merging, command registration, view loading, route loading, container singletons) - Logging stack —
LoggerFactory,Logger, theArtisanPackLoggerinterface, theArtisanPackLogfacade, and theAuditLogCreatedevent for compliance-relevant actions - Blade directive registrar —
BladeDirectiveRegistrar+artisanpack_blade()helper. Replaces hand-rolledBlade::directive()template strings with intent-revealing methods (echo,escaped,conditional,wrap,livewireAction,facade) - Diagnostics —
DiagnosticRunnerwith five default checks (environment, installed packages, configuration, service bindings, Artisan commands), exposed viaphp artisan artisanpack:diagnose - Compatibility analysis —
CompatibilityCheckerreports cross-package, PHP, Laravel, and PHP extension constraints, exposed viaphp artisan artisanpack:check-compatibility - Update checking —
UpdateChecker+PackagistClientreport available updates, flag security releases, and classify changes as major / minor / patch, exposed viaphp artisan artisanpack:check-updates - Package management —
php artisan artisanpack:install-packages,php artisan artisanpack:make-package,php artisan artisanpack:scaffold-config - Shared primitives —
Constants(package identifiers, config keys, version baselines),Enums(LogLevel,Package,Priority,Status),Exceptions(ArtisanPackException+ 5 specialised subclasses) - Testing utilities —
ArtisanPackTestCaseplus theArtisanPackAssertions,InteractsWithConfiguration, andMocksArtisanPackServicesconcerns
What's NOT in this package (sibling packages)
| Capability | Package |
|---|---|
| WCAG color contrast utilities, accessible text colors | artisanpack-ui/accessibility |
| Sanitization, escaping, KSES, CSP, security headers, rate limiting | artisanpack-ui/security |
| WordPress-style actions / filters for Laravel | artisanpack-ui/hooks |
| Extensible icon registration on top of Blade Icons | artisanpack-ui/icons |
| 70+ pre-built Livewire UI components | artisanpack-ui/livewire-ui-components |
| Media upload, image processing, folder + tag management | artisanpack-ui/media-library |
| CMS framework — posts, pages, taxonomies, settings | artisanpack-ui/cms-framework |
Documentation map
- Getting Started — install, scaffold config, first
artisanpack:diagnoserun - Installation — requirements, configuration, environment variables, configuration management
- Usage — service provider, configuration manager, logging, Blade directives, diagnostics, compatibility, updates, Artisan commands, testing utilities, enums + exceptions
- API Reference — every public class, method, helper function, facade, exception, and enum the package exposes
- Advanced — creating new packages with
artisanpack:make-package, upgrading from 1.1 to 1.2 - FAQ
- Troubleshooting
- Changelog