🚀 create-express-saas

A zero-config CLI to scaffold a production-ready Node.js + Express + Mongoose SaaS boilerplate in seconds.
Includes JWT authentication, role-based access control, centralized error handling, Swagger API docs, and more — so you can focus on building features, not boilerplate.

✨ Features

• ⚡ Zero config – run one command and start coding
• 🔑 JWT Auth with refresh tokens
• 👥 Role-based Access Control (RBAC)
• ❌ Centralized Error Handling
• 📖 Swagger (OpenAPI) Docs out of the box
• 📦 Mongoose Models with best practices
• 🌍 CORS, Helmet, dotenv pre-configured
• 🧪 Ready-to-use Project Structure
• 🐳 Optional Dockerfile support (future-ready)

🚀 Quick Start

# Create a new project
npx create-express-saas my-project

cd my-project
npm install
npm run dev

👉 API Docs available at: http://localhost:5000/api-docs

Project Structure

my-project/
│── src/
│   ├── config/        # Env & DB config
│   ├── controllers/   # Route handlers
│   ├── middlewares/   # Auth & error middlewares
│   ├── models/        # Mongoose models
│   ├── routes/        # Express routes
│   ├── utils/         # Helpers
│   └── app.js         # App entry point
│── .env.example       # Sample environment file
│── package.json

🛠️ Local Development

# Clone locally for testing
git clone https://github.com/khushikumarigupta14/create-express-saas.git
cd create-express-saas

# Install & link
npm install
npm link

# Scaffold a new project
create-express-saas ../myProject

# Install deps and run
cd ../myProject
npm install
npm run dev

📚 Documentation

• Express.js
• Mongoose
• Swagger

🤝 Contributing

• Contributions are welcome!
• Fork this repo
• Create a new branch (feature/my-feature)
• Commit your changes
• Open a Pull Request 🎉

⭐ Support & Community

• Star the repo on GitHub 🌟
• Share it with other developers
• Open issues / feature requests
• 🐛 Report bugs / request features

📄 License

MIT © 2025 Khushi Kumari Gupta