Developer
Developer Guide
Integration guides for building with Toast.
Everything you need to deploy Toast, integrate with its APIs, and extend it with custom drivers.
Self-Hosting
Deploy Toast with Railway, Docker, or manually.
Content API
Fetch published content and site metadata for your frontend.
Authentication
Auth flows, sessions, CORS, and role-based access control.
Driver Configuration
Configure email, storage, and queue providers.
Writing a Custom Driver
Build your own driver package for email, storage, or queues.
Architecture at a Glance
Toast is a monorepo with three deployable services:
| Service | Technology | Purpose |
|---|---|---|
| API | Hono + Node.js | REST API, auth, business logic |
| Admin | React 19 + Vite + nginx | Content management UI |
| Docs | Next.js + Fumadocs | Documentation site |
All three connect to a shared PostgreSQL database via Drizzle ORM. The API uses a layered architecture (routes, controllers, services, repositories) with multi-tenancy scoped by siteId.
For internal architecture details, see the Contributor Guide.