deploy-bbc 0.0.1 → 1.0.0

package/cli/README.md

@@ -0,0 +1,345 @@
+# 🚀 deploy-bbc (Best Backend Code)
+
+Bootstrap production-ready backend projects with Bun, TypeScript, and Docker in seconds.
+
+[![npm version](https://img.shields.io/npm/v/deploy-bbc.svg)](https://www.npmjs.com/package/deploy-bbc)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ✨ Features
+
+- 🎯 **Interactive CLI** - Step-by-step project setup with beautiful prompts
+- ⚡ **3 Framework Options** - Choose between Hono, Express, or Bun Native
+- 🗄️ **Multiple Databases** - PostgreSQL, MySQL, MongoDB, Redis with Drizzle ORM/Mongoose
+- 🔐 **Authentication** - JWT, OAuth 2.0, Session-based auth
+- 🤖 **AI Integration** - OpenAI, Anthropic Claude, Google Gemini, Vercel AI SDK
+- ☁️ **Cloud Storage** - AWS S3, Google Cloud, Azure, Cloudflare R2
+- 📧 **Email Services** - Resend, SendGrid, NodeMailer
+- 🔄 **Real-time** - Socket.io, Server-Sent Events
+- 📝 **Validation** - Zod or Yup for request validation
+- 📊 **Background Jobs** - BullMQ, Inngest
+- 📚 **API Documentation** - Swagger/OpenAPI, Scalar
+- 🧪 **Testing** - Vitest with Supertest
+- 🐳 **Docker Ready** - Dockerfile + docker-compose.yml included
+- 📦 **TypeScript** - Full type safety out of the box
+
+## 🚀 Quick Start
+
+```bash
+# Using npx (recommended)
+npx deploy-bbc my-awesome-api
+
+# Using npm
+npm create deploy-bbc my-awesome-api
+
+# Using bun
+bunx deploy-bbc my-awesome-api
+```
+
+## 📦 Installation
+
+```bash
+# Install globally
+npm install -g deploy-bbc
+
+# Use directly with npx
+npx deploy-bbc
+```
+
+## 🎨 Usage
+
+### Interactive Mode
+
+Simply run the command and follow the prompts:
+
+```bash
+npx deploy-bbc my-project
+```
+
+You'll be asked to select:
+1. **Project name** - Your application name
+2. **Framework** - Hono (recommended), Express, or Bun Native
+3. **Database(s)** - PostgreSQL, MySQL, MongoDB, Redis
+4. **Authentication** - JWT, OAuth, Session-based
+5. **AI Providers** - OpenAI, Anthropic, Gemini
+6. **Email Service** - Resend, SendGrid, NodeMailer
+7. **Real-time** - Socket.io or SSE
+8. **Background Jobs** - BullMQ or Inngest
+9. **Validation** - Zod or Yup
+10. **API Docs** - Swagger or Scalar
+11. **Testing** - Vitest setup
+
+### CI Mode (Non-Interactive)
+
+Perfect for automated deployments:
+
+```bash
+npx deploy-bbc my-project \
+  --CI \
+  --express \
+  --postgres \
+  --redis \
+  --jwt \
+  --zod \
+  --vitest \
+  --swagger \
+  --noGit
+```
+
+## 🛠️ Framework Options
+
+### Hono (Default)
+```bash
+npx deploy-bbc my-app --hono
+```
+- Ultrafast web framework built for the edge
+- Tiny footprint (~12KB)
+- Express-like API
+- **Recommended for most projects**
+
+### Express
+```bash
+npx deploy-bbc my-app --express
+```
+- Battle-tested Node.js framework
+- Huge ecosystem
+- Familiar to most developers
+
+### Bun Native
+```bash
+npx deploy-bbc my-app --bun-native
+```
+- Native Bun.serve() API
+- Zero dependencies
+- Maximum performance
+
+## 📊 Available Packages
+
+### Databases
+- `--postgres` - PostgreSQL with Drizzle ORM
+- `--mysql` - MySQL with Drizzle ORM
+- `--mongodb` - MongoDB with Mongoose
+- `--redis` - Redis for caching & sessions
+
+### Authentication
+- `--jwt` - JSON Web Token authentication
+- `--oauth` - OAuth 2.0 (Google, GitHub)
+- `--session` - Session-based auth (requires Redis)
+
+### AI & ML
+- `--openai` - OpenAI GPT models
+- `--anthropic` - Anthropic Claude SDK
+- `--gemini` - Google Gemini
+- `--vercelAI` - Vercel AI SDK (unified interface)
+
+### Cloud Storage
+- `--aws` - AWS S3 & SES
+- `--gcp` - Google Cloud Storage
+- `--azure` - Azure Blob Storage
+- `--cloudflareR2` - Cloudflare R2
+
+### Communication
+- `--resend` - Modern email service
+- `--sendgrid` - Enterprise email
+- `--nodemailer` - SMTP email
+- `--socketio` - WebSockets
+- `--sse` - Server-Sent Events
+
+### Infrastructure
+- `--bullmq` - Redis-based job queue
+- `--inngest` - Serverless job orchestration
+- `--upstashRateLimit` - Upstash rate limiting
+- `--customRateLimit` - Custom rate limit middleware
+- `--sentry` - Error tracking
+- `--logtail` - Log aggregation
+
+### Developer Experience
+- `--swagger` - Swagger/OpenAPI docs
+- `--scalar` - Modern API documentation
+- `--vitest` - Testing framework
+- `--zod` - Zod validation
+- `--yup` - Yup validation
+
+### Options
+- `--noInstall` - Skip dependency installation
+- `--noGit` - Skip git initialization
+- `--CI` - Non-interactive mode
+
+## 📝 Examples
+
+### Full-Stack API with PostgreSQL + JWT + AI
+```bash
+npx deploy-bbc my-api \
+  --hono \
+  --postgres \
+  --redis \
+  --jwt \
+  --openai \
+  --zod \
+  --swagger \
+  --vitest
+```
+
+### Microservice with Express + MongoDB
+```bash
+npx deploy-bbc user-service \
+  --express \
+  --mongodb \
+  --session \
+  --resend \
+  --bullmq \
+  --sentry
+```
+
+### Minimal Bun Native API
+```bash
+npx deploy-bbc fast-api \
+  --bun-native \
+  --postgres \
+  --jwt \
+  --zod
+```
+
+### AI-Powered Backend
+```bash
+npx deploy-bbc ai-backend \
+  --hono \
+  --postgres \
+  --jwt \
+  --anthropic \
+  --vercelAI \
+  --aws \
+  --zod \
+  --scalar
+```
+
+## 🏗️ Project Structure
+
+```
+my-project/
+├── src/
+│   ├── index.ts              # Application entry point
+│   ├── config/               # Configuration
+│   ├── middleware/           # Custom middleware
+│   ├── routes/               # API routes
+│   ├── types/                # TypeScript types
+│   └── utils/                # Utility functions
+├── docker-compose.yml        # Docker services
+├── Dockerfile                # Container configuration
+├── .env.example              # Environment variables template
+├── package.json              # Dependencies
+├── tsconfig.json             # TypeScript config
+└── README.md                 # Project documentation
+```
+
+## 🚦 Getting Started with Your Project
+
+After creating your project:
+
+```bash
+# Navigate to project
+cd my-project
+
+# Copy environment variables
+cp .env.example .env
+
+# Edit .env with your credentials
+nano .env
+
+# Start development server
+bun run dev
+
+# Start with Docker
+docker-compose up -d
+bun run dev
+
+# Run tests
+bun test
+
+# Build for production
+bun run build
+```
+
+## 🔧 Validation Example (Zod)
+
+When you select Zod validation, you get ready-to-use middleware:
+
+```typescript
+import { z } from "zod";
+import { validate, get_validated } from "./middleware/validate.js";
+
+const create_user_schema = z.object({
+  name: z.string().min(2),
+  email: z.string().email(),
+  age: z.number().int().min(18).optional(),
+});
+
+app.post(
+  "/users",
+  validate({ target: "body", schema: create_user_schema }),
+  (c) => {
+    const body = get_validated(c, "body");
+    // body is fully typed and validated
+    return c.json({ user: body });
+  }
+);
+```
+
+## 🐳 Docker Support
+
+Every project includes:
+- **Dockerfile** - Optimized multi-stage build
+- **docker-compose.yml** - Services orchestration
+- Database containers (PostgreSQL, MySQL, Redis)
+- Volume persistence
+- Network configuration
+
+Start everything with:
+```bash
+docker-compose up -d
+```
+
+## 📚 Documentation
+
+Each generated project includes:
+- Comprehensive README.md
+- .env.example with all required variables
+- Example routes and middleware
+- TypeScript types and interfaces
+- Docker setup instructions
+
+## 🤝 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 some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+MIT © [Aritra Sarkar](https://github.com/aritra69)
+
+## 🙏 Acknowledgments
+
+Built with:
+- [Bun](https://bun.sh) - Fast JavaScript runtime
+- [Hono](https://hono.dev) - Ultrafast web framework
+- [Clack](https://github.com/natemoo-re/clack) - Beautiful CLI prompts
+- [Drizzle ORM](https://orm.drizzle.team) - TypeScript ORM
+- [Zod](https://zod.dev) - TypeScript-first validation
+
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/aritra69/deploy-bbc)
+- [npm Package](https://www.npmjs.com/package/deploy-bbc)
+- [Report Issues](https://github.com/aritra69/deploy-bbc/issues)
+
+## ⭐ Show Your Support
+
+Give a ⭐️ if this project helped you!
+
+---
+
+**Made with ❤️ by [Aritra Sarkar](https://github.com/aritra69)**

package/cli/package.json

@@ -1,18 +1,21 @@
 {
     "name": "deploy-bbc",
-    "version": "0.0.1",
+    "version": "1.0.0",
     "description": "CLI to bootstrap production-ready backends with Bun (Best Backend Code)",
     "type": "module",
     "bin": {
         "deploy-bbc": "./dist/index.js"
     },
     "files": [
-        "dist",
-        "templates"
+        "dist"
     ],
+    "engines": {
+        "node": ">=18.0.0"
+    },
     "scripts": {
         "dev": "bun --watch src/index.ts",
-        "build": "bun build src/index.ts --outdir dist --target node",
+        "build": "bun build src/index.ts --outdir dist --target node && cp -r src/templates dist/templates",
+        "prepublishOnly": "bun run build",
         "start": "node dist/index.js",
         "type-check": "tsc --noEmit"
     },
@@ -24,8 +27,16 @@
         "boilerplate",
         "api"
     ],
-    "author": "Your Name",
+    "author": "Aritra Sarkar <aritrasarkar2002@gmail.com>",
     "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/aritra69/deploy-bbc.git"
+    },
+    "homepage": "https://github.com/aritra69/deploy-bbc#readme",
+    "bugs": {
+        "url": "https://github.com/aritra69/deploy-bbc/issues"
+    },
     "dependencies": {
         "@clack/prompts": "^0.7.0",
         "chalk": "^5.3.0",

package/cli/src/helpers/scaffold-project.ts

@@ -42,7 +42,7 @@ export async function scaffold_project(
         ? "base-express"
         : "base-bun-native";
 
-    const templateDir = path.resolve(__dirname, `../templates/${templateDirName}`);
+    const templateDir = path.resolve(__dirname, `templates/${templateDirName}`);
     await fs.copy(templateDir, projectDir, {
       overwrite: false,
       errorOnExist: false,

package/cli/src/installers/ai.ts

@@ -35,7 +35,7 @@ export async function ai_installer(options: InstallerOptions): Promise<void> {
 }
 
 async function install_openai(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(__dirname, "../templates/extras/ai/openai");
+  const templateDir = path.resolve(__dirname, "templates/extras/ai/openai");
   await copy_template_files(templateDir, projectDir);
 
   await add_package_dependency(projectDir, {
@@ -51,7 +51,7 @@ async function install_openai(projectDir: string): Promise<void> {
 async function install_anthropic(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/ai/anthropic"
+    "templates/extras/ai/anthropic"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -66,7 +66,7 @@ async function install_anthropic(projectDir: string): Promise<void> {
 }
 
 async function install_gemini(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(__dirname, "../templates/extras/ai/gemini");
+  const templateDir = path.resolve(__dirname, "templates/extras/ai/gemini");
   await copy_template_files(templateDir, projectDir);
 
   await add_package_dependency(projectDir, {
@@ -82,7 +82,7 @@ async function install_gemini(projectDir: string): Promise<void> {
 async function install_vercel_ai(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/ai/vercel-ai"
+    "templates/extras/ai/vercel-ai"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/auth.ts

@@ -34,7 +34,7 @@ export async function auth_installer(
 }
 
 async function install_jwt(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(__dirname, "../templates/extras/auth/jwt");
+  const templateDir = path.resolve(__dirname, "templates/extras/auth/jwt");
   await copy_template_files(templateDir, projectDir);
 
   await add_package_dependency(projectDir, {
@@ -58,7 +58,7 @@ async function install_jwt(projectDir: string): Promise<void> {
 }
 
 async function install_oauth(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(__dirname, "../templates/extras/auth/oauth");
+  const templateDir = path.resolve(__dirname, "templates/extras/auth/oauth");
   await copy_template_files(templateDir, projectDir);
 
   await add_package_dependency(projectDir, {
@@ -83,7 +83,7 @@ async function install_oauth(projectDir: string): Promise<void> {
 async function install_session(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/auth/session"
+    "templates/extras/auth/session"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/cloud.ts

@@ -37,7 +37,7 @@ export async function cloud_installer(
 }
 
 async function install_aws(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(__dirname, "../templates/extras/cloud/aws");
+  const templateDir = path.resolve(__dirname, "templates/extras/cloud/aws");
   await copy_template_files(templateDir, projectDir);
 
   await add_package_dependency(projectDir, {
@@ -53,7 +53,7 @@ async function install_aws(projectDir: string): Promise<void> {
 }
 
 async function install_gcp(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(__dirname, "../templates/extras/cloud/gcp");
+  const templateDir = path.resolve(__dirname, "templates/extras/cloud/gcp");
   await copy_template_files(templateDir, projectDir);
 
   await add_package_dependency(projectDir, {
@@ -69,7 +69,7 @@ async function install_gcp(projectDir: string): Promise<void> {
 async function install_azure(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/cloud/azure"
+    "templates/extras/cloud/azure"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -86,7 +86,7 @@ async function install_azure(projectDir: string): Promise<void> {
 async function install_cloudflare_r2(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/cloud/cloudflare-r2"
+    "templates/extras/cloud/cloudflare-r2"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/database.ts

@@ -42,7 +42,7 @@ async function install_postgres(projectDir: string): Promise<void> {
   // Copy template files
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/database/postgres"
+    "templates/extras/database/postgres"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -74,7 +74,7 @@ async function install_mysql(projectDir: string): Promise<void> {
   // Copy template files
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/database/mysql"
+    "templates/extras/database/mysql"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -106,7 +106,7 @@ async function install_mongodb(projectDir: string): Promise<void> {
   // Copy template files
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/database/mongodb"
+    "templates/extras/database/mongodb"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -126,7 +126,7 @@ async function install_redis(projectDir: string): Promise<void> {
   // Copy template files
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/database/redis"
+    "templates/extras/database/redis"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/docs.ts

@@ -33,7 +33,7 @@ export async function docs_installer(
 async function install_swagger(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/docs/swagger"
+    "templates/extras/docs/swagger"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -45,7 +45,7 @@ async function install_swagger(projectDir: string): Promise<void> {
 async function install_scalar(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/docs/scalar"
+    "templates/extras/docs/scalar"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/email.ts

@@ -36,7 +36,7 @@ export async function email_installer(
 async function install_resend(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/email/resend"
+    "templates/extras/email/resend"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -53,7 +53,7 @@ async function install_resend(projectDir: string): Promise<void> {
 async function install_sendgrid(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/email/sendgrid"
+    "templates/extras/email/sendgrid"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -70,7 +70,7 @@ async function install_sendgrid(projectDir: string): Promise<void> {
 async function install_nodemailer(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/email/nodemailer"
+    "templates/extras/email/nodemailer"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/observability.ts

@@ -33,7 +33,7 @@ export async function observability_installer(
 async function install_sentry(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/observability/sentry"
+    "templates/extras/observability/sentry"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -50,7 +50,7 @@ async function install_sentry(projectDir: string): Promise<void> {
 async function install_logtail(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/observability/logtail"
+    "templates/extras/observability/logtail"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/queue.ts

@@ -33,7 +33,7 @@ export async function queue_installer(
 async function install_bullmq(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/queue/bullmq"
+    "templates/extras/queue/bullmq"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -50,7 +50,7 @@ async function install_bullmq(projectDir: string): Promise<void> {
 async function install_inngest(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/queue/inngest"
+    "templates/extras/queue/inngest"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/ratelimit.ts

@@ -33,7 +33,7 @@ export async function ratelimit_installer(
 async function install_upstash_ratelimit(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/ratelimit/upstash"
+    "templates/extras/ratelimit/upstash"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -51,7 +51,7 @@ async function install_upstash_ratelimit(projectDir: string): Promise<void> {
 async function install_custom_ratelimit(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/ratelimit/custom"
+    "templates/extras/ratelimit/custom"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/realtime.ts

@@ -33,7 +33,7 @@ export async function realtime_installer(
 async function install_socketio(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/realtime/socketio"
+    "templates/extras/realtime/socketio"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -53,7 +53,7 @@ async function install_socketio(projectDir: string): Promise<void> {
 async function install_sse(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/realtime/sse"
+    "templates/extras/realtime/sse"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/testing.ts

@@ -30,7 +30,7 @@ export async function testing_installer(
 async function install_vitest(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/testing/vitest"
+    "templates/extras/testing/vitest"
   );
   await copy_template_files(templateDir, projectDir);
 

package/cli/src/installers/validation.ts

@@ -33,7 +33,7 @@ export async function validation_installer(
 async function install_zod(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/validation/zod"
+    "templates/extras/validation/zod"
   );
   await copy_template_files(templateDir, projectDir);
 
@@ -45,7 +45,7 @@ async function install_zod(projectDir: string): Promise<void> {
 async function install_yup(projectDir: string): Promise<void> {
   const templateDir = path.resolve(
     __dirname,
-    "../templates/extras/validation/yup"
+    "templates/extras/validation/yup"
   );
   await copy_template_files(templateDir, projectDir);
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "deploy-bbc",
-    "version": "0.0.1",
+    "version": "1.0.0",
     "description": "CLI to bootstrap production-ready backends with Bun (Best Backend Code)",
     "workspaces": [
         "cli"