Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mit-27/god-tier-saas
A SaaS kit providing end-to-end type safety with ts-rest between Next.js and Nest.js, plus integrated services like AuthJS, PostHog, and Drizzle ORM with PostgreSQL.
https://github.com/mit-27/god-tier-saas
docker drizzle-orm nestjs nextjs postgresql posthog saas-boilerplate ts-rest typescript
Last synced: about 1 month ago
JSON representation
A SaaS kit providing end-to-end type safety with ts-rest between Next.js and Nest.js, plus integrated services like AuthJS, PostHog, and Drizzle ORM with PostgreSQL.
- Host: GitHub
- URL: https://github.com/mit-27/god-tier-saas
- Owner: mit-27
- License: mit
- Created: 2024-09-18T07:21:26.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-10-28T05:45:22.000Z (about 2 months ago)
- Last Synced: 2024-10-28T09:04:34.288Z (about 2 months ago)
- Topics: docker, drizzle-orm, nestjs, nextjs, postgresql, posthog, saas-boilerplate, ts-rest, typescript
- Language: TypeScript
- Homepage: https://www.godtiersaas.live/
- Size: 4.03 MB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 God Tier SaaS - Build the next Enterprise application
A SaaS Kit offering end-to-end type safety with ts-rest between Next.js and Nest.js, along with integrated services like AuthJS for authentication, PostHog for analytics, and Drizzle ORM with PostgreSQL for database management.
Perfect to build scalable SaaS applications.
## Key Features
- End-to-end Type safety with ts-rest
- Dashboard and Landing Page with NextJS
- Optimistic UI with TanStack Query
- Database management with Drizzle ORM
- Authentication ready with NextAuth.js
- Containerized development environment
- Monorepo structure for efficient code organization
- Analytics with PostHog
- Ready-to-use ContentLayer for blog and changelog
## Tech Stack
- NextJS - Frontend framework
- NestJS - Backend framewor
- ts-rest - End-to-end type safety
- Drizzle ORM - Database management
- NextAuth.js - Authentication
- Docker - Containerization
- PostHog - Analytics
- Content Collections - Blog and changelog
This stack ensures a robust, scalable, and maintainable application with strong typing throughout the entire codebase and secure authentication.
## Project Structure
- apps/web - The Next.js web application
- apps/server - The Nest.js API server
- packages/shared - The shared module which manages the database and ts-rest router for both the web and Server projects
## Setup and Running Instructions
### 1. 🐳 Using Docker
To set up and run the project using Docker Compose:
1. Ensure you have Docker and Docker Compose installed on your system.
2. Open a terminal and navigate to the project's root directory.
3. Copy the example environment files and add appropriate environment variables:
```bash
cp apps/web/.env.example apps/web/.env.local
cp .env.example .env
cp apps/server/.env.example apps/server/.env
cp packages/shared/.env.example packages/shared/.env
```
Edit `.env` files and add the necessary environment variables. Follow instructions in each file and modify the values according to your environment and the way you want to run the app.
4. Remove all node_modules
```bash
rm -rf node_modules .pnpm-store ./apps/web/node_modules ./apps/server/node_modules ./packages/shared/node_modules ./apps/server/dist pg_data
```
5. Run the following command:
```bash
docker-compose -f docker-compose.dev.yml up
```
This command will build and start all the necessary containers defined in the `docker-compose.dev.yml` file.
### 2. 📦 Using pnpm (Local Development)
To set up and run the project locally using pnpm:
1. Make sure you have Node.js (version 18 or higher) and pnpm installed on your system.
2. Open a terminal and navigate to the project's root directory.
3. Copy the example environment files and add appropriate environment variables:
```bash
cp apps/web/.env.example apps/web/.env.local
cp .env.example .env
cp apps/server/.env.example apps/server/.env
cp packages/shared/.env.example packages/shared/.env
```
Edit both `.env` files and add the necessary environment variables. Here docker-compose.postgres.yml used db credentials from .env file. So make sure the credentails that you used in apps.server/.env and packages.shared/.env are same as root .env file. Follow instructions in each file and modify the values according to your environment and the way you want to run the app.
4. Install the dependencies by running:
```bash
pnpm install
```
5. Build the shared module
```bash
pnpm run build:shared
```
6. Start the PostgreSQL database using Docker Compose:
```bash
docker-compose -f docker-compose.postgres.yml up -d
```
7. Start the development servers by running:
```bash
pnpm run dev
```
This command will concurrently start both the Next.js web application (on port 8090) and the NestJS API server with shared module which manages db and ts-rest router. It uses Turbo to manage the monorepo workspace and run the development scripts for both the web and API projects simultaneously.
Make sure your environment variables are properly configured to connect to the PostgreSQL database started by Docker Compose.
## Support
Support me by giving a star ⭐ on this repository.
## License
This project is licensed under the MIT License.