justbetter/statamic-base

Statamic Base

Foundation addon for JustBetter Statamic packages. Provides a Control Panel overview of installed justbetter/* and just-better/* Composer packages.

Features

• JustBetter CP navigation section with a Packages overview
• Lists production and development JustBetter packages separately
• Shows installed version, latest stable Packagist version, and semver-aware update badges
• JustBetter nav and overview header use icon_url (and optional icon_dark_url) as SVG <image href="…"> markup (browser loads assets; no server-side fetch). Dark variant toggles with Tailwind dark: like the rest of the CP.
• Custom permission: view justbetter packages

Requirements

• PHP ^8.4
• Laravel ^12.40 or ^13.0
• Statamic ^6.0

Installation

composer require justbetter/statamic-base

Publish the config (optional):

php artisan vendor:publish --tag=justbetter-statamic-base

Build CP assets (required for the Inertia overview page):

cd vendor/justbetter/statamic-base
npm install
npm run build

During development:

npm run dev

Configuration

Config file: config/justbetter/statamic-base.php

Environment variables: STATAMIC_BASE_PACKAGIST_CACHE_TTL, STATAMIC_BASE_ICON_URL, STATAMIC_BASE_ICON_DARK_URL

Permissions

Assign the View JustBetter packages permission to roles that should access the overview. Super users always have access.

Quality

composer quality
composer coverage

License

MIT