brightery / app
Application skeleton for Brightery Framework.
Requires
- php: ^8.4
- brightery/framework: ^1.0
README
A Composer-ready application skeleton for Brightery Framework stable 1.x.
Create a project
composer create-project brightery/app my-project "^1.0" cd my-project php vendor/bin/brightery app:install php vendor/bin/brightery doctor php vendor/bin/brightery serve
Production build
php vendor/bin/brightery optimize php vendor/bin/brightery schema:plan database/schema php vendor/bin/brightery runtime:soak --iterations=5000 --json php vendor/bin/brightery audit:verify php vendor/bin/brightery release:check --production --json
Expose only public/ through the web server. Do not deploy composer.local.json; the release builder excludes it automatically.
Stable upgrade diagnostics
php vendor/bin/brightery upgrade:plan --json
php vendor/bin/brightery upgrade:scan . storage/upgrade/report.json
php vendor/bin/brightery api:check previous-api-surface.json
Integration fixtures
docker compose -f docker-compose.integration.yml up -d php vendor/bin/brightery integration:doctor BRIGHTERY_INTEGRATION=1 php vendor/bin/brightery integration:test
The environment includes MySQL, Redis, MinIO, Mailpit, OTLP Collector, MockServer, and an optional gateway profile.
Persistent workers
bootstrap/worker.php, bootstrap/roadrunner.php, and bootstrap/frankenphp.php provide bounded request-scope lifecycle boundaries. Run live transport tests and a workload-specific soak test before enabling persistent workers in production.
Modules and realtime
Signed modules require trusted public keys, verified file manifests, compatible framework constraints, and valid dependency graphs. Presence/private channels require application-issued signatures and Redis-backed presence when gateways are scaled horizontally.