Documentation

Nudgd is a powerful SaaS boilerplate generator that creates production-ready full-stack applications in minutes.

Instead of starting from scratch, you configure your project requirements (database, authentication, payments, etc.) and Nudgd generates a complete backend and frontend with all best practices baked in.

Nudgd runs as a generator service - just visit the generator:

The generator runs on the backend and creates projects instantly.

1. Fill out the form with your project details:
   • Project name (e.g., "my-saas")
   • Description
   • Select features (database, auth, payments, etc.)
2. Choose your database: PostgreSQL or MongoDB
3. Select optional features: Stripe, Resend email, OpenAI integration, AWS S3 storage, etc.
4. Click "Generate Project" and wait for the magic ✨
5. Download the ZIP file with your complete project

Nudgd always generates a production-ready frontend—no toggle needed.

• Next.js 14 (App Router) with Tailwind UI components
• Signup, signin, and protected dashboard shell wired to your chosen auth
• Marketing landing page and docs page to explain your product
• API hooks and layouts aligned to the backend/services you select

Nudgd includes JWT-based authentication out of the box:

Easily add payment processing to your SaaS:

Send transactional emails with integrated services:

Add AI capabilities with pre-configured integrations:

Handle file uploads with built-in storage options:

Your generated project includes both backend and frontend:

my-saas/
├── server/
│   ├── src/
│   │   ├── index.ts          # Entry point
│   │   ├── app.ts            # Express app setup
│   │   ├── db.ts             # Database connection
│   │   ├── authController.ts # Auth logic
│   │   ├── middleware/       # Custom middleware
│   │   └── routes/           # API routes
│   ├── prisma/
│   │   └── schema.prisma     # Database schema
│   └── package.json
│
├── web/
│   ├── src/
│   │   ├── app/              # Next.js pages
│   │   ├── components/       # React components
│   │   ├── context/          # Auth context
│   │   └── hooks/            # Custom hooks
│   ├── package.json
│   └── next.config.js
│
├── docker-compose.yml        # Local database setup
└── SETUP.md                  # Setup instructions

1. Extract the ZIP file to your desired location
2. Install dependencies:

   cd server && npm install
   cd ../web && npm install

3. Start Docker for the database:

   cd server && docker compose up -d

4. Run database migrations (PostgreSQL):

   npm run prisma:migrate

5. Start the backend and frontend:

   # Terminal 1 - Backend
   cd server && npm run dev
   
   # Terminal 2 - Frontend
   cd web && npm run dev

• Backend: http://localhost:5000
• Frontend: http://localhost:3000

Create .env files in both server/ and web/ directories.

PORT=5000
NODE_ENV=development
CORS_ORIGIN=http://localhost:3000

# Database
DATABASE_URL=postgresql://admin:password123@localhost:5432/my-saas
# or
MONGO_URI=mongodb://admin:password123@localhost:27017/my-saas?authSource=admin

# Authentication
JWT_SECRET=your-super-secret-key-min-32-chars
BCRYPT_ROUNDS=12

# Optional - Payment
STRIPE_SECRET_KEY=sk_test_...

# Optional - Email
RESEND_API_KEY=re_...

# Optional - AI
OPENAI_API_KEY=sk-...

# Optional - Storage
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...
AWS_S3_BUCKET=...

NEXT_PUBLIC_API_URL=http://localhost:5000
NEXT_PUBLIC_APP_URL=http://localhost:3000

Deploy your application using Docker:

# Build backend image
cd server
docker build -t my-saas-backend .

# Build frontend image
cd ../web
docker build -t my-saas-frontend .

# Run with docker-compose for production
docker-compose -f docker-compose.prod.yml up

Update these values when deploying to production:

# Backend
NODE_ENV=production
PORT=8080
CORS_ORIGIN=https://yourdomain.com

# Use strong secrets - Generate with: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
JWT_SECRET=<very-long-random-string>
BCRYPT_ROUNDS=12

# Use managed database service
DATABASE_URL=postgresql://user:pass@production-db.example.com/dbname
# or
MONGO_URI=mongodb+srv://user:pass@cluster.mongodb.net/dbname

# Frontend
NEXT_PUBLIC_API_URL=https://api.yourdomain.com
NEXT_PUBLIC_APP_URL=https://yourdomain.com

The generated code is yours to customize. Feel free to modify, extend, and improve it for your use case.