✨ Maia

Maia is an opinionated, API-first PHP framework distributed as a single Composer package: maia/framework.

It includes:

• App kernel, dependency injection, routing, middleware, exceptions, logging, and HTTP testing helpers
• SQLite-friendly ORM primitives including query building, models, relationships, schema building, and migrations
• Auth and security helpers for JWT, API keys, CORS, rate limiting, validation, and security headers
• A CLI for scaffolding, migration management, and route/app inspection

👉 See docs/EXAMPLES.md for full usage patterns — bootstrap, controllers, models, validation, relationships, testing, and more.

For framework development and contribution workflows, see CONTRIBUTING.md.

Recent additions include query-builder upsert(), join() / leftJoin(), groupBy() / having(), SQLite pragma helpers via Connection::sqlite(), and generic response caching middleware in maia/core.

📋 Requirements

• PHP ^8.2
• Composer

🚀 Install Maia

To add Maia to an existing application:

composer require maia/framework:^0.1

Start a new app from scratch

This flow gets you from an empty directory to a running API with database-backed routes.

1. Install the Maia CLI

composer global require maia/framework:^0.1

2. Scaffold a project

Creates a new Maia app skeleton with standard directories (app/, config/, routes/, database/, public/) and framework wiring.

maia new my-app

3. Set up local environment

cd my-app
cp .env.example .env
touch database/database.sqlite

4. Scaffold your first controller

vendor/bin/maia create:controller UserController

5. Register controllers and wire bootstrap

Controllers are registered explicitly at boot time — this keeps startup behavior predictable. Full wiring examples are in docs/EXAMPLES.md.

6. Migrate and run

vendor/bin/maia migrate
vendor/bin/maia up --port 8000

🎉 That's it!

🔧 CLI

php bin/maia --help

Command	Description
new	Scaffold a new Maia application
up	Start the local PHP dev server
create:controller	Generate a controller class
create:service	Generate a service class
create:model	Generate a model class
create:middleware	Generate a middleware class
create:request	Generate a form request class
create:migration	Generate a migration file
create:test	Generate a test class
migrate	Run pending migrations
migrate:rollback	Roll back the last migration batch
migrate:status	Show migration status
routes	List registered routes
describe	Inspect a command's details

All commands support --json for machine-readable output where relevant.

📜 License

Maia is licensed under the GNU GPL v3 or later. See LICENSE.