The intent of Puff Serverless is to allow the deployment of hyper-scalable solution for centralized single sign-on, access control, and unified billing for multiple organisations across multiple applications.
We run JavaScript on Cloudflare Workers with Node compatibility, using Pages Functions directory routing for endpoints and Workers Static Assets for HTML/CSS/client-side JS. APIs return full HTML via HTMX to update in-page. Data is stored within Postgres-like CockroachDB accessed via Cloudflare Hyperdrive.
Further reading in docs/:
- Architecture.md — codebase shape, request layering, libraries, OAuth endpoints, environment variables.
- Hierarchy.md — the data model: Apps, Organisations, Teams, Roles, Users.
- Development.md — local-machine setup, tests, linting.
- Deployment.md — shipping to production with copy-paste commands.
- Operations.md — running it: cron, audit log, OAuth key rotation, registering apps and providers.
