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 ArtisanPackServiceProvider base class, the ConfigurationManager + ConfigurationSchema validation pipeline, the LoggerFactory / ArtisanPackLogger logging stack, the BladeDirectiveRegistrar helper, the DiagnosticRunner, the CompatibilityChecker, the UpdateChecker, the shared Constants / Enums / Exceptions surface, the ArtisanPackTestCase testing utilities, and the artisanpack:diagnose, artisanpack:check-compatibility, artisanpack:check-updates, and artisanpack:make-package commands. See CHANGELOG.md for the full release notes.

What's in this package

  • Unified configurationconfig/artisanpack.php, the ConfigurationManager service, the ConfigurationSchema validator, the ArtisanPackConfig facade, and the artisanpack_config() helper
  • Shared base service providerArtisanPackServiceProvider removes the boilerplate every sibling package previously hand-rolled (config merging, command registration, view loading, route loading, container singletons)
  • Logging stackLoggerFactory, Logger, the ArtisanPackLogger interface, the ArtisanPackLog facade, and the AuditLogCreated event for compliance-relevant actions
  • Blade directive registrarBladeDirectiveRegistrar + artisanpack_blade() helper. Replaces hand-rolled Blade::directive() template strings with intent-revealing methods (echo, escaped, conditional, wrap, livewireAction, facade)
  • DiagnosticsDiagnosticRunner with five default checks (environment, installed packages, configuration, service bindings, Artisan commands), exposed via php artisan artisanpack:diagnose
  • Compatibility analysisCompatibilityChecker reports cross-package, PHP, Laravel, and PHP extension constraints, exposed via php artisan artisanpack:check-compatibility
  • Update checkingUpdateChecker + PackagistClient report available updates, flag security releases, and classify changes as major / minor / patch, exposed via php artisan artisanpack:check-updates
  • Package managementphp artisan artisanpack:install-packages, php artisan artisanpack:make-package, php artisan artisanpack:scaffold-config
  • Shared primitivesConstants (package identifiers, config keys, version baselines), Enums (LogLevel, Package, Priority, Status), Exceptions (ArtisanPackException + 5 specialised subclasses)
  • Testing utilitiesArtisanPackTestCase plus the ArtisanPackAssertions, InteractsWithConfiguration, and MocksArtisanPackServices concerns

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:diagnose run
  • 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