create-fullstack-kit

A production-ready CLI tool to generate full-stack monorepo starter kits in under 5 minutes.

⚠️ IMPORTANT: pnpm Required

This CLI officially supports pnpm ONLY.

❌ npm is NOT supported (will cause workspace:* errors)
❌ yarn is NOT supported
✅ pnpm is REQUIRED

Why pnpm only?

This monorepo uses workspace:* dependencies and pnpm-specific features. Using npm or yarn will break the build.

🚀 Quick Start

1. Install pnpm (if not already installed):

npm install -g pnpm

2. Create your project:

pnpm create fullstack-kit myapp

Or use interactive mode:

pnpm create fullstack-kit

✨ Features

• Next.js frontend with App Router, Tailwind CSS, and shadcn/ui
• NestJS or Express backend with TypeScript
• OAuth 2.0 authentication (Google, GitHub)
• Prisma ORM for database management
• Turborepo monorepo setup
• Shared packages for UI components and auth logic
• Production-ready configuration out of the box

📦 Generated Structure

myapp/
├── apps/
│   ├── web/               # Next.js App Router + Tailwind + shadcn/ui
│   └── api/               # NestJS OR Express backend
├── packages/
│   ├── ui/                # Shared shadcn components
│   ├── auth/              # Shared OAuth + JWT logic
│   ├── eslint-config/
│   └── tsconfig/
├── .env.example
├── package.json
├── turbo.json
├── pnpm-workspace.yaml
└── README.md

🛠️ Options

• --frontend <type> - Frontend framework (default: next)
• --ui <type> - UI library (default: shadcn)
• --backend <type> - Backend framework (nest | express, default: nest)
• --auth <type> - Authentication (default: oauth)
• --db <type> - Database ORM (default: prisma)

📝 Requirements

• Node.js >= 18.0.0
• pnpm (REQUIRED) - Install with: npm install -g pnpm

🔧 Troubleshooting

❌ Error: "Unsupported URL Type 'workspace:*'"

Cause: You're using npm or npx instead of pnpm.

Fix:

npm install -g pnpm
pnpm create fullstack-kit

❌ Prisma Error: "datasource property url is no longer supported"

Cause: Prisma v7 breaking change.

Fix: This CLI uses Prisma v6.19.0 to avoid this issue. If you upgrade Prisma manually, stay on v6.x.

ℹ️ Database not configured

If you see this message, it's normal. The app works with JWT sessions (no database). Add DATABASE_URL to .env when you're ready to use a database.

⚠️ OAuth provider not configured

If you see this message, it's normal. OAuth will work in demo mode. Add GOOGLE_CLIENT_ID/GITHUB_CLIENT_ID to .env to enable real OAuth.

🔧 Development

# Install dependencies
pnpm install

# Build
pnpm build

# Run in development
pnpm dev

🤝 Contributing & Community

You're warmly welcome to contribute to create-fullstack-kit!

If you'd like to improve the tool, fix bugs, or add new features, feel free to open a Pull Request on GitHub:

🔗 https://github.com/cadmostafijur/create-fullstack-kit-CLI

If you discover any issues or have suggestions, you can open an issue, submit a PR directly, or reach out for discussion. Contributions of all sizes—code, documentation, or ideas—are highly appreciated.

Let's build a better full-stack developer experience together! 🚀

📄 License

MIT