naf / app

v0.2.2 2026-09-14 04:51 UTC

Requires

• php: >=8.3
• naf/form: ^0.2.1
• naf/framework: ^0.2.2
• naf/view: ^0.2

Conflicts

• nyholm/psr7: <1.8.2

MIT

• Flo Knapp

Published on Packagist.org on 2026-09-14 04:53 UTC

README

A clean starting point for building applications with NAF — the minimal and flexible PHP microframework.

"As simple as possible, as flexible as necessary."

composer create-project naf/app my-app
cd my-app
APP_ENV=dev php -S 127.0.0.1:8080 -t public

Alternatively, clone the repo manually:

git clone https://github.com/nafphp/app my-app
cd my-app
composer install

Make sure your webserver points to the /public directory as document root.

Documentation

Your first application →

Everything about this package — what it does, how it is configured and what it needs — lives in the NAF documentation. Not sure which packages you need? Start here.

Working on the starter

Read AGENTS.md for the starter layout, supported dependency versions, extension examples and HTTP verification. Create a new project with the command above; naf/app is an application skeleton, not a library to require inside another application.

Run composer validate --strict and composer test after installing dependencies. The HTTP smoke test requires Python 3.9+ and checks the actual starter through PHP's development server. CI tests locked, latest compatible and minimum supported dependencies on PHP 8.3 and 8.5.

License

MIT. Part of NAF.