🚀 BlitzStack CLI Tool

BlitzStack is a powerful, professional-grade CLI tool designed to scaffold high-performance Next.js applications in seconds. It comes pre-configured with industry-standard patterns, a premium UI/UX structure, and a robust state-management architecture.

Built by Jahirul Islam for developers who value speed, consistency, and best practices.

🌟 Why BlitzStack?

Staring at a blank create-next-app is time-consuming. BlitzStack bridges the gap between a raw installation and a production-ready application.

• Zero-Config Professional Routing: Automatically sets up Route Groups ((main), auth, dashboard).
• Premium UI Starter: Includes a stunning Landing Page, Sidebar, and TopNavbar out of the box.
• Dynamic Secure Storage: Automatically generates unique LocalStorage keys for each project to avoid token conflicts.
• Pre-baked Interceptors: Axios is pre-configured with request/response interceptors for seamless API handling.
• Production Ready: Pre-configured .env, vercel.json (rewrites), and .gitignore.

📦 Core Tech Stack & Packages

BlitzStack automatically installs and configures the following professional packages:

| Category | Packages | | :--------------------- | :-------------------------------------------- | | Framework | Next.js (Latest), React 19 | | Styling | Tailwind CSS v4, Lucide React, Shadcn UI | | State Management | Redux Toolkit, React Redux | | Data Fetching | @tanstack/react-query, Axios | | Forms & Validation | React Hook Form | | UI Components | Shadcn UI (Button), Sonner (Toasts), Recharts | | Utilities | clsx, tailwind-merge, localforage |

🚀 Getting Started

[!IMPORTANT] Use npx for Instant Setup:
To avoid installation issues, we recommend using npx. This ensures you are always using the latest version of BlitzStack.

1. Create a New Project

Run this command in your terminal:

npx create-next-pro-stack my-awesome-project

2. Manual Installation (Optional)

If you want to install the CLI tool globally on your system:

npm install -g create-next-pro-stack

# Then run:
create-next-pro-stack my-awesome-project

📁 Folder Structure Overview

src/
├── app/
│   ├── (main)/          # Landing & Public pages
│   ├── auth/            # Login/Register flows
│   └── dashboard/       # Protected dashboard routes
├── components/          # Reusable UI components
├── hooks/
│   └── Axios/           # Pre-configured useAxiosPublic & useAxiosPrivate
├── providers/           # Redux, React Query, and UI Providers
├── redux/               # Store configuration and Slices
├── shared/              # Shared Layout components (Sidebar, Navbar)
└── utils/               # Helper functions (cn, localStorage, etc.)

🛠️ Key Features Under the Hood

Professional Axios Interceptors

Your project comes with two main API hooks:

• useAxiosPublic: For open APIs with built-in network error handling.
• useAxiosPrivate: For secure APIs. It automatically handles:
  • Dynamic Authorization tokens.
  • Automatic logout on 401 (Session Expired).
  • Friendly sonner toasts for every error status (403, 404, 500+).

Vercel Ready

Includes a vercel.json with a catch-all rewrite rule:

{
  "rewrites": [{ "source": "/(.*)", "destination": "/" }]
}

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

📝 License

Copyright © 2026 Jahirul Islam. This project is MIT licensed.