Create Unstack

🚀 A modern Next.js application scaffolding tool with TailwindCSS, HeroUI, and configurable authentication & database options.

Create Unstack is a streamlined CLI tool that helps you bootstrap complete Next.js applications with a carefully selected tech stack, sensible defaults, and optional features to suit your project needs.

• 🌐 Next.js 15+ - The latest version of the React framework
• 🎨 TailwindCSS - Utility-first CSS framework with pre-configured design tokens
• 🧰 HeroUI - Modern component library for building beautiful UIs
• 🖌️ ShadCN - Pre-configured component library for TailwindCSS
• 🔒 Authentication - Optional Better-Auth integration for secure user management
• 🗄️ MongoDB - Optional MongoDB integration for data storage
• ⚡ Million.js - Optional React performance optimization
• 🔍 ESLint & Prettier - Pre-configured with sensible defaults
• 📦 TypeScript - Type-safe JavaScript with strict configuration
• 🚀 Fast Start - Get up and running in seconds, not hours

You can use Create Unstack without installing it by using npx:

npx create-unstack my-app

Or install it globally to use it anywhere:

npm install -g create-unstack
create-unstack my-app

Create Unstack was made because it took me more time than I wanted to setup a new NextJS project with everything I wanted. I always had to delete a lot of things I didn't want, and I always had to add a lot of things I did want. So I decided to make a CLI that would do it for me. The stack used is what I personally use for my projects. I hope you like it!

Simply run the CLI command and follow the interactive prompts:

npx create-unstack my-app

You can bypass the interactive prompts by using command line flags:

npx create-unstack my-app --db --auth --million

Available options:

• --db: Enable MongoDB integration
• --auth: Enable Better-Auth authentication
• --million: Enable Million.js optimization
• --yes: Use default options without prompts

The generated project follows a clean, modern structure:

my-app/
├── app/                 # Next.js App Router
│   ├── layout.tsx       # Root layout with providers
│   ├── page.tsx         # Home page
│   └── providers.tsx    # Client-side providers
├── components/          # Reusable UI components
│   └── ui/              # UI components
├── config/              # Configuration files
│   ├── fonts.ts         # Font definitions
│   └── site.ts          # Site metadata
├── lib/                 # Utility functions and services
│   ├── utils.ts         # Helper functions
│   └── db.ts            # MongoDB client (if enabled)
├── styles/              # Global styles
│   └── globals.css      # TailwindCSS imports and variables
├── .eslintrc.mjs        # ESLint configuration
├── .prettierrc          # Prettier configuration
├── .gitignore           # Git ignore rules
├── next.config.js       # Next.js configuration
├── package.json         # Dependencies and scripts
├── postcss.config.js    # PostCSS configuration
├── tailwind.config.js   # TailwindCSS configuration
└── tsconfig.json        # TypeScript configuration

The scaffolded application includes:

• Next.js 15+ with App Router and React Server Components
• TailwindCSS 3.4+ with design token variables
• HeroUI and ShadCN setup out of the box for beautiful UI components
• TypeScript with strict configuration
• ESLint & Prettier with comprehensive rule sets
• next-themes for dark/light mode
• Inter & Fira Code fonts from Google Fonts

When selected, these features are seamlessly integrated:

• MongoDB - Connection with development mode optimization
• Better-Auth - Authentication with MongoDB adapter
• Million.js - Performance optimization for React components

While there are many starter templates available, Create Unstack offers:

1. Fine-tuned Tech Selection - Carefully chosen libraries that work well together
2. Minimal Boilerplate - Just enough structure without overwhelming complexity
3. Optional Features - Add only what you need
4. Modern Practices - Latest patterns and best practices for Next.js development
5. Developer Experience - Beautiful CLI, sensible defaults, and clear structure

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the MIT License - see the LICENSE file for details.

• Next.js - The React Framework
• TailwindCSS - Utility-first CSS framework
• HeroUI - Beautiful UI components
• Better-Auth - Authentication library
• @clack/prompts - Beautiful CLI prompts

Made with ❤️ by The Untraceable