📦 PrismaGen CLI

PrismaGen is a flexible CLI tool that auto-generates a scalable API structure from your schema.prisma file.

Supports:

• ✅ NestJS (TypeScript)
  • REST API
  • GraphQL API
• ✅ Express (TypeScript or JavaScript)
• ✅ GraphQL (TypeScript or JavaScript)
• ✅ TypeScript API Client via Swagger/OpenAPI

🚀 Installation

npm install -g prisma-model-cli

install locally:

npm install prisma-model-cli

🔧 Usage

prismagen

You can also use flags to skip the interactive dialog:

▶️ CLI Options

NestJS Options

| Command | Description | | ----------------------------------------- | ---------------------------------------------------------- | | prismagen --nestjs | Generate NestJS REST API structure (TypeScript) | | prismagen --nestjs --no-swagger | Generate NestJS REST API without Swagger setup | | prismagen --nestjs --graphql | Generate NestJS GraphQL API structure (TypeScript) | | prismagen --nestjs --graphql --no-swagger | Generate NestJS GraphQL API without Swagger setup |

Express Options

| Command | Description | | --------------------------------- | ---------------------------------------------------------- | | prismagen --express | Generate Express API structure (TypeScript) | | prismagen --express --output-js | Generate Express API structure (JavaScript) |

GraphQL Options

| Command | Description | | --------------------------------- | ---------------------------------------------------------- | | prismagen --graphql | Generate GraphQL API structure (TypeScript) | | prismagen --graphql --output-js | Generate GraphQL API structure (JavaScript) |

Swagger/OpenAPI Options

| Command | Description | | --------------------------------- | ---------------------------------------------------------- | | prismagen generate swagger | Generate NestJS REST + Swagger UI TypeScript client | | prismagen generate swagger --graphql | Generate NestJS GraphQL + Swagger UI TypeScript client |

General Options

| Command | Description | | --------------------------------- | ---------------------------------------------------------- | | prismagen --help or -h | Show CLI help | | prismagen --version or -v | Show installed version |

📁 Output Structure

NestJS REST API Structure

models/
  └── user/
      ├── user.controller.ts
      ├── user.service.ts
      ├── dto/
      │   ├── create-user.dto.ts
      │   └── update-user.dto.ts

NestJS GraphQL API Structure

models/
  └── user/
      ├── user.resolver.ts
      ├── user.service.ts
      ├── dto/
      │   ├── create-user.input.ts
      │   └── update-user.input.ts
      └── user.types.ts

Express API Structure

models/
  └── user/
      ├── user.controller.ts
      ├── user.service.ts
      └── routes/
          └── user.routes.ts

GraphQL API Structure

models/
  └── user/
      ├── user.resolver.ts
      ├── user.service.ts
      ├── user.types.ts
      └── user.inputs.ts

🧬 Generate Swagger TypeScript Client

To generate a TypeScript SDK using openapi-generator-cli from your running NestJS Swagger endpoint:

prismagen generate swagger

For GraphQL API:

prismagen generate swagger --graphql

You'll be prompted to:

1. Enter the Swagger JSON URL (defaults to http://localhost:3000/api-json)
2. Choose the output directory (defaults to ../client/src/app/api)

The CLI will:

• Run NestJS model generation via run.ts
• Validate the Swagger endpoint is reachable
• Generate a TypeScript Axios client via OpenAPI Generator

⚙️ Prerequisites

Ensure your project has:

• Prisma installed and set up:

  npm install prisma @prisma/client
  npx prisma init

• A valid schema.prisma in /prisma/schema.prisma

Run:

npx prisma generate

🧠 How It Works

1. Parses all models from your Prisma schema.
2. Generates base CRUD logic (BaseController, GenericPrismaService).
3. Outputs language-specific files based on the selected mode.
4. Optionally, generates a Swagger client using openapi-generator-cli.

🛠 Dev Setup (if modifying CLI)

1. Clone this repo

2. Build the CLI:

   npm install
   npm run build

3. Link it globally to use prismagen from anywhere:

   npm link

🧩 Future Features

• Support for custom middleware
• Soft deletes
• Swagger docs out of the box
• Authentication scaffolding (JWT, session-based)

📬 Issues / Contributions

Open issues or PRs on GitHub

We welcome contributions!