✨ Features

| Feature | Description | |---------|-------------| | ⚡ Next.js 16 | Latest App Router with Turbopack for lightning-fast development | | 🔐 NextAuth v5 | Secure authentication with JWT & session support | | 🗃️ Redux Toolkit | Efficient state management with RTK Query for API calls | | 🎨 Tailwind CSS v4 | Modern utility-first CSS with tw-animate-css | | 📱 Responsive | Mobile-first design with shadcn/ui components | | 🏗️ Clean Architecture | Feature-sliced design for scalable codebase | | 🔄 Token Monitor | Built-in token refresh and session management | | 📊 Progress Bar | NProgress integration for page transitions | | 🌙 Dark Mode | Built-in theme switching with next-themes | | 🛡️ TypeScript | Full type safety throughout the codebase |

🚀 Quick Start

Create a New Project

# Using npx (recommended)
npx nextjs-redux-api-core my-app

# Or using npm
npm exec nextjs-redux-api-core my-app

# Or install globally
npm install -g nextjs-redux-api-core
create-nxcore my-app

Start Development

cd my-app
npm run dev

Open http://localhost:4000 to see your app.

📁 Project Structure

my-app/
├── 📂 app/                    # Next.js App Router
│   ├── (auth)/               # Auth routes (sign-in, sign-up)
│   ├── (root)/               # Protected routes
│   ├── api/                  # API routes
│   ├── layout.tsx            # Root layout
│   └── globals.css           # Global styles
│
├── 📂 components/             # Shared UI components
│   ├── layout/               # Layout components
│   ├── molecules/            # Composite components
│   └── ui/                   # Base UI components (shadcn)
│
├── 📂 config/                 # App configuration
│   ├── constants.ts          # App constants
│   ├── env.ts               # Environment config
│   ├── routes.ts            # Route definitions
│   └── modules.ts           # Module registry
│
├── 📂 infrastructure/         # Technical layer
│   ├── api/                  # RTK Query base config
│   ├── auth/                 # NextAuth configuration
│   ├── hooks/                # Global hooks
│   ├── providers/            # App providers
│   └── store/                # Redux store setup
│
├── 📂 modules/                # Feature modules
│   ├── auth/                 # Authentication module
│   │   ├── api/             # Auth API endpoints
│   │   ├── components/      # Auth UI components
│   │   ├── hooks/           # Auth hooks
│   │   ├── services/        # Auth business logic
│   │   ├── store/           # Auth state slice
│   │   └── types/           # Auth types
│   └── menu/                 # Menu module
│
├── 📂 lib/                    # Utility functions
│   ├── utils.ts             # General utilities
│   ├── formatters.ts        # Data formatters
│   └── validators.ts        # Validation helpers
│
├── 📂 types/                  # Global type definitions
│   ├── global.d.ts          # Global types
│   └── next-auth.d.ts       # NextAuth type extensions
│
└── 📂 assets/                 # Static assets
    └── styles/              # Global stylesheets

🏗️ Architecture Overview

┌─────────────────────────────────────────────────────────────────┐
│                         APP LAYER                                │
│  Next.js App Router - Routes, Layouts, Pages                    │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      FEATURE MODULES                             │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐               │
│  │    Auth     │ │    Menu     │ │   [Your]    │               │
│  │   Module    │ │   Module    │ │   Module    │               │
│  └─────────────┘ └─────────────┘ └─────────────┘               │
│  Components • Hooks • Services • Store • Types                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    INFRASTRUCTURE LAYER                          │
│  Redux Store • NextAuth • RTK Query • Providers                 │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    SHARED COMPONENTS                             │
│  UI Components • Layout • Molecules                             │
└─────────────────────────────────────────────────────────────────┘

📝 Environment Variables

Create a .env.local file in the root directory:

# App Configuration
NEXT_PUBLIC_APP_NAME="Your App Name"
NEXT_PUBLIC_APP_URL="http://localhost:4000"
NEXT_PUBLIC_API_URL="http://localhost:4000/api"

# Authentication (Required)
AUTH_SECRET="your-secret-key"  # Generate: openssl rand -base64 32
AUTH_URL="http://localhost:4000"

# Database (Optional)
DATABASE_URL="postgresql://user:password@localhost:5432/mydb"

🛠️ Available Scripts

| Command | Description | |---------|-------------| | npm run dev | Start development server on port 4000 | | npm run build | Build for production | | npm run start | Start production server | | npm run lint | Run ESLint |

📚 Feature Module Template

Create new features following this structure:

modules/
  [feature-name]/
    ├── components/           # UI components
    │   ├── [Feature]Page.tsx
    │   └── index.ts
    ├── hooks/               # React hooks
    │   └── use[Feature].ts
    ├── services/            # Business logic
    │   └── [feature].service.ts
    ├── store/               # Redux slice (optional)
    │   └── [feature]Slice.ts
    ├── api/                 # RTK Query endpoints
    │   └── [feature]Api.ts
    ├── types/               # TypeScript types
    │   └── index.ts
    └── index.ts             # Public exports

🤝 Contributing

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

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

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

🙏 Acknowledgments

• Next.js - The React Framework
• Redux Toolkit - State Management
• NextAuth.js - Authentication
• Tailwind CSS - Styling
• shadcn/ui - UI Components