PHPackages sunchayn/aion - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. sunchayn/aion ActiveProject[Framework](/categories/framework) sunchayn/aion ============= The initial composer file to start a new project via Aion Starter Kit. This file will be re-populated based on the starter kit variant. v1.0.3(2mo ago)2949↓90%MITPHPPHP ^8.4CI passing Since Mar 23Pushed 2mo agoCompare [ Source](https://github.com/sunchayn/aion)[ Packagist](https://packagist.org/packages/sunchayn/aion)[ RSS](/packages/sunchayn-aion/feed)WikiDiscussions base Synced 2w ago READMEChangelog (4)Dependencies (15)Versions (8)Used By (0) Aion ==== [](#aion) [![aion-gh-cover.png](https://raw.githubusercontent.com/sunchayn/aion/refs/heads/base/.aion/art/aion-gh-cover.png)](https://raw.githubusercontent.com/sunchayn/aion/refs/heads/base/.aion/art/aion-gh-cover.png) [![Latest Version on Packagist](https://camo.githubusercontent.com/87bf628bafba3b079e416b3df9ee3b88bdc2d56e20432f73ffb20e17a50fbc0b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73756e636861796e2f61696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sunchayn/aion)[![License](https://camo.githubusercontent.com/7d3d73bbc471b99afa5606cb80e75617772bca7d2157aa161a2c55b162629937/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f73756e636861796e2f61696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sunchayn/aion)[![PHP Version](https://camo.githubusercontent.com/2afd2360c7d99a600153fb4e3755d46b500038408e4fd6d271244fa6c5f4e43d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f73756e636861796e2f61696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sunchayn/aion) **A modular customizable Laravel starter kit** Aion is an agentic-ai ready, modular Laravel 13 starter kit that is customizable to your applications' requirements. It provides a modular and clutter-free foundation for both stateful and stateless applications, optimized for quick-starting your next project with full code ownership. [![](https://raw.githubusercontent.com/sunchayn/aion/refs/heads/base/.aion/art/aion-cover.png)](https://raw.githubusercontent.com/sunchayn/aion/refs/heads/base/.aion/art/aion-cover.png) Why Aion? --------- [](#why-aion) Aion is designed for developers who want full control over their application's foundation without the technical debt typically associated with complex starter kits or heavy packages. - **Full Code Ownership**: Unlike other options that provide capabilities like authentication or strict configuration via vendor packages, Aion places them directly in your codebase. You own every line, making customization and debugging straightforward. - **Architectural Modularity**: By utilizing single-responsibility Actions, your business logic is decoupled from transport layers. This allows you to reuse the same domain logic across different application types, whether it's a REST API, an Inertia-powered frontend, or a CLI tool. - **Clutter-free**: A minimalist repository structure where unnecessary folders (e.g., `resources`) are omitted when not required. Routes are isolated within Application directories in `app/Http`, and tool configurations are centralized in the `tools/` folder. - **Customizable**: The configuration wizard allows you to pick the application type, support FE or not and perform granular cleanups, such as selecting only required database and log channel, ensuring you start with a lean and clutter-free repository. ### Kit Technical Details [](#kit-technical-details) - **Modular (Pseudo-DDD)**: Business logic is decoupled into domain modules (`app/Modules`) and transport layers (a.k.a. Applications) living in `app/Http`. - **Agentic-AI Ready**: Aion provides specialized AI guidelines and skills that build upon Laravel Boost. These are native to the codebase, enabling AI assistants to understand and follow your local architectural patterns with precision. - **Flexible Stacks**: Supports Headless (API-only), or bare-minimum frontend implementations using Vue or Blade (no UI is provided as of now, only the infrastructure). - **Strict Defaults**: Enforces strict Laravel standards (CarbonImmutable dates, strict models, and auto-eager loading). - **ECS Logs Provided**: Supports using Elastic Common Schema (ECS) standardized logs across the board. ### Available Features [](#available-features) Feature-wise, the authentication flow is shipped with the kit by default. - Registration/login (stateless and stateful) \[configurable/opt-in\] - Password Reset - Email verification - Token refresh (for stateless auth) \[configurable/opt-in\] - Two-Factor Auth - Oauth \[configurable/opt-in\] - Magic Links Directory Structure ------------------- [](#directory-structure) - `.ai`: Developer guidelines and skill definitions for AI agents. - `.aion`: Engine configuration (Features, Stacks, and Pruning Operations). This directory is deleted once the kit is initialized. - `app/Http`: Transport Layers (REST API vs. Web/Session) consuming module logic. - `app/Modules`: Domain logic (Auth, User, Shared) containing Actions, DTOs, and Contracts. - `tools`: Tools configurations like phpstan. Getting Started --------------- [](#getting-started) ### Installation [](#installation) You can create a new project using `composer create-project`: ``` composer create-project sunchayn/aion ``` Alternatively, clone the repository and run: ``` composer install ``` ### Configuration Wizard [](#configuration-wizard) Initialize the codebase interactively using the Spark engine: The wizard will pop-up once a new project is initialized it will help configure your application and dependency installation based on your selected stack. *Note: the command will cleanup after itself once done.* #### Stacks & Features [](#stacks--features) CategoryOptionDescription**Architecture****Stack Choice**Toggle between a **Bare API** (headless) or **API + Frontend**.**Authentication****API Type**Choose between **Stateless** (JWT-based) or **Stateful** (Session/Cookie) security.**Social OAuth**Enable OAuth authentication and select providers (Google, GitHub, Apple).**Infrastructure****Databases**Select needed connections.**Logging**Select needed logging channels.**ECS**Choose **ECS** (Elastic Common Schema) format or default logging formats.**Code Quality****PHPStan**Define the static analysis strictness level (5 to 10).Development Commands -------------------- [](#development-commands) CommandResult`composer test:coverage`Runs the tests in parallel with coverage (html format).`composer test:coverage-ci`Runs the tests in parallel with coverage optimized for CI (clover format).`composer style:fix`Applies Laravel Pint code style rules.`composer phpstan`Performs static analysis on the core modules.`composer rector`Executes automated refactoring and modernization.--- License ------- [](#license) Aion is open-source software licensed under the [MIT license](LICENSE.md). ### Health Score 44 — FairBetter than 91% of packages Maintenance84 Actively maintained with recent releases Popularity19 Limited adoption so far Community6 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Total 4 Last Release 83d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/14861869?v=4)[Mazen Touati](/maintainers/sunchayn)[@sunchayn](https://github.com/sunchayn) --- Top Contributors [![sunchayn](https://avatars.githubusercontent.com/u/14861869?v=4)](https://github.com/sunchayn "sunchayn (5 commits)") --- Tags agentic-ailaravellaravel-starter-kitlaravel-starter-templatemodularstarter-kitstarter-kitlaravel-starter-kitmodular-laravelagentic-aiaion ### Code Quality Static AnalysisRector Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/sunchayn-aion/health.svg) ``` [![Health](https://phpackages.com/badges/sunchayn-aion/health.svg)](https://phpackages.com/packages/sunchayn-aion) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.8k532.1M19.4k](/packages/laravel-framework)[laravel/octane Supercharge your Laravel application's performance. 4.0k24.7M203](/packages/laravel-octane)[shopware/platform The Shopware e-commerce core 3.4k1.5M3](/packages/shopware-platform)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 585.4M514](/packages/shopware-core)[illuminate/console The Illuminate Console package. 13045.3M6.2k](/packages/illuminate-console)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.4M196](/packages/sulu-sulu) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)