Pionia Framework

Build a real JSON API in an afternoon — PHP 8.5+, Moonlight, and optional Vite frontend.

composer create-project pionia/pionia-app pionia-shop
cd pionia-shop && php pionia serve

Requires PHP 8.5+ and pionia/pionia-core ^3.0. Every guide uses Pionia Shop — a fictional online store + wallet — so examples stay consistent from first ping to deploy. New to PHP? See PHP basics.

Start building Pionia Shop

One example store API from install to deploy — pick where to begin.

Tutorial Build your shop API 15 steps from composer create-project to providers and core.

Release notes What's new in v3 AppRealm, native HTTP stack, RoadRunner, and Moonlight updates.

Overview Why Pionia? When the Moonlight model fits — and how it compares to REST routing.

Documentation

Browse by topic — same structure as the docs sidebar.

Getting Started Install, PHP basics, tutorial, app structure

Building your API Moonlight, services, actions, validation

Database (Porm) Queries, filters, joins, pagination

HTTP & middleware Envelopes, middleware, exceptions

Security Authentication, JWT, security utilities

Frontend Vite SPA, dev proxy, production build

Operations & deploy RoadRunner, optimize, logging, CLI

Extending & reference Providers, packages, helpers

Open source — contributions welcome via GitHub and the OSCA-Kampala Chapter.