create-nextforge

🚀 NEXTFORGE Architecture - Forge your next-gen app with speed and power. The ultimate full-stack foundation for modern e-commerce and SaaS applications

⚠️ Important: Use npx create-nextforge@latest to create a new project, NOT npm i create-nextforge

What is NEXTFORGE?

NEXTFORGE is a battle-tested, production-ready architecture that combines the best modern technologies to create a powerful foundation for e-commerce platforms and SaaS applications. Whether you're building the next Shopify, Stripe, or any complex business application, NEXTFORGE provides the robust infrastructure you need.

🎯 Perfect for:

• E-commerce platforms - Online stores, marketplaces, multi-vendor platforms
• SaaS applications - Business tools, productivity apps, subscription services
• Content management - Blogs, corporate websites, documentation sites
• Complex business applications - CRM, ERP, analytics dashboards

🏗️ Architecture Overview

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Frontend      │    │   Backend       │    │  Infrastructure │
│   Next.js 15    │◄──►│  Payload CMS 3.0│◄──►│     Docker      │
│   React 19      │    │   PostgreSQL    │    │   PostgreSQL    │
│   TailwindCSS   │    │   GraphQL API   │    │     Redis       │
│ TanStack Query  │    │   TypeScript    │    │      N8N        │
└─────────────────┘    └─────────────────┘    └─────────────────┘

🚀 Quick Start

Installation

# Using npm (recommended)
npx create-nextforge@latest

# Alternative npm syntax
npm create nextforge@latest

# Using bun
bunx create-nextforge@latest

# Using yarn
yarn create nextforge@latest

# Using pnpm
pnpm create nextforge@latest

Usage

Interactive Mode

bunx create-nextforge@latest

With Command Line Options

bunx create-nextforge@latest my-saas-app --directory ./my-saas-app --skip-install

Available Options

• --template <template> - Template to use (default: default)
• --directory <directory> - Directory to create the project in
• --skip-install - Skip dependency installation
• --skip-git - Skip git repository initialization

📁 Project Structure

After project creation, you'll get this enterprise-ready structure:

my-nextforge-app/
├── frontend/              # Next.js application
│   ├── src/
│   │   ├── app/          # App Router (Next.js 15)
│   │   ├── components/   # Reusable UI components
│   │   └── providers/    # Context providers (TanStack Query)
│   ├── public/           # Static assets
│   └── package.json
├── backend/              # Payload CMS backend
│   ├── src/
│   │   ├── app/         # API routes
│   │   ├── collections/ # Data models (Products, Users, Orders, etc.)
│   │   └── payload.config.ts
│   └── package.json
├── infra/               # Docker infrastructure
│   ├── docker-compose.yml
│   └── redis.conf/
├── scripts/             # Management scripts
│   ├── start-all.sh
│   ├── start-dev.sh
│   └── stop-all.sh
├── workflows/           # N8N automation workflows
├── package.json         # Root package.json
└── README.md

⚡ Getting Started

1. Create your project:

   bunx create-nextforge@latest my-ecommerce-store
   cd my-ecommerce-store

2. Install dependencies:

   bun run setup

3. Start development:

   bun run dev

4. Access your services:

   • Frontend: http://localhost:3000
   • Backend (Payload CMS): http://localhost:3001
   • N8N Workflows: http://localhost:5678

🛠️ Available Commands

Main Commands

• bun run dev - Start development server (without Docker)
• bun run start - Start all services via Docker
• bun run stop - Stop all services
• bun run restart - Restart all services
• bun run logs - View service logs

Development Commands

• bun run dev:frontend - Start frontend only
• bun run dev:backend - Start backend only
• bun run dev:local - Start frontend and backend locally

Docker Commands

• bun run docker:up - Start infrastructure via Docker
• bun run docker:down - Stop Docker containers
• bun run docker:build - Build Docker images
• bun run docker:logs - View Docker logs

🔧 Configuration

Environment Variables

Backend (.env)

PAYLOAD_SECRET=your-secret-key-here
DATABASE_URI=postgresql://admin:StrongPass@localhost:5432/nextforge

# Next.js Configuration
NEXT_PUBLIC_SERVER_URL=http://localhost:3001
NEXT_PUBLIC_PAYLOAD_URL=http://localhost:3001

# Development
NODE_ENV=development

Frontend (.env.local)

NEXT_PUBLIC_API_URL=http://localhost:3001
NEXT_PUBLIC_PAYLOAD_URL=http://localhost:3001

Workflows (.env)

N8N_HOST=localhost
N8N_PORT=5678
N8N_PROTOCOL=http
N8N_EDITOR_BASE_URL=http://localhost:5678

# Database
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=localhost
DB_POSTGRESDB_PORT=5432
DB_POSTGRESDB_DATABASE=nextforge
DB_POSTGRESDB_USER=admin
DB_POSTGRESDB_PASSWORD=StrongPass

# Redis
QUEUE_BULL_REDIS_HOST=localhost
QUEUE_BULL_REDIS_PORT=6379

🏗️ Technology Stack

Frontend

• Next.js 15 - React framework with App Router
• React 19 - Latest React with concurrent features
• TypeScript - Type-safe JavaScript
• TailwindCSS 4 - Utility-first CSS framework
• TanStack Query - Server state management
• Shadcn/ui - Beautiful, accessible UI components

Backend

• Payload CMS 3.0 - Headless CMS with admin panel
• PostgreSQL - Robust relational database
• GraphQL - Flexible API layer
• Lexical - Rich text editor
• TypeScript - Full type safety

Infrastructure

• Docker - Containerization
• PostgreSQL - Primary database
• Redis - Caching and session storage
• N8N - Workflow automation and integrations

Development Tools

• Bun - Fast JavaScript runtime and package manager
• ESLint - Code linting
• Prettier - Code formatting
• TypeScript - Type checking

🎯 Why NEXTFORGE for E-commerce & SaaS?

✅ Built for Scale

• Microservices architecture - Independent scaling of frontend and backend
• Docker containerization - Easy deployment and scaling
• PostgreSQL - Handles complex business data relationships
• Redis caching - Fast response times for high-traffic applications

✅ Developer Experience

• Full TypeScript - Catch errors at compile time
• Hot reloading - Instant feedback during development
• Modern tooling - Bun, ESLint, Prettier for fast development
• Comprehensive scripts - One-command setup and deployment

✅ Business Features

• Payload CMS - Built-in admin panel for content management
• N8N Integration - Automate business processes and integrations
• GraphQL API - Flexible data fetching for complex UIs
• Rich text editing - Lexical editor for content creation

✅ Production Ready

• Security - Built-in authentication and authorization
• Performance - Optimized for speed and SEO
• Monitoring - Logging and error tracking
• Deployment - Docker-based deployment strategy

📋 Requirements

• Node.js >= 18.0.0
• Bun (recommended) or npm/yarn/pnpm
• Docker and Docker Compose
• Git

🚀 Deployment

NEXTFORGE is designed for easy deployment on:

• Vercel (Frontend)
• Railway/Render (Backend)
• AWS/GCP/Azure (Full stack)
• DigitalOcean (VPS deployment)

🤝 Support

Need help? We're here for you:

Create by komvnich

📄 License

MIT License - see LICENSE file for details.

🤝 Contributing

We welcome contributions! Please read CONTRIBUTING.md for information on how to contribute to the project.

Built with ❤️ for the modern web development community

Start building your next big e-commerce or SaaS application today with NEXTFORGE!