simpledi-app-generator

CLI tool to generate simple-di projects with a complete backend architecture.

Installation

npm install -g @kanian77/simple-di-app-generator

Or link locally for development:

git clone <repo>
cd simpledi-app-generator
bun install
bun run prepare
npm link

Commands

| Command | Description | | ---------------------------------------- | ------------------------------------- | | simpledi new <name> | Create a new simple-di project | | simpledi module <entity> | Generate a module with CRUD use cases | | simpledi use-case <name> [imports=...] | Generate a use case with routes |

Quick Start

# Create project
simpledi new my-app
cd my-app
bun install

# Add your DATABASE_URL to .env.development
# Generate entities (includes CRUD use cases!)
simpledi module user
simpledi module blog-post

# Generate custom use cases
simpledi use-case get-dashboard-stats imports=user,blog-post
simpledi use-case publish-post imports=blog-post

# Run
bun run dev

Documentation

See user-guide.md for complete documentation.

Project Structure

Generated projects follow this structure:

my-project/
├── main.ts              # Entry point
├── config/              # Configuration module
├── db/                  # Database service module
└── src/
    ├── AppModule.ts     # Root module
    ├── schema.ts        # Drizzle schema exports
    ├── main.routes.ts   # Auto-discovers *Routes.{ts,js} files via Bun glob
    ├── core/            # Entity modules (generated)
    ├── lib/             # Utilities, types, errors
    └── use-case/        # Use case modules

Prerequisites

Neon PostgreSQL

Generated projects use Neon serverless PostgreSQL. Add your connection string to .env.development:

CONNECTION_STRING=postgres://user:[email protected]/dbname?sslmode=require

Environment Variables

| Variable | Description | | ------------------- | --------------------------------- | | CONNECTION_STRING | Neon PostgreSQL connection string | | JWT_SECRET | Secret key for JWT tokens | | PORT | Server port (default: 3000) |

Tech Stack

• Runtime: Bun
• Framework: Hono
• DI: @kanian77/simple-di
• ORM: Drizzle
• Database: Neon PostgreSQL
• Validation: Zod

License

MIT