Core - v1.2.0

Artisan commands

ArtisanPack UI Core registers six Artisan commands. Every command supports --help for a full option listing.

Command Purpose Added
artisanpack:scaffold-config Generate or refresh the unified config/artisanpack.php file. 1.0
artisanpack:install-packages Interactive installer for sibling ArtisanPack UI packages (Composer + NPM). 1.1
artisanpack:diagnose Run the diagnostic suite and report installation health. 1.2
artisanpack:check-compatibility Analyse cross-package / PHP / Laravel / extension compatibility. 1.2
artisanpack:check-updates Check Packagist for available updates to installed packages. 1.2
artisanpack:make-package Scaffold a new ArtisanPack UI package from the standard blueprint. 1.2

artisanpack:scaffold-config

Generates config/artisanpack.php ( the unified configuration file every ArtisanPack UI package merges into ) and adds a section for every installed sibling package.

php artisan artisanpack:scaffold-config            # preserves existing keys (default)
php artisan artisanpack:scaffold-config --force    # overwrites existing keys with package defaults

Re-run any time you install or remove a sibling package to keep the config in sync.

artisanpack:install-packages

Interactive installer that walks you through choosing sibling Composer packages (and NPM packages), confirms before running, then triggers artisanpack:scaffold-config for you.

# Interactive
php artisan artisanpack:install-packages

# Non-interactive — explicit selection
php artisan artisanpack:install-packages \
    --packages=artisanpack-ui/security,artisanpack-ui/media-library \
    --npm-packages=@artisanpack-ui/livewire-drag-and-drop

# Non-interactive — install everything
php artisan artisanpack:install-packages --all

# Skip the NPM prompt entirely
php artisan artisanpack:install-packages --skip-npm

# Skip the automatic scaffold-config call
php artisan artisanpack:install-packages --skip-scaffold

# Skip per-package post-install commands
php artisan artisanpack:install-packages --skip-post-install

# Preview what would happen
php artisan artisanpack:install-packages --dry-run

artisanpack:diagnose

Runs the five default diagnostic checks and prints a report:

php artisan artisanpack:diagnose

# JSON for scripting / CI
php artisan artisanpack:diagnose --json

# Restrict to a single check
php artisan artisanpack:diagnose --package=environment

# Auto-fix fixable checks (today: the missing-config check)
php artisan artisanpack:diagnose --fix

Exits non-zero when any check reports an error. See Diagnostics for the full check inventory.

artisanpack:check-compatibility

Walks every installed ArtisanPack UI package's Composer requirements and confirms the local environment satisfies them.

php artisan artisanpack:check-compatibility

# JSON for scripting / CI
php artisan artisanpack:check-compatibility --json

# Treat warnings as errors (non-zero exit on warnings)
php artisan artisanpack:check-compatibility --strict

# Restrict the report to a single package
php artisan artisanpack:check-compatibility --package=artisanpack-ui/media-library

Exits non-zero when any error-severity row is reported. See Compatibility analysis for the full report shape.

artisanpack:check-updates

Reads composer.lock, asks Packagist for the latest stable release of every installed ArtisanPack UI package, and reports the available updates.

php artisan artisanpack:check-updates

# JSON for scripting / CI
php artisan artisanpack:check-updates --json

# Skip major updates (only minor + patch)
php artisan artisanpack:check-updates --minor-only

# Only security-related releases
php artisan artisanpack:check-updates --security-only

# Include changelog excerpts + source URLs
php artisan artisanpack:check-updates --changelog

Always exits zero. See Updates for the full report shape and caching behaviour.

artisanpack:make-package

Scaffolds a new ArtisanPack UI package from the standard blueprint. Use this when starting a new sibling package — it generates a composer.json, service provider, facade, config stub, tests, and the conventional directory layout in one command.

# Minimal package
php artisan artisanpack:make-package artisanpack-ui/new-package

# Custom output path
php artisan artisanpack:make-package artisanpack-ui/new-package --path=/tmp/scaffold

# Include Livewire components scaffolding
php artisan artisanpack:make-package artisanpack-ui/new-package --with-livewire

# Include views directory + Blade registration
php artisan artisanpack:make-package artisanpack-ui/new-package --with-views

# Include routes file + route loading
php artisan artisanpack:make-package artisanpack-ui/new-package --with-routes

# Include migrations directory + migration loading
php artisan artisanpack:make-package artisanpack-ui/new-package --with-migrations

# Include an example Artisan command
php artisan artisanpack:make-package artisanpack-ui/new-package --with-commands

# Combine flags — full-featured scaffold
php artisan artisanpack:make-package artisanpack-ui/new-package \
    --with-livewire --with-views --with-routes --with-migrations --with-commands

# Overwrite an existing scaffold
php artisan artisanpack:make-package artisanpack-ui/new-package --force

See Creating new packages for a complete walk-through.