README

A full-stack Handlr app skeleton - the starting point for a server-driven web app built on HTMX + Handlebars + Tailwind on the front end and a PHP Pipe + Handler framework on the back end.

Scaffold a new project with one command:

composer create-project phillipsharring/handlr-app my-app

A post-create-project-cmd runs npm install in the frontend half, so a single command sets up both sides. Then:

cd my-app
composer run dev      # PHP server on http://localhost:8000
npm run dev           # Vite dev server on http://localhost:5173 (proxies /api to :8000)

What's inside

This package ships both halves of an app:

frontend/    Vite + Tailwind + HTMX runtime (built on @phillipsharring/handlr-frontend
             and @phillipsharring/handlr-build)
backend/     PHP API built on phillipsharring/handlr-backend  - auth, RBAC, CSRF,
             migrations, seeders, and the Pipe + Handler conventions

• frontend/ — pages, layouts, components, and the runtime wiring.
• backend/ — handlers, pipes, data layer, and database lifecycle.

The pieces it builds on

Adding a module

A module is a single dual-published unit (npm + composer, lockstep version). Install both halves at the matching version:

composer run module:install -- <name>

License

MIT