Argon Skeleton

Minimal application skeleton for the Argon runtime stack.

This repository is intended for composer create-project. It is deliberately not named argon-framework: the framework-level runtime lives in the maduser/argon-* packages, while this project is the starting application layout.

Create Project

composer create-project maduser/argon-skeleton my-app

Local Usage

cp .env.example .env
composer install
composer serve
composer console
composer test
composer check

Quality Gates

composer validate --strict
composer check
composer test:coverage
composer psalm
composer phpcs

Shape

• bootstrap/app.php builds the runtime-specific container bootstrap.
• foundation/Providers/HttpFoundationServiceProvider.php wires HTTP packages and default middleware.
• foundation/Providers/ConsoleFoundationServiceProvider.php wires Symfony Console through Argon.
• foundation/Providers/ErrorHandlingServiceProvider.php wires application exception handling.
• foundation/Providers/RoutingServiceProvider.php loads routes/web.php.
• config/providers.php is the explicit list for application service providers.
• src/ is intentionally empty for application code.
• tests/ApplicationTestCase.php boots the real application container for integration tests.
• tests/Feature/ contains HTTP, console, and container-context integration examples.
• tests/Unit/ is available for isolated tests when that is the better fit.

Optional integrations such as Monolog, Twig, Eloquent, Doctrine, or Workflow should live in explicit integration packages or application providers. The skeleton does not install them implicitly.