deploy-bbc 1.2.2 → 1.2.3

package/README.md

@@ -1,345 +1,219 @@
-# 🚀 deploy-bbc (Best Backend Code)
+# deploy-bbc
 
-Bootstrap production-ready backend projects with Bun, TypeScript, and Docker in seconds.
+<p align="center">
+  <b>Best Backend Code</b> — A powerful CLI to bootstrap production-ready backend applications with Bun
+</p>
 
-[![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)
+<p align="center">
+  <img src="https://img.shields.io/npm/v/deploy-bbc" alt="npm version" />
+  <img src="https://img.shields.io/npm/dt/deploy-bbc" alt="npm downloads" />
+  <img src="https://img.shields.io/github/stars/aritra69/deploy-bbc" alt="github stars" />
+  <img src="https://img.shields.io/github/license/aritra69/deploy-bbc" alt="license" />
+</p>
 
-## ✨ 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
+## Overview
 
-## 🚀 Quick Start
+`deploy-bbc` is an interactive command-line tool that scaffolds modern, type-safe backend applications using Bun.
 
-```bash
-# Using npx (recommended)
-npx deploy-bbc my-awesome-api
+It ships with production-ready defaults, optional integrations, Docker support, and a clean architecture so you can focus on building features instead of wiring infrastructure.
 
-# Using npm
-npm create deploy-bbc my-awesome-api
+---
 
-# Using bun
-bunx deploy-bbc my-awesome-api
-```
+## Tech Stack
 
-## 📦 Installation
+<p align="center">
+  <img height="40" src="https://bun.sh/logo.svg" alt="Bun" />
+  <img height="40" src="https://hono.dev/images/logo.svg" alt="Hono" />
+  <img height="40" src="https://raw.githubusercontent.com/expressjs/expressjs.com/gh-pages/images/favicon.png" alt="Express" />
+  <img height="40" src="https://www.typescriptlang.org/icons/icon-48x48.png" alt="TypeScript" />
+  <img height="40" src="https://www.docker.com/wp-content/uploads/2022/03/Moby-logo.png" alt="Docker" />
+</p>
 
-```bash
-# Install globally
-npm install -g deploy-bbc
+---
 
-# Use directly with npx
-npx deploy-bbc
-```
+## Features
 
-## 🎨 Usage
+- ⚡ **Three framework options**: Hono, Express, or Bun Native HTTP
+- 🚀 **Production-ready templates** with best practices
+- 🔌 **30+ integrations** (databases, auth, AI, cloud, infra)
+- 🛡️ **Fully type-safe** with strict TypeScript
+- 🐳 **Dockerfile and docker-compose** included
+- 💎 **Strong developer experience** with testing and docs
+- ⚙️ **Zero-config defaults** that work out of the box
 
-### Interactive Mode
+---
 
-Simply run the command and follow the prompts:
+## Quick Start
 
 ```bash
-npx deploy-bbc my-project
+npx deploy-bbc my-backend
+# or
+bunx deploy-bbc my-backend
 ```
 
-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)
+## Framework Options
 
-Perfect for automated deployments:
+<p align="center">
+  <img height="36" src="https://hono.dev/images/logo.svg" alt="Hono" />
+  <img height="36" src="https://raw.githubusercontent.com/expressjs/expressjs.com/gh-pages/images/favicon.png" alt="Express" />
+  <img height="36" src="https://bun.sh/logo.svg" alt="Bun" />
+</p>
 
-```bash
-npx deploy-bbc my-project \
-  --CI \
-  --express \
-  --postgres \
-  --redis \
-  --jwt \
-  --zod \
-  --vitest \
-  --swagger \
-  --noGit
-```
+- **Hono** (default) – lightweight and edge-ready
+- **Express** – battle-tested Node.js framework
+- **Bun Native HTTP** – minimal overhead, maximum performance
 
-## 🛠️ 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**
+## Databases and Caching
 
-### Express
-```bash
-npx deploy-bbc my-app --express
-```
-- Battle-tested Node.js framework
-- Huge ecosystem
-- Familiar to most developers
+<p align="center">
+  <img height="40" src="https://www.postgresql.org/media/img/about/press/elephant.png" alt="PostgreSQL" />
+  <img height="40" src="https://www.mysql.com/common/logos/logo-mysql-170x115.png" alt="MySQL" />
+  <img height="40" src="https://www.mongodb.com/assets/images/global/favicon.ico" alt="MongoDB" />
+  <img height="40" src="https://cdn.brandfetch.io/idwlYcQpHB/theme/dark/symbol.svg?c=1bxid64Mup7aczewSAYMX&t=1668515608635" alt="Redis" />
+</p>
 
-### 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
-```
+- **PostgreSQL** with Drizzle ORM
+- **MySQL** with Drizzle ORM
+- **MongoDB** with Mongoose
+- **Redis** for caching and queues
 
-### 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
-```
+## Authentication
 
-### AI-Powered Backend
-```bash
-npx deploy-bbc ai-backend \
-  --hono \
-  --postgres \
-  --jwt \
-  --anthropic \
-  --vercelAI \
-  --aws \
-  --zod \
-  --scalar
-```
+<p align="center">
+  <img height="36" src="https://jwt.io/img/pic_logo.svg" alt="JWT" />
+  <img height="36" src="https://oauth.net/images/oauth-logo-square.png" alt="OAuth" />
+</p>
 
-## 🏗️ Project Structure
+- JWT authentication
+- OAuth 2.0 providers
+- Session-based authentication
 
-```
-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
+## AI Integrations
 
-After creating your project:
+<p align="center">
+  <img height="40" src="https://openai.com/favicon.ico" alt="OpenAI" />
+  <img height="40" src="https://www.anthropic.com/favicon.ico" alt="Anthropic" />
+  <img height="40" src="https://upload.wikimedia.org/wikipedia/commons/8/8a/Google_Gemini_logo.svg" alt="Gemini" />
+  <img height="40" src="https://vercel.com/favicon.ico" alt="Vercel" />
+</p>
 
-```bash
-# Navigate to project
-cd my-project
+- OpenAI
+- Anthropic Claude
+- Google Gemini
+- Vercel AI SDK
 
-# Copy environment variables
-cp .env.example .env
+---
 
-# Edit .env with your credentials
-nano .env
+## Cloud and Storage
 
-# Start development server
-bun run dev
+<p align="center">
+  <img height="36" src="https://a0.awsstatic.com/libra-css/images/logos/aws_logo_smile_1200x630.png" alt="AWS" />
+  <img height="36" src="https://cloud.google.com/_static/cloud/images/social-icon-google-cloud-1200-630.png" alt="GCP" />
+  <img height="36" src="https://azure.microsoft.com/svghandler/azure-logo.svg" alt="Azure" />
+  <img height="36" src="https://cdn.brandfetch.io/idJ3Cg8ymG/w/400/h/400/theme/dark/icon.jpeg?c=1bxid64Mup7aczewSAYMX&t=1668515610854" alt="Cloudflare" />
+</p>
 
-# Start with Docker
-docker-compose up -d
-bun run dev
+- **AWS** (S3, SES)
+- **Google Cloud Platform**
+- **Azure**
+- **Cloudflare R2**
 
-# Run tests
-bun test
+---
 
-# Build for production
-bun run build
-```
+## Communication and Realtime
+
+<p align="center">
+  <img height="36" src="https://cdn.brandfetch.io/id0BqaqET6/w/400/h/400/theme/dark/icon.jpeg?c=1bxid64Mup7aczewSAYMX&t=1748366671512" alt="Resend" />
+  <img height="36" src="https://sendgrid.com/favicon.ico" alt="SendGrid" />
+  <img height="36" src="https://socket.io/images/logo.svg" alt="Socket.IO" />
+</p>
+
+- Resend
+- SendGrid
+- Nodemailer
+- Socket.IO
+- Server-Sent Events (SSE)
+
+---
+
+## Developer Experience
 
-## 🔧 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 });
-  }
-);
+<p align="center">
+  <img height="36" src="https://vitest.dev/logo.svg" alt="Vitest" />
+  <img height="36" src="https://zod.dev/_next/image?url=%2Flogo%2Flogo-glow.png&w=640&q=100" alt="Zod" />
+  <img height="36" src="https://static1.smartbear.co/swagger/media/assets/images/swagger_logo.svg" alt="Swagger" />
+</p>
+
+- Vitest
+- Zod and Yup
+- Swagger / OpenAPI
+- Scalar documentation
+
+---
+
+## Project Structure
+
+```
+src/
+├── config/
+├── middleware/
+├── routes/
+├── services/
+├── db/
+├── utils/
+├── types/
+└── index.ts
 ```
 
-## 🐳 Docker Support
+---
 
-Every project includes:
-- **Dockerfile** - Optimized multi-stage build
-- **docker-compose.yml** - Services orchestration
-- Database containers (PostgreSQL, MySQL, Redis)
-- Volume persistence
-- Network configuration
+## Docker Support
 
-Start everything with:
 ```bash
-docker-compose up -d
+docker-compose up
 ```
 
-## 📚 Documentation
+Dockerfile and docker-compose are included by default.
 
-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.
+## Contributors
 
-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
+<a href="https://github.com/aritra69/deploy-bbc/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=aritra69/deploy-bbc" alt="Contributors" />
+</a>
 
-## 📄 License
+A big thank you to all the contributors who have helped make this project better! 🙏
 
-MIT © [Aritra Sarkar](https://github.com/aritra69)
+---
 
-## 🙏 Acknowledgments
+## Author
 
-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
+**Aritra Sarkar**
 
-## 🔗 Links
+- GitHub: [https://github.com/aritra69](https://github.com/aritra69)
+- Email: <aritrasarkar2002@gmail.com>
 
-- [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
+## License
 
-Give a ⭐️ if this project helped you!
+MIT License
 
 ---
 
-**Made with ❤️ by [Aritra Sarkar](https://github.com/aritra69)**
+## Support
+
+If this project helps you, consider ⭐ starring the repository.
+
+Issues, pull requests, and discussions are welcome!

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "deploy-bbc",
-    "version": "1.2.2",
+    "version": "1.2.3",
     "description": "CLI to bootstrap production-ready backends with Bun (Best Backend Code)",
     "type": "module",
     "bin": {