This project provides a full-stack SaaS boilerplate designed for rapid development of web applications, prioritizing developer experience, efficiency, and end-to-end type safety. It targets developers looking to build modern, performant applications with a clear separation between frontend and backend concerns, leveraging a curated selection of top-tier JavaScript and TypeScript technologies.

How It Works

The boilerplate employs a modern stack centered around Fastify for the Node.js backend, tRPC for type-safe API communication, and React 19 for the frontend. Data persistence is handled via Drizzle ORM with a PostgreSQL database. Frontend tooling is managed by Vite, and UI development is accelerated with Tailwind CSS v4. A key architectural choice is serving the React frontend as static files, facilitating deployment to cloud object storage like AWS S3, distinguishing it from traditional SEO-focused website frameworks.

Quick Start & Requirements

• Installation: Requires pnpm (install globally via npm install -g pnpm). Install project dependencies with pnpm install.
• Prerequisites: Node.js, pnpm, PostgreSQL (a database named fsb is required).
• Setup: Configure environment variables by renaming example.env to .env for both server and client. Set up the database schema with pnpm run push and populate it with pnpm run seed.
• Run: Start the development server (client and server) using pnpm run dev. For production, build with pnpm run build and start with pnpm run start.
• Links: Project demo hosted on render.com (note: free tier may cause spin-down delays).

Highlighted Details

• Achieves end-to-end type safety across the stack using tRPC.
• Frontend is built as static files, simplifying deployment to services like AWS S3.
• Includes features such as server health checks, debounced search functionality, and chat via Server-Sent Events (SSE).
• Features E2E testing capabilities using Playwright.

Maintenance & Community

The project is open-source and welcomes contributions via pull requests and feedback. The author seeks stars and sponsorships to support development. No specific community channels (e.g., Discord, Slack) or roadmap links are provided in the README. Nachonacho.com is listed as a user.

Licensing & Compatibility

The provided README does not explicitly state the project's license. This omission requires clarification regarding usage rights, particularly for commercial applications or integration into closed-source projects.

Limitations & Caveats

The architecture, prioritizing web application development, results in a frontend that is not SEO-friendly. The demo deployment on a free tier is subject to inactivity spin-downs, potentially introducing significant request delays.