⚡ InitraJS - JavaScript CLI Toolkit | Lightning-fast scaffolding for React, Next.js, Node.js with TypeScript | The future of JavaScript development | 10x faster than create-react-app | Ultimate developer productivity tool
npm install initrajsbash
From zero to running app in under 60 seconds
npm install -g initrajs
npx initrajs init my-app
cd my-app && npm start
`
$3
- Clean Architecture: MVC + Service Layer pattern with dependency injection
- Type Safety: Full TypeScript support with intelligent type generation
- Security First: JWT authentication, CORS, rate limiting, and security headers
- Testing Ready: Jest, React Testing Library, and E2E tests configured
- Production Optimized: Bundle splitting, lazy loading, and performance monitoring
---
📖 Introduction
InitraJS is a powerful zero-config CLI that scaffolds production-ready fullstack applications and generates components with lightning speed. Featuring cutting-edge architecture, comprehensive code generation, and battle-tested best practices — get from idea to deployment in minutes, not hours.
🎯 Perfect for:
- 🚀 Startups needing rapid prototyping
- 🏢 Enterprise teams requiring consistent architecture
- 👨💻 Solo developers wanting best practices built-in
- 🎓 Learning modern fullstack development patterns
---
📚 Table of Contents
- 🚀 Features
- 🎯 What Makes InitraJS Special
- 📦 Installation & Quick Start
- ⚡ Quick Demo
- 🎯 Code Generation
- 🧰 Supported Templates
- 📁 Project Structure
- ⚙️ Backend Architecture
- 🛠️ Advanced Usage
- 🌟 Success Stories
- 🛣️ Roadmap
- 🐞 Troubleshooting
- 👨💻 Contributing
- 📄 License
---
🚀 Features
$3
- 🧩 Smart Components: Generate React components with TypeScript, CSS, tests, and Storybook stories
- 📄 Page Generation: Create React pages or Next.js app router pages with full folder structure
- 🔧 Backend Scaffolding: Generate complete APIs with controllers, services, models, DTOs, and routes
- 🎨 Style Integration: Automatic CSS/SCSS generation with BEM methodology
- 🧪 Test Coverage: Jest + React Testing Library setup out of the box
$3
- ⚙️ Full TypeScript Support with intelligent type generation
- 🎨 Integrated MUI v5 with global theme customization
- 🧠 Configured Redux Toolkit for scalable state management
- 🔐 AuthContext + AuthGuard for protected routing
- 🧾 Class-based API Services for clean, DRY code
- 📂 Modular App Directory Structure using Next.js App Router
- 💾 Session-based token handling, synced with AuthContext
- 📱 Responsive Design with mobile-first approach
$3
- 🏗️ Structured MVC + Service Layer architecture
- 🔐 JWT authentication with middleware protection
- ✅ DTOs and Validators using express-validator
- 🌐 Modular route handling with auto-registration
- 🔥 Global error middleware with consistent responses
- 📦 TypeScript-first with modern conventions
- 🚀 Auto-generated CRUD operations
---
📦 Installation & Quick Start
$3
`bash
npm install -g initrajs
`
$3
`bash
Create a full-stack app in seconds
npx initrajs init my-awesome-app
cd my-awesome-app
Generate a component with everything
initrajs c ProductCard --css --test --story --props "title,price,image"
Create a protected dashboard page
initrajs page Dashboard --next --css --test
Generate a complete API endpoint
initrajs api User --ts
Start developing
npm run dev
`
$3
`bash
1. Initialize project (30 seconds)
npx initrajs init ecommerce-app --template nextjs
2. Generate components (2 minutes)
initrajs c ProductGrid --css --test --props "products,loading"
initrajs c ShoppingCart --css --test --props "items,onUpdate"
3. Create pages (1 minute)
initrajs page Products --next --css --test
initrajs page Checkout --next --css --test
4. Build API (2 minutes)
initrajs api Product --ts
initrajs api Order --ts
5. Deploy (1 minute)
npm run build && npm run deploy
`
🎉 Result: Production-ready e-commerce app in under 10 minutes!
---
🎯 Code Generation
$3
`bash
Basic component (defaults to TypeScript)
initrajs c Header
Component with all the bells and whistles
initrajs c ProductCard --css --test --story --props "title,price,image"
Layout component with TypeScript
initrajs c AppLayout --layout --ts --css
Server-side component for Next.js
initrajs c UserProfile --server --css --test
`
Generated Structure:
`
src/components/ProductCard/
├── ProductCard.tsx # Main component with TypeScript
├── ProductCard.scss # BEM-style CSS (if --css)
├── ProductCard.test.tsx # Jest tests (if --test)
├── ProductCard.stories.tsx # Storybook story (if --story)
└── index.ts # Barrel export
`
$3
`bash
React page for standard React apps
initrajs page Home --react --css --test
Next.js page with app router structure
initrajs page Dashboard --next --ts --css --test
Custom path for organization
initrajs page UserProfile --next --path "app/user" --css
`
Next.js Page Structure:
`
app/dashboard/
├── page.tsx # Main page component
├── loading.tsx # Loading UI
├── error.tsx # Error boundary
├── dashboard.scss # Page styles (if --css)
└── page.test.tsx # Page tests (if --test)
`
$3
`bash
Complete API with all files
initrajs api Product --ts
Individual backend components
initrajs route User --ts
initrajs controller Order --ts
initrajs service PaymentService --ts
initrajs model ProductModel --ts
initrajs middleware AuthMiddleware --jwt --ts
`
---
🧰 Supported Templates
| Template | Tech Stack | TypeScript | Features |
|----------|------------|------------|----------|
| React | Vite + MUI + Redux | ✅ | Theme, State Management, AuthContext |
| Next.js | App Router + MUI + Redux | ✅ | AuthGuard, Layouts, Sessions, SEO |
| Node.js | Express MVC + TypeScript | ✅ | DTOs, Middleware, Services, JWT |
$3
#### React Template
- ⚡ Vite for blazing fast development
- 🎨 Material-UI v5 with custom theming
- 🗃️ Redux Toolkit with configured store
- 🔐 Authentication context and guards
- 📱 Responsive design system
#### Next.js Template
- 🚀 App Router for modern routing
- 🛡️ Middleware-based authentication
- 📊 SEO optimized with metadata API
- 🎯 Server Components support
- 📦 Bundle optimization
#### Node.js Template
- 🏗️ Clean Architecture with layers
- 🔒 Security middlewares included
- 📝 API Documentation ready
- 🧪 Testing setup with Jest
- 🐳 Docker configuration
---
📁 Project Structure
$3
`
app/
├── layout.tsx # Root layout (Providers, Theme)
├── globals.css # Global styles
├── auth/
│ ├── layout.tsx # Auth pages layout
│ ├── login/page.tsx # Login page
│ └── register/page.tsx # Register page
├── (dashboard)/ # Route groups
│ ├── layout.tsx # Protected layout with AuthGuard
│ ├── dashboard/page.tsx # Dashboard page
│ ├── settings/page.tsx # Settings page
│ └── profile/page.tsx # Profile page
├── api/ # API routes
├── components/ # Reusable components
└── lib/ # Utilities and configurations
`
$3
`
src/
├── controllers/ # Request handlers
├── services/ # Business logic
├── models/ # Data models
├── routes/ # Route definitions
├── middleware/ # Custom middleware
│ ├── auth.middleware.ts
│ ├── error.middleware.ts
│ └── validation.middleware.ts
├── dto/ # Data Transfer Objects
├── validators/ # Input validation
├── utils/ # Helper functions
├── types/ # TypeScript types
└── server.ts # Application entry point
`
---
⚙️ Backend Architecture
$3
`typescript
// Controller Layer
export class UserController {
async createUser(req: Request, res: Response) {
const result = await this.userService.create(req.body);
res.json(result);
}
}
// Service Layer
export class UserService {
async create(userData: CreateUserDTO): Promise {
// Business logic here
return this.userModel.create(userData);
}
}
// Model Layer
export class UserModel {
async create(data: CreateUserDTO): Promise {
// Database operations
}
}
`
$3
1. Token Storage: Secure sessionStorage implementation
2. Context Sync: AuthContext manages global auth state
3. Route Protection: AuthGuard automatically protects routes
4. Middleware: JWT validation on backend routes
5. Auto-refresh: Token refresh handling
---
🛠️ Advanced Usage
$3
| Option | Description | Usage |
|--------|-------------|-------|
| --ts | Generate TypeScript files | initrajs c Button --ts |
| --js | Generate JavaScript files | initrajs c Button --js |
| --css | Include CSS/SCSS files | initrajs c Button --css |
| --test | Generate test files | initrajs c Button --test |
| --story | Generate Storybook stories | initrajs c Button --story |
| --path | Custom file path | initrajs c Button --path "src/ui" |
| --props | Component props | initrajs c Button --props "text,onClick" |
| --server | Server-side component | initrajs c Button --server |
| --client | Client-side component | initrajs c Button --client |
| --layout | Layout component | initrajs c Header --layout |
| --next | Next.js page structure | initrajs page Home --next |
| --react | Standard React page | initrajs page Home --react |
$3
- TypeScript First: Defaults to .tsx unless --js specified
- Modern Patterns: Uses latest React patterns and hooks
- Best Practices: Follows industry standards for file organization
- Performance: Optimized bundle splitting and lazy loading
- Accessibility: WCAG compliant components
$3
`bash
Custom component with all options
initrajs c DataTable \
--ts \
--css \
--test \
--story \
--props "data,columns,onSort,loading" \
--path "src/components/tables"
Next.js page with custom route
initrajs page UserDashboard \
--next \
--css \
--test \
--path "app/(dashboard)/users"
`
🛣️ Roadmap
$3
- ✅ React, Next.js, Node.js Templates
- ✅ TypeScript-first scaffolding
- ✅ MUI with theme configuration
- ✅ AuthContext + Redux integration
- ✅ Class-based API services
- ✅ MVC backend with DTO, validation, error handling
- ✅ Component & page generators
- ✅ CSS/SCSS generation with BEM
- ✅ Test file generation (Jest + RTL)
- ✅ Storybook story generation
$3
- 🚧 Database integration templates (Prisma, MongoDB)
- 🚧 Docker containerization
- 🚧 GitHub Actions CI/CD templates
- 🚧 Interactive CLI with project wizard
$3
- 📋 Custom template overrides
- 📋 CLI plugins ecosystem
- 📋 Monorepo & microservice support
- 📋 GraphQL API generation
- 📋 E2E testing setup (Playwright)
- 📋 PWA configuration
- 📋 Mobile app templates (React Native)
- 📋 VS Code extension
---
🐞 Troubleshooting
$3
#### 🔄 Upgrade CLI
`bash
npm install -g initrajs@latest
`
#### 🧹 Clear NPX Cache
`bash
npx clear-npx-cache
npm cache clean --force
`
#### 📦 Node Version
Ensure you're using Node.js 16+ for optimal compatibility.
#### 🔧 Permission Issues
`bash
On macOS/Linux
sudo npm install -g initrajs
On Windows (Run as Administrator)
npm install -g initrajs
`
#### 🚀 Development Mode
`bash
git clone https://github.com/blessedrajp/initrajs.git
cd initrajs
npm install
npm run dev
npm link # Use local version
`
---
👨💻 Contributing
We welcome contributions! Here's how to get started:
`bash
Fork and clone the repository
git clone https://github.com/blessedrajp/initrajs.git
cd initrajs
Install dependencies
npm install
Start development mode
npm run dev
Run tests
npm test
Build the project
npm run build
`
$3
1. Fork the repository
2. Create a 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`)