BlitzStack Docs

🚀 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

💡

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:

bash

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

2. Manual Installation (Optional)

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

bash

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:

json

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

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