FastForward
A ready-to-go Node.js boilerplate with Preact, Hapi.js, Postgres, and a built-in dual-mode auth system. Styled with Tailwind CSS v4 and containerized with Docker.
What’s Included
- Frontend — Vite + Preact with Tailwind CSS v4 (Vite plugin). Includes client-side routing, auth context, and example pages.
- Backend — Hapi.js server with Joi validation, JWT cookie auth, and a clean route structure.
- Auth — Password-based and email-code-based authentication, independently toggleable. Secure by default (bcrypt, httpOnly cookies, SameSite).
- Database — PostgreSQL with a simple SQL migration runner.
- Docker — Multi-stage Dockerfile and Compose config. Works standalone or behind a reverse proxy.
Pages
| Page | Description |
|---|---|
| Getting Started | Install, configure, and run the app |
| Architecture | Project structure and how the pieces fit together |
| API Reference | Every backend endpoint, with request/response examples |
| Authentication | How the auth system works, how to configure or extend it |
| Configuration | All environment variables and what they control |
| Database | Schema, migrations, and how to add new tables |
| Frontend | Preact components, routing, auth hook, and styling |
| Deployment | Docker, Docker Compose, and reverse proxy setup |