kinetis / skeleton

v1.2.2 2026-09-13 17:43 UTC

Requires

• php: ^8.4
• kinetis/framework: ^1.9.0

Requires (Dev)

• infection/infection: ^0.35.0
• phpstan/phpstan: ^2.2.8
• phpunit/phpunit: ^13.3.3
• vimeo/psalm: ^6.17

MIT

• Alon Noy

Published on Packagist.org on 2026-09-13 17:55 UTC

README

kinetis/skeleton
The smallest possible runnable Kinetis application

Part of Kinetis, a non-blocking PHP framework for API-first applications, developed in the kinetis-dev/kinetis monorepo.

One controller, one route, a welcome page — nginx + PHP-FPM, so a code change takes effect on your very next request with no container restart. Meant to be copied and grown from, not run as-is.

Running it

docker run --rm -v "$PWD":/app -w /app composer:2 \
    create-project --no-install kinetis/skeleton my-app
cd my-app
cp .env.example .env
docker compose up --build

Then open http://localhost:8080. Docker is the only thing you need — the containers install the dependencies and run the app, so no PHP or Composer has to exist on the host. (--no-install is what keeps it that way: it fetches the project without resolving dependencies, which docker compose up then does inside the container it will run them in.)

The project is yours from that point on. docker-compose.yml mounts it at /app and needs nothing outside it.

Using this as a starting point

Start editing what you just created. The whole app is src/Http/WelcomeController.php (one route) and public/index.php, which is the Composer autoloader plus one Kinetis\Runtime\HttpStartup::run() call — the framework owns the startup program itself. Add your own controllers anywhere under App\; Kinetis discovers them automatically.

Looking for a larger, more realistic example — a database, a queue, scheduled commands, real-time updates? See kinetis/pingpong.

Working on this package itself

This package is developed in the kinetis-dev/kinetis monorepo and published from it; kinetis-dev/skeleton is the split mirror the commands above install from. Inside the monorepo, composer.json still carries the path repository that resolves kinetis/framework from the sibling checkout, so the stack needs the override that mounts it:

docker compose -f docker-compose.yml -f docker-compose.monorepo.yml up --build

Container paths are /app either way — that override adds mounts and changes nothing else.

License

MIT — see LICENSE.