codetentacles-org-cli

org-cli 🚀

Automated project scaffolding CLI for your organization. Create production-ready Next.js, React, or Node.js/TypeScript projects with best practices, modern tooling, and complete folder structures.

📦 Three CLIs in One Package

org-nextjs - Next.js Application Scaffolding

Scaffold production-ready Next.js applications with App Router, TypeScript, Tailwind CSS, and custom components - built on top of the official create-next-app.

org-react - React Application Scaffolding

Scaffold production-ready React applications with Vite, Tailwind CSS, React Router, Redux Toolkit, and best practices.

org-node - Node.js API Scaffolding

Scaffold production-ready Node.js/TypeScript REST APIs with Express and your choice of ORM:

• MongoDB with Mongoose
• PostgreSQL/MySQL with Sequelize
• Prisma (PostgreSQL, MySQL, SQLite)

📦 Installation

Global Installation (Recommended)

npm install -g org-cli

After installation, you'll have access to all three commands:

• org-nextjs - For Next.js projects
• org-react - For React projects
• org-node - For Node.js projects

Local Development

git clone <your-repo>
cd org-react-cli
npm install
npm link

⚡ org-nextjs

Features

• 🚀 Official Next.js Setup - Uses create-next-app as foundation
• ⚡ App Router - Modern Next.js 14+ App Router architecture
• 📘 TypeScript - Full TypeScript support out of the box
• 🎨 Tailwind CSS - Pre-configured with custom color palette
• 🌗 Dark Mode - next-themes integration with theme toggle
• 🧭 Route Groups - Organized routing with (main) group
• 🗂️ Best Practice Structure - Components separated from app directory
• 📦 UI Components - Button, Card, Navbar, Footer components
• 🏠 Landing Page - Hero and Features sections
• 🔌 API Routes - Example API endpoint setup
• 🎯 Path Aliases - Use @/ imports for cleaner code

Usage

Interactive Mode

org-nextjs

Quick Mode

org-nextjs my-app --pm pnpm

Options

Option	Description	Default
[project-name]	Project directory name	Prompts if not provided
--pm <manager>	Package manager: npm, pnpm, yarn, bun	npm
--skip-install	Skip dependency installation	false
--skip-git	Skip git initialization	false

Generated Structure

my-app/
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── (main)/             # Route group
│   │   │   ├── about/          # About page
│   │   │   └── dashboard/      # Dashboard page
│   │   ├── api/hello/          # API routes
│   │   ├── layout.tsx          # Root layout
│   │   ├── page.tsx            # Home page
│   │   ├── loading.tsx         # Loading UI
│   │   ├── error.tsx           # Error UI
│   │   └── not-found.tsx       # 404 page
│   ├── components/             # React components
│   │   ├── home/               # Hero, Features
│   │   ├── layout/             # Navbar, Footer
│   │   ├── providers/          # Theme provider
│   │   ├── ui/                 # Button, Card
│   │   └── theme-toggle.tsx    # Dark mode toggle
│   ├── lib/                    # Utilities
│   │   ├── api-client.ts       # API client
│   │   └── utils.ts            # Helper functions
│   └── hooks/                  # Custom hooks
├── tailwind.config.ts
├── next.config.ts
└── package.json

Getting Started (Next.js Projects)

• Navigate to project:

  cd my-app
  

• Start development:

  npm run dev
  

• Open browser: Visit http://localhost:3000

🎨 org-react

Features

• ⚡ Vite - Lightning-fast dev server and build tool
• 🎨 Tailwind CSS - Pre-configured with custom color palette
• 🧭 React Router - Client-side routing with example pages
• 📦 Redux Toolkit - State management with example slice
• 🌐 Axios - Generic API service with interceptors
• 🗂️ Best Practice Structure - Organized folders for components, hooks, services, utils
• 📄 Dummy Files - Complete set of template files to get started immediately
• 🔧 ESLint & Prettier - Code quality and formatting
• 🎯 Path Aliases - Use @/ imports for cleaner code

Usage

Interactive Mode

org-react

Quick Mode

org-react my-app --pm pnpm

Options

Option	Description	Default
[project-name]	Project directory name	Prompts if not provided
--pm <manager>	Package manager: npm, pnpm, yarn, bun	npm
--skip-install	Skip dependency installation	false
--skip-git	Skip git initialization	false

Generated Structure

my-app/
├── src/
│   ├── api/                    # API client & endpoints
│   ├── components/             # Reusable components
│   │   ├── common/             # Button, Card, Input
│   │   └── layout/             # Navbar, Footer
│   ├── hooks/                  # useFetch, useLocalStorage
│   ├── pages/                  # Home, Dashboard, Profile
│   ├── redux/                  # Store & slices
│   ├── routes/                 # Route definitions
│   ├── services/               # Business logic
│   └── utils/                  # Helper functions
├── tailwind.config.js
├── vite.config.js
└── package.json

🚀 org-node

Features

✨ Multiple ORM Support

• MongoDB with Mongoose
• PostgreSQL/MySQL with Sequelize
• Prisma (supports PostgreSQL, MySQL, SQLite)

📦 Best Practices Built-in

• TypeScript for type safety
• Express.js server
• MVC architecture (Controllers, Services, Models)
• Joi validation
• JWT authentication ready
• Error handling middleware
• Clean folder structure

🛠️ Developer Experience

• Hot reload with Nodemon
• TypeScript compilation
• Environment configuration
• Git initialization

Usage

Interactive Mode

org-node

You'll be prompted for:

• Project name
• ORM/Database type
• Database dialect (for Sequelize/Prisma)

CLI Mode

# MongoDB
org-node my-api --mongodb

# PostgreSQL with Sequelize
org-node my-api --sequelize

# Prisma with PostgreSQL
org-node my-api --prisma

Options

Flag	Description	Default
--mongodb	Use MongoDB with Mongoose	-
--sequelize	Use Sequelize ORM	-
--prisma	Use Prisma ORM	-
--pm <manager>	Package manager: npm|pnpm|yarn|bun	npm
--skip-install	Skip installing dependencies	false
--skip-git	Skip git initialization	false

Examples

# Create MongoDB project with pnpm
org-node blog-api --mongodb --pm pnpm

# Create Prisma project, skip install
org-node shop-api --prisma --skip-install

# Create Sequelize project
org-node user-service --sequelize

Generated Structure

my-api/
├── src/
│   ├── config/          # env.config.ts, db.config.ts
│   ├── controllers/     # Route controllers
│   ├── middleware/      # Error, validation, auth
│   ├── models/          # Database models (ORM-specific)
│   ├── routes/          # API routes
│   ├── services/        # Business logic
│   ├── utils/           # ApiError, ApiResponse
│   ├── validation/      # Joi schemas
│   └── index.ts         # App entry point
├── .env.example
├── tsconfig.json
├── nodemon.json
└── package.json

Generated API Endpoints

• POST /api/users/register - Register new user
• POST /api/users/login - Login user (returns JWT)
• GET /api/users - Get all users
• GET /api/users/:id - Get user by ID
• PUT /api/users/:id - Update user
• DELETE /api/users/:id - Delete user
• GET /api/health - Server status

Getting Started (Node Projects)

• Navigate to project:

  cd my-api
  

• Configure environment:

  cp .env.example .env
  # Edit .env with your database credentials
  

• For Prisma only:

  npx prisma generate
  npx prisma migrate dev --name init
  

• Start development:

  npm run dev
  

🎯 Quick Start Examples

Create a Next.js App

org-nextjs my-nextjs-app --pm pnpm
cd my-nextjs-app
npm run dev
# Open http://localhost:3000

Create a React Dashboard

org-react my-dashboard --pm pnpm
cd my-dashboard
npm run dev

Create a REST API with MongoDB

org-node my-api --mongodb --pm pnpm
cd my-api
cp .env.example .env
# Configure MongoDB URI in .env
npm run dev

Create a REST API with Prisma & PostgreSQL

org-node my-api --prisma
cd my-api
cp .env.example .env
# Configure DATABASE_URL in .env
npx prisma generate
npx prisma migrate dev --name init
npm run dev

🛠️ Requirements

• Node.js >= 16.14.0
• npm, pnpm, yarn, or bun
• For Node projects: Database (MongoDB, PostgreSQL, MySQL, or SQLite)

📝 License

MIT

🤝 Contributing

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

Made with ❤️ for rapid development