118 lines
4.7 KiB
Markdown
118 lines
4.7 KiB
Markdown
# ⭐ Production SaaS Starter Kit
|
|
|
|
The Enterprise-Grade SaaS boilerplate for serious founders. Built with **Next.js 16** and **Go 1.25**.
|
|
|
|
[](https://goreportcard.com/report/github.com/moasq/production-saas-starter)
|
|
[](https://opensource.org/licenses/MIT)
|
|
|
|
|
|
|
|
## 🛠️ Built With
|
|
|
|
### Frontend Stack
|
|
|
|
- **[Next.js 16](https://nextjs.org)** (v16.0.10)
|
|
Modern React framework with App Router and API routes.
|
|
- **[React 19](https://react.dev)** (v19.2.3)
|
|
Latest React with improved performance and concurrent features.
|
|
- **[TypeScript](https://www.typescriptlang.org)** (v5.7.3)
|
|
Type-safe JavaScript for enhanced developer experience.
|
|
- **[Tailwind CSS](https://tailwindcss.com)** (v3.4.17)
|
|
Utility-first CSS framework for rapid UI development.
|
|
- **[shadcn/ui](https://ui.shadcn.com)** + **Radix UI**
|
|
Accessible component library with 29+ pre-built components.
|
|
- **[TanStack Query](https://tanstack.com/query)** (v5.90.5)
|
|
Powerful data fetching and state management.
|
|
- **[Zustand](https://zustand-demo.pmnd.rs)** (v5.0.8)
|
|
Lightweight state management for UI state.
|
|
- **[react-hook-form](https://react-hook-form.com)** + **[Zod](https://zod.dev)**
|
|
Type-safe forms with schema validation.
|
|
- **[Stytch](https://stytch.com)**
|
|
Enterprise authentication with magic links, OAuth, and SSO.
|
|
- **[Polar.sh](https://polar.sh)**
|
|
Billing integration and subscription management.
|
|
- **[Recharts](https://recharts.org)**
|
|
Composable charting library for data visualization.
|
|
|
|
### Backend Stack
|
|
|
|
- **[Go 1.25](https://go.dev)**
|
|
High-performance, concurrent backend with excellent tooling.
|
|
- **[Gin](https://gin-gonic.com)**
|
|
Fast HTTP web framework with middleware support.
|
|
- **[PostgreSQL](https://www.postgresql.org)** with **[pgvector](https://github.com/pgvector/pgvector)**
|
|
Reliable relational database with vector similarity search.
|
|
- **[SQLC](https://sqlc.dev)**
|
|
Type-safe SQL compiler for Go (no ORM).
|
|
- **[Stytch B2B](https://stytch.com)**
|
|
Enterprise authentication, SSO, and RBAC.
|
|
- **[Polar.sh](https://polar.sh)**
|
|
Merchant of Record for subscriptions, invoicing, and global tax compliance.
|
|
- **[OpenAI API](https://openai.com)**
|
|
LLM integration with RAG pipeline and vector embeddings.
|
|
- **[Mistral AI](https://mistral.ai)**
|
|
OCR service for document data extraction.
|
|
- **[Cloudflare R2](https://www.cloudflare.com/products/r2/)**
|
|
Object storage for file management.
|
|
- **[Docker](https://www.docker.com)** + **Docker Compose**
|
|
Containerization for consistent environments.
|
|
|
|
## 🥇 Features
|
|
|
|
- **Authentication**: Sign in with Magic Link, Google OAuth, and Enterprise SSO.
|
|
- **Multi-Tenancy**: Built-in Organization support with strict data isolation.
|
|
- **Roles & Permissions**: Granular RBAC system with 3 roles (Member, Manager, Admin) and 7 permission types.
|
|
- **Billing & Subscriptions**: Complete integration with Polar.sh for SaaS pricing models.
|
|
- **AI & RAG**: Ready-to-use vector embeddings pipeline for AI features.
|
|
- **OCR Service**: Extract structured data from valid documents instantly.
|
|
- **Team Management**: Invite members, manage roles, and update settings.
|
|
- **Responsive Design**: Mobile-first UI built with Tailwind CSS and shadcn/ui.
|
|
- **Type Safety**: End-to-end type safety from database (SQLC) to frontend (TypeScript).
|
|
|
|
## ➡️ Coming Soon
|
|
|
|
- **Audit Logs**: Complete audit logging system for tracking user activities.
|
|
- **Webhooks UI**: Customer-facing webhook configuration.
|
|
- **Advanced Analytics**: Built-in charts and usage tracking.
|
|
|
|
## ✨ Getting Started
|
|
|
|
Please follow these simple steps to get a local copy up and running.
|
|
|
|
### Prerequisites
|
|
|
|
- **Docker** & **Docker Compose**
|
|
- **Go 1.25+**
|
|
- **Node.js 20+** & **pnpm**
|
|
|
|
### The One-Line Setup
|
|
|
|
Run this command to configure your keys and start the infrastructure:
|
|
|
|
```bash
|
|
chmod +x setup.sh && ./setup.sh
|
|
```
|
|
|
|
**Manual Start:**
|
|
|
|
1. **Backend:** `cd go-b2b-starter && make dev`
|
|
2. **Frontend:** `cd next_b2b_starter && pnpm dev`
|
|
3. **Visit:** [http://localhost:3000](http://localhost:3000)
|
|
|
|
> [!IMPORTANT]
|
|
> See **[SETUP.md](./SETUP.md)** for full details.
|
|
|
|
## 🛡️ License
|
|
|
|
[MIT License](./LICENSE)
|
|
|
|
## 👯 Consulting & Services
|
|
|
|
Although this kit is self-service, I help ambitious founders move faster.
|
|
|
|
**I can help you with:**
|
|
1. **Managed Config:** I sets up your AWS/GCP production environment so you never touch DevOps.
|
|
2. **Custom Features:** Need SAML SSO or complex RAG flows? I'll build them directly into your repo.
|
|
3. **Code Audits:** Migrating from Node/Python? I'll review your architecture for scale.
|
|
|
|
**[m.salim@apflowhq.com](mailto:m.salim@apflowhq.com)** • [**@foundmod**](https://x.com/foundmod)
|