neon-prisma-starter 1.0.0

package/README.md

@@ -0,0 +1,80 @@
+# neon-prisma-starter
+
+> Instantly scaffold a Node.js + Prisma + Neon (serverless Postgres) project with one command.
+
+## Usage
+
+```bash
+npx neon-prisma-starter my-project
+```
+
+Or install globally:
+
+```bash
+npm install -g neon-prisma-starter
+neon-prisma-starter my-project
+```
+
+## What gets created
+
+```
+my-project/
+├── prisma/
+│   ├── schema.prisma     ← Author + Book models ready to go
+│   └── seed.js           ← Example seed data
+├── src/
+│   ├── generated/prisma/ ← auto-generated (do not touch)
+│   ├── db.js             ← Prisma client with Neon adapter
+│   └── index.js          ← Express server with CRUD routes
+├── .env                  ← your DATABASE_URL goes here
+├── .gitignore
+└── package.json
+```
+
+## After scaffolding
+
+```bash
+cd my-project
+
+# 1. Add your Neon DATABASE_URL to .env (if not provided during setup)
+
+# 2. Create tables in Neon
+npm run migrate
+
+# 3. Seed example data
+npm run seed
+
+# 4. Start the server
+npm run dev
+```
+
+## API Endpoints
+
+| Method | Route          | Description              |
+|--------|----------------|--------------------------|
+| GET    | /              | Health check             |
+| GET    | /authors       | List all authors + books |
+| POST   | /authors       | Create a new author      |
+| GET    | /authors/:id   | Get author by ID         |
+| DELETE | /authors/:id   | Delete author            |
+| GET    | /books         | List all books           |
+| POST   | /books         | Create a new book        |
+| DELETE | /books/:id     | Delete a book            |
+
+## Scripts
+
+| Command           | Description                          |
+|-------------------|--------------------------------------|
+| `npm run dev`     | Start server with nodemon            |
+| `npm run migrate` | Run Prisma migrations on Neon        |
+| `npm run seed`    | Seed database with example data      |
+| `npm run studio`  | Open Prisma Studio (visual DB UI)    |
+
+## Requirements
+
+- Node.js 18+
+- A [Neon](https://neon.tech) account (free tier works)
+
+## License
+
+MIT

package/bin/index.js

@@ -0,0 +1,403 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const fs = require('fs-extra');
+const path = require('path');
+const { execSync } = require('child_process');
+const chalk = require('chalk');
+const ora = require('ora');
+const prompts = require('prompts');
+
+const TEMPLATE_DIR = path.join(__dirname, '..', 'templates');
+
+// ─── Package JSON builder ─────────────────────────────────────────────────────
+function buildPackageJson(projectName, useTs) {
+  const base = {
+    name: projectName,
+    version: '1.0.0',
+    description: 'Node.js + Prisma + Neon project',
+    dependencies: {
+      '@prisma/adapter-neon': '^6.0.0',
+      '@prisma/client': '^6.0.0',
+      dotenv: '^16.0.0',
+      express: '^4.18.0',
+      prisma: '^6.0.0',
+    },
+  };
+
+  if (useTs) {
+    return {
+      ...base,
+      main: 'dist/index.js',
+      scripts: {
+        dev:         'ts-node src/index.ts',
+        build:       'tsc',
+        start:       'node dist/index.js',
+        migrate:     'prisma migrate dev',
+        seed:        'ts-node prisma/seed.ts',
+        studio:      'prisma studio',
+        postinstall: 'prisma generate',
+      },
+      devDependencies: {
+        '@types/express': '^4.17.0',
+        '@types/node':    '^20.0.0',
+        'ts-node':        '^10.9.0',
+        typescript:       '^5.0.0',
+      },
+    };
+  }
+
+  return {
+    ...base,
+    main: 'src/index.js',
+    scripts: {
+      dev:         'nodemon src/index.js',
+      start:       'node src/index.js',
+      migrate:     'prisma migrate dev',
+      seed:        'node prisma/seed.js',
+      studio:      'prisma studio',
+      postinstall: 'prisma generate',
+    },
+    devDependencies: {
+      nodemon: '^3.0.0',
+    },
+  };
+}
+
+// ─── tsconfig ─────────────────────────────────────────────────────────────────
+const TSCONFIG = JSON.stringify({
+  compilerOptions: {
+    target:          'ES2020',
+    module:          'commonjs',
+    lib:             ['ES2020'],
+    outDir:          './dist',
+    rootDir:         './src',
+    strict:          true,
+    esModuleInterop: true,
+    skipLibCheck:    true,
+    forceConsistentCasingInFileNames: true,
+    resolveJsonModule: true,
+  },
+  include:  ['src/**/*'],
+  exclude:  ['node_modules', 'dist'],
+}, null, 2);
+
+// ─── TypeScript templates ─────────────────────────────────────────────────────
+const TS_DB = `import 'dotenv/config';
+import { PrismaClient } from './generated/prisma';
+import { PrismaNeon } from '@prisma/adapter-neon';
+
+const adapter = new PrismaNeon({
+  connectionString: process.env.DATABASE_URL as string,
+});
+
+export const prisma = new PrismaClient({ adapter });
+`;
+
+const TS_INDEX = `import 'dotenv/config';
+import express, { Request, Response } from 'express';
+import { prisma } from './db';
+
+const app = express();
+app.use(express.json());
+
+app.get('/', (_req: Request, res: Response) => {
+  res.json({ status: 'ok', message: 'neon-prisma-starter API is running 🚀' });
+});
+
+// ─── Authors ──────────────────────────────────────────────────────────────────
+app.get('/authors', async (_req: Request, res: Response) => {
+  try {
+    const authors = await prisma.author.findMany({
+      include: { books: true },
+      orderBy: { createdAt: 'desc' },
+    });
+    res.json(authors);
+  } catch (err: any) { res.status(500).json({ error: err.message }); }
+});
+
+app.get('/authors/:id', async (req: Request, res: Response) => {
+  try {
+    const author = await prisma.author.findUnique({
+      where: { id: Number(req.params.id) },
+      include: { books: true },
+    });
+    if (!author) return res.status(404).json({ error: 'Author not found' });
+    res.json(author);
+  } catch (err: any) { res.status(500).json({ error: err.message }); }
+});
+
+app.post('/authors', async (req: Request, res: Response) => {
+  try {
+    const { name, bio }: { name: string; bio?: string } = req.body;
+    if (!name) return res.status(400).json({ error: 'name is required' });
+    const author = await prisma.author.create({ data: { name, bio } });
+    res.status(201).json(author);
+  } catch (err: any) { res.status(500).json({ error: err.message }); }
+});
+
+app.delete('/authors/:id', async (req: Request, res: Response) => {
+  try {
+    await prisma.book.deleteMany({ where: { authorId: Number(req.params.id) } });
+    await prisma.author.delete({ where: { id: Number(req.params.id) } });
+    res.json({ message: 'Author deleted' });
+  } catch (err: any) { res.status(500).json({ error: err.message }); }
+});
+
+// ─── Books ────────────────────────────────────────────────────────────────────
+app.get('/books', async (_req: Request, res: Response) => {
+  try {
+    const books = await prisma.book.findMany({
+      include: { author: true },
+      orderBy: { createdAt: 'desc' },
+    });
+    res.json(books);
+  } catch (err: any) { res.status(500).json({ error: err.message }); }
+});
+
+app.post('/books', async (req: Request, res: Response) => {
+  try {
+    const { title, genre, authorId }: { title: string; genre?: string; authorId: number } = req.body;
+    if (!title || !authorId) return res.status(400).json({ error: 'title and authorId are required' });
+    const book = await prisma.book.create({
+      data: { title, genre, authorId: Number(authorId) },
+      include: { author: true },
+    });
+    res.status(201).json(book);
+  } catch (err: any) { res.status(500).json({ error: err.message }); }
+});
+
+app.delete('/books/:id', async (req: Request, res: Response) => {
+  try {
+    await prisma.book.delete({ where: { id: Number(req.params.id) } });
+    res.json({ message: 'Book deleted' });
+  } catch (err: any) { res.status(500).json({ error: err.message }); }
+});
+
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(\`\\n🚀 Server running at http://localhost:\${PORT}\\n\`);
+});
+`;
+
+const TS_SEED = `import { prisma } from '../src/db';
+
+async function seed() {
+  console.log('🌱 Seeding database...');
+
+  await prisma.book.deleteMany();
+  await prisma.author.deleteMany();
+
+  await prisma.author.create({
+    data: {
+      name: 'J.R.R. Tolkien',
+      bio: 'Creator of Middle-earth.',
+      books: {
+        create: [
+          { title: 'The Hobbit',                genre: 'Fantasy' },
+          { title: 'The Fellowship of the Ring', genre: 'Fantasy' },
+          { title: 'The Two Towers',             genre: 'Fantasy' },
+        ],
+      },
+    },
+  });
+
+  await prisma.author.create({
+    data: {
+      name: 'George R.R. Martin',
+      bio: 'Author of A Song of Ice and Fire.',
+      books: {
+        create: [
+          { title: 'A Game of Thrones', genre: 'Fantasy' },
+          { title: 'A Clash of Kings',  genre: 'Fantasy' },
+        ],
+      },
+    },
+  });
+
+  console.log('✅ Database seeded!');
+}
+
+seed()
+  .catch((err) => { console.error('❌ Seed failed:', err); process.exit(1); })
+  .finally(() => prisma.$disconnect());
+`;
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function run(cmd, cwd) {
+  execSync(cmd, { stdio: 'inherit', cwd });
+}
+
+function writeFile(filePath, content) {
+  fs.ensureDirSync(path.dirname(filePath));
+  fs.writeFileSync(filePath, content, 'utf8');
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+  console.log('\n');
+  console.log(chalk.bgGreen.black.bold('  neon-prisma-starter  '));
+  console.log(chalk.gray('  Node.js + Prisma + Neon · Instant Project Setup\n'));
+
+  // 1. Project name
+  let projectName = process.argv[2];
+  if (!projectName) {
+    const res = await prompts({
+      type: 'text',
+      name: 'projectName',
+      message: 'Project name:',
+      initial: 'my-neon-app',
+      validate: v => v.trim().length > 0 || 'Project name cannot be empty',
+    });
+    projectName = res.projectName;
+  }
+
+  if (!projectName) {
+    console.log(chalk.red('\n✖ No project name provided. Exiting.\n'));
+    process.exit(1);
+  }
+
+  const targetDir = path.resolve(process.cwd(), projectName);
+
+  // 2. Overwrite check
+  if (fs.existsSync(targetDir)) {
+    const { overwrite } = await prompts({
+      type: 'confirm',
+      name: 'overwrite',
+      message: `Folder "${projectName}" already exists. Overwrite?`,
+      initial: false,
+    });
+    if (!overwrite) { console.log(chalk.yellow('\n⚠ Aborted.\n')); process.exit(0); }
+    fs.removeSync(targetDir);
+  }
+
+  // 3. ── Language choice ──────────────────────────────────────────────────────
+  const { language } = await prompts({
+    type: 'select',
+    name: 'language',
+    message: 'Which language do you want to use?',
+    choices: [
+      {
+        title: chalk.blue('TypeScript') + chalk.gray(' (recommended)'),
+        description: 'Full type safety, tsconfig included, ts-node dev setup',
+        value: 'ts',
+      },
+      {
+        title: chalk.green('JavaScript'),
+        description: 'Plain JS with nodemon dev setup',
+        value: 'js',
+      },
+    ],
+    initial: 0,
+  });
+
+  if (!language) { console.log(chalk.yellow('\n⚠ Aborted.\n')); process.exit(0); }
+  const useTs = language === 'ts';
+
+  // 4. DATABASE_URL
+  const { dbUrl } = await prompts({
+    type: 'text',
+    name: 'dbUrl',
+    message: 'Paste your Neon DATABASE_URL (or press Enter to fill in later):',
+    initial: '',
+  });
+
+  console.log('');
+
+  // ─── Scaffold ────────────────────────────────────────────────────────────
+  const spinner = ora(`Scaffolding ${useTs ? 'TypeScript' : 'JavaScript'} project...`).start();
+
+  try {
+    fs.ensureDirSync(targetDir);
+
+    // Shared: prisma schema
+    fs.copySync(
+      path.join(TEMPLATE_DIR, 'prisma', 'schema.prisma'),
+      path.join(targetDir, 'prisma', 'schema.prisma')
+    );
+
+    if (useTs) {
+      writeFile(path.join(targetDir, 'src', 'db.ts'),       TS_DB);
+      writeFile(path.join(targetDir, 'src', 'index.ts'),    TS_INDEX);
+      writeFile(path.join(targetDir, 'prisma', 'seed.ts'),  TS_SEED);
+      writeFile(path.join(targetDir, 'tsconfig.json'),       TSCONFIG);
+    } else {
+      fs.copySync(path.join(TEMPLATE_DIR, 'src', 'db.js'),       path.join(targetDir, 'src', 'db.js'));
+      fs.copySync(path.join(TEMPLATE_DIR, 'src', 'index.js'),    path.join(targetDir, 'src', 'index.js'));
+      fs.copySync(path.join(TEMPLATE_DIR, 'prisma', 'seed.js'),  path.join(targetDir, 'prisma', 'seed.js'));
+    }
+
+    // .env
+    const envContent = dbUrl
+      ? `DATABASE_URL="${dbUrl}"\n`
+      : `DATABASE_URL="postgresql://user:pass@ep-xxx.us-east-1.aws.neon.tech/neondb?sslmode=require"\n`;
+    writeFile(path.join(targetDir, '.env'), envContent);
+    writeFile(path.join(targetDir, '.env.example'),
+      `DATABASE_URL="postgresql://user:pass@ep-xxx.us-east-1.aws.neon.tech/neondb?sslmode=require"\n`);
+
+    // .gitignore
+    fs.copySync(path.join(TEMPLATE_DIR, '.gitignore'), path.join(targetDir, '.gitignore'));
+
+    // package.json
+    writeFile(
+      path.join(targetDir, 'package.json'),
+      JSON.stringify(buildPackageJson(projectName, useTs), null, 2)
+    );
+
+    spinner.succeed(chalk.green(`${useTs ? 'TypeScript' : 'JavaScript'} project scaffolded`));
+  } catch (err) {
+    spinner.fail('Failed to scaffold project');
+    console.error(err);
+    process.exit(1);
+  }
+
+  // ─── Install deps ─────────────────────────────────────────────────────────
+  const installSpinner = ora('Installing dependencies...').start();
+  try {
+    run('npm install', targetDir);
+    installSpinner.succeed(chalk.green('Dependencies installed'));
+  } catch {
+    installSpinner.fail('npm install failed — run it manually');
+  }
+
+  // ─── Migrate ──────────────────────────────────────────────────────────────
+  if (dbUrl) {
+    const migrateSpinner = ora('Running Prisma migration...').start();
+    try {
+      run('npx prisma migrate dev --name init', targetDir);
+      migrateSpinner.succeed(chalk.green('Database migrated'));
+    } catch {
+      migrateSpinner.warn(chalk.yellow('Migration skipped — run: npm run migrate'));
+    }
+  }
+
+  // ─── Done ─────────────────────────────────────────────────────────────────
+  const langBadge = useTs
+    ? chalk.bgBlue.white.bold(' TypeScript ')
+    : chalk.bgGreen.black.bold(' JavaScript ');
+
+  console.log('\n' + chalk.bgGreen.black.bold(' ✅  Project ready! ') + '  ' + langBadge + '\n');
+  console.log(chalk.white.bold(`  cd ${projectName}`));
+  console.log('');
+
+  if (!dbUrl) {
+    console.log(chalk.yellow('  ⚠  Add your Neon DATABASE_URL to .env, then:'));
+    console.log('');
+  }
+
+  console.log(chalk.cyan('  npm run migrate') + chalk.gray('   → create tables in Neon'));
+  console.log(chalk.cyan('  npm run seed   ') + chalk.gray('   → populate with example data'));
+  console.log(chalk.cyan('  npm run dev    ') + chalk.gray('   → start server on :3000'));
+  if (useTs) {
+    console.log(chalk.cyan('  npm run build  ') + chalk.gray('   → compile TypeScript → dist/'));
+  }
+  console.log('');
+  console.log(chalk.gray('  Endpoints: GET /authors  POST /authors  GET /books  POST /books'));
+  console.log('');
+}
+
+main().catch(err => {
+  console.error(chalk.red('\n✖ Something went wrong:\n'), err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "neon-prisma-starter",
+  "version": "1.0.0",
+  "description": "CLI to scaffold a Node.js + Prisma + Neon project instantly",
+  "main": "bin/index.js",
+  "bin": {
+    "neon-prisma-starter": "bin/index.js",
+    "create-neon-app": "bin/index.js"
+  },
+  "scripts": {
+    "test": "node bin/index.js test-project"
+  },
+  "keywords": [
+    "neon",
+    "prisma",
+    "nodejs",
+    "express",
+    "postgresql",
+    "starter",
+    "cli",
+    "scaffold"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "fs-extra": "^11.2.0",
+    "ora": "^5.4.1",
+    "prompts": "^2.4.2"
+  }
+}

package/templates/js/prisma/schema.prisma

@@ -0,0 +1,27 @@
+generator client {
+  provider        = "prisma-client-js"
+  output          = "../src/generated/prisma"
+  previewFeatures = ["driverAdapters"]
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model Author {
+  id        Int      @id @default(autoincrement())
+  name      String
+  bio       String?
+  books     Book[]
+  createdAt DateTime @default(now())
+}
+
+model Book {
+  id        Int      @id @default(autoincrement())
+  title     String
+  genre     String?
+  author    Author   @relation(fields: [authorId], references: [id])
+  authorId  Int
+  createdAt DateTime @default(now())
+}

package/templates/js/prisma/seed.js

@@ -0,0 +1,62 @@
+const { prisma } = require('../src/db');
+
+async function seed() {
+  console.log('🌱 Seeding database...');
+
+  // Clean existing data
+  await prisma.book.deleteMany();
+  await prisma.author.deleteMany();
+
+  // Seed authors with books
+  await prisma.author.create({
+    data: {
+      name: 'J.R.R. Tolkien',
+      bio: 'Creator of Middle-earth and author of The Lord of the Rings.',
+      books: {
+        create: [
+          { title: 'The Hobbit',                genre: 'Fantasy' },
+          { title: 'The Fellowship of the Ring', genre: 'Fantasy' },
+          { title: 'The Two Towers',             genre: 'Fantasy' },
+          { title: 'The Return of the King',     genre: 'Fantasy' },
+        ],
+      },
+    },
+  });
+
+  await prisma.author.create({
+    data: {
+      name: 'George R.R. Martin',
+      bio: 'Author of the epic fantasy series A Song of Ice and Fire.',
+      books: {
+        create: [
+          { title: 'A Game of Thrones',  genre: 'Fantasy' },
+          { title: 'A Clash of Kings',   genre: 'Fantasy' },
+          { title: 'A Storm of Swords',  genre: 'Fantasy' },
+        ],
+      },
+    },
+  });
+
+  await prisma.author.create({
+    data: {
+      name: 'Frank Herbert',
+      bio: 'Author of the Dune science fiction series.',
+      books: {
+        create: [
+          { title: 'Dune',               genre: 'Sci-Fi' },
+          { title: 'Dune Messiah',       genre: 'Sci-Fi' },
+          { title: 'Children of Dune',   genre: 'Sci-Fi' },
+        ],
+      },
+    },
+  });
+
+  console.log('✅ Database seeded successfully!');
+}
+
+seed()
+  .catch(err => {
+    console.error('❌ Seed failed:', err);
+    process.exit(1);
+  })
+  .finally(() => prisma.$disconnect());

package/templates/js/src/db.js

@@ -0,0 +1,11 @@
+require('dotenv').config();
+const { PrismaClient } = require('./generated/prisma');
+const { PrismaNeon } = require('@prisma/adapter-neon');
+
+const adapter = new PrismaNeon({
+  connectionString: process.env.DATABASE_URL,
+});
+
+const prisma = new PrismaClient({ adapter });
+
+module.exports = { prisma };

package/templates/js/src/index.js

@@ -0,0 +1,101 @@
+require('dotenv').config();
+const express = require('express');
+const { prisma } = require('./db');
+
+const app = express();
+app.use(express.json());
+
+// ─── Health ───────────────────────────────────────────────────────────────────
+app.get('/', (req, res) => {
+  res.json({ status: 'ok', message: 'neon-prisma-starter API is running 🚀' });
+});
+
+// ─── Authors ──────────────────────────────────────────────────────────────────
+app.get('/authors', async (req, res) => {
+  try {
+    const authors = await prisma.author.findMany({
+      include: { books: true },
+      orderBy: { createdAt: 'desc' },
+    });
+    res.json(authors);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.get('/authors/:id', async (req, res) => {
+  try {
+    const author = await prisma.author.findUnique({
+      where: { id: Number(req.params.id) },
+      include: { books: true },
+    });
+    if (!author) return res.status(404).json({ error: 'Author not found' });
+    res.json(author);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.post('/authors', async (req, res) => {
+  try {
+    const { name, bio } = req.body;
+    if (!name) return res.status(400).json({ error: 'name is required' });
+    const author = await prisma.author.create({ data: { name, bio } });
+    res.status(201).json(author);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.delete('/authors/:id', async (req, res) => {
+  try {
+    await prisma.book.deleteMany({ where: { authorId: Number(req.params.id) } });
+    await prisma.author.delete({ where: { id: Number(req.params.id) } });
+    res.json({ message: 'Author deleted' });
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+// ─── Books ────────────────────────────────────────────────────────────────────
+app.get('/books', async (req, res) => {
+  try {
+    const books = await prisma.book.findMany({
+      include: { author: true },
+      orderBy: { createdAt: 'desc' },
+    });
+    res.json(books);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.post('/books', async (req, res) => {
+  try {
+    const { title, genre, authorId } = req.body;
+    if (!title || !authorId) return res.status(400).json({ error: 'title and authorId are required' });
+    const book = await prisma.book.create({
+      data: { title, genre, authorId: Number(authorId) },
+      include: { author: true },
+    });
+    res.status(201).json(book);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.delete('/books/:id', async (req, res) => {
+  try {
+    await prisma.book.delete({ where: { id: Number(req.params.id) } });
+    res.json({ message: 'Book deleted' });
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+// ─── Start ────────────────────────────────────────────────────────────────────
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(`\n🚀 Server running at http://localhost:${PORT}`);
+  console.log(`📦 Routes: GET /authors  POST /authors  GET /books  POST /books\n`);
+});

package/templates/prisma/schema.prisma

@@ -0,0 +1,27 @@
+generator client {
+  provider        = "prisma-client-js"
+  output          = "../src/generated/prisma"
+  previewFeatures = ["driverAdapters"]
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model Author {
+  id        Int      @id @default(autoincrement())
+  name      String
+  bio       String?
+  books     Book[]
+  createdAt DateTime @default(now())
+}
+
+model Book {
+  id        Int      @id @default(autoincrement())
+  title     String
+  genre     String?
+  author    Author   @relation(fields: [authorId], references: [id])
+  authorId  Int
+  createdAt DateTime @default(now())
+}

package/templates/prisma/seed.js

@@ -0,0 +1,62 @@
+const { prisma } = require('../src/db');
+
+async function seed() {
+  console.log('🌱 Seeding database...');
+
+  // Clean existing data
+  await prisma.book.deleteMany();
+  await prisma.author.deleteMany();
+
+  // Seed authors with books
+  await prisma.author.create({
+    data: {
+      name: 'J.R.R. Tolkien',
+      bio: 'Creator of Middle-earth and author of The Lord of the Rings.',
+      books: {
+        create: [
+          { title: 'The Hobbit',                genre: 'Fantasy' },
+          { title: 'The Fellowship of the Ring', genre: 'Fantasy' },
+          { title: 'The Two Towers',             genre: 'Fantasy' },
+          { title: 'The Return of the King',     genre: 'Fantasy' },
+        ],
+      },
+    },
+  });
+
+  await prisma.author.create({
+    data: {
+      name: 'George R.R. Martin',
+      bio: 'Author of the epic fantasy series A Song of Ice and Fire.',
+      books: {
+        create: [
+          { title: 'A Game of Thrones',  genre: 'Fantasy' },
+          { title: 'A Clash of Kings',   genre: 'Fantasy' },
+          { title: 'A Storm of Swords',  genre: 'Fantasy' },
+        ],
+      },
+    },
+  });
+
+  await prisma.author.create({
+    data: {
+      name: 'Frank Herbert',
+      bio: 'Author of the Dune science fiction series.',
+      books: {
+        create: [
+          { title: 'Dune',               genre: 'Sci-Fi' },
+          { title: 'Dune Messiah',       genre: 'Sci-Fi' },
+          { title: 'Children of Dune',   genre: 'Sci-Fi' },
+        ],
+      },
+    },
+  });
+
+  console.log('✅ Database seeded successfully!');
+}
+
+seed()
+  .catch(err => {
+    console.error('❌ Seed failed:', err);
+    process.exit(1);
+  })
+  .finally(() => prisma.$disconnect());

package/templates/src/db.js

@@ -0,0 +1,11 @@
+require('dotenv').config();
+const { PrismaClient } = require('./generated/prisma');
+const { PrismaNeon } = require('@prisma/adapter-neon');
+
+const adapter = new PrismaNeon({
+  connectionString: process.env.DATABASE_URL,
+});
+
+const prisma = new PrismaClient({ adapter });
+
+module.exports = { prisma };

package/templates/src/index.js

@@ -0,0 +1,101 @@
+require('dotenv').config();
+const express = require('express');
+const { prisma } = require('./db');
+
+const app = express();
+app.use(express.json());
+
+// ─── Health ───────────────────────────────────────────────────────────────────
+app.get('/', (req, res) => {
+  res.json({ status: 'ok', message: 'neon-prisma-starter API is running 🚀' });
+});
+
+// ─── Authors ──────────────────────────────────────────────────────────────────
+app.get('/authors', async (req, res) => {
+  try {
+    const authors = await prisma.author.findMany({
+      include: { books: true },
+      orderBy: { createdAt: 'desc' },
+    });
+    res.json(authors);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.get('/authors/:id', async (req, res) => {
+  try {
+    const author = await prisma.author.findUnique({
+      where: { id: Number(req.params.id) },
+      include: { books: true },
+    });
+    if (!author) return res.status(404).json({ error: 'Author not found' });
+    res.json(author);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.post('/authors', async (req, res) => {
+  try {
+    const { name, bio } = req.body;
+    if (!name) return res.status(400).json({ error: 'name is required' });
+    const author = await prisma.author.create({ data: { name, bio } });
+    res.status(201).json(author);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.delete('/authors/:id', async (req, res) => {
+  try {
+    await prisma.book.deleteMany({ where: { authorId: Number(req.params.id) } });
+    await prisma.author.delete({ where: { id: Number(req.params.id) } });
+    res.json({ message: 'Author deleted' });
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+// ─── Books ────────────────────────────────────────────────────────────────────
+app.get('/books', async (req, res) => {
+  try {
+    const books = await prisma.book.findMany({
+      include: { author: true },
+      orderBy: { createdAt: 'desc' },
+    });
+    res.json(books);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.post('/books', async (req, res) => {
+  try {
+    const { title, genre, authorId } = req.body;
+    if (!title || !authorId) return res.status(400).json({ error: 'title and authorId are required' });
+    const book = await prisma.book.create({
+      data: { title, genre, authorId: Number(authorId) },
+      include: { author: true },
+    });
+    res.status(201).json(book);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.delete('/books/:id', async (req, res) => {
+  try {
+    await prisma.book.delete({ where: { id: Number(req.params.id) } });
+    res.json({ message: 'Book deleted' });
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
+// ─── Start ────────────────────────────────────────────────────────────────────
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(`\n🚀 Server running at http://localhost:${PORT}`);
+  console.log(`📦 Routes: GET /authors  POST /authors  GET /books  POST /books\n`);
+});

package/templates/ts/prisma/schema.prisma

@@ -0,0 +1,27 @@
+generator client {
+  provider        = "prisma-client-js"
+  output          = "../src/generated/prisma"
+  previewFeatures = ["driverAdapters"]
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model Author {
+  id        Int      @id @default(autoincrement())
+  name      String
+  bio       String?
+  books     Book[]
+  createdAt DateTime @default(now())
+}
+
+model Book {
+  id        Int      @id @default(autoincrement())
+  title     String
+  genre     String?
+  author    Author   @relation(fields: [authorId], references: [id])
+  authorId  Int
+  createdAt DateTime @default(now())
+}

package/templates/ts/prisma/seed.ts

@@ -0,0 +1,61 @@
+import { prisma } from '../src/db';
+
+async function seed(): Promise<void> {
+  console.log('🌱 Seeding database...');
+
+  // Clean existing data
+  await prisma.book.deleteMany();
+  await prisma.author.deleteMany();
+
+  await prisma.author.create({
+    data: {
+      name: 'J.R.R. Tolkien',
+      bio: 'Creator of Middle-earth and author of The Lord of the Rings.',
+      books: {
+        create: [
+          { title: 'The Hobbit',                 genre: 'Fantasy' },
+          { title: 'The Fellowship of the Ring',  genre: 'Fantasy' },
+          { title: 'The Two Towers',              genre: 'Fantasy' },
+          { title: 'The Return of the King',      genre: 'Fantasy' },
+        ],
+      },
+    },
+  });
+
+  await prisma.author.create({
+    data: {
+      name: 'George R.R. Martin',
+      bio: 'Author of the epic fantasy series A Song of Ice and Fire.',
+      books: {
+        create: [
+          { title: 'A Game of Thrones', genre: 'Fantasy' },
+          { title: 'A Clash of Kings',  genre: 'Fantasy' },
+          { title: 'A Storm of Swords', genre: 'Fantasy' },
+        ],
+      },
+    },
+  });
+
+  await prisma.author.create({
+    data: {
+      name: 'Frank Herbert',
+      bio: 'Author of the Dune science fiction series.',
+      books: {
+        create: [
+          { title: 'Dune',             genre: 'Sci-Fi' },
+          { title: 'Dune Messiah',     genre: 'Sci-Fi' },
+          { title: 'Children of Dune', genre: 'Sci-Fi' },
+        ],
+      },
+    },
+  });
+
+  console.log('✅ Database seeded successfully!');
+}
+
+seed()
+  .catch((err: Error) => {
+    console.error('❌ Seed failed:', err);
+    process.exit(1);
+  })
+  .finally(() => prisma.$disconnect());

package/templates/ts/src/db.ts

@@ -0,0 +1,9 @@
+import 'dotenv/config';
+import { PrismaClient } from './generated/prisma';
+import { PrismaNeon } from '@prisma/adapter-neon';
+
+const adapter = new PrismaNeon({
+  connectionString: process.env.DATABASE_URL as string,
+});
+
+export const prisma = new PrismaClient({ adapter });

package/templates/ts/src/index.ts

@@ -0,0 +1,101 @@
+import 'dotenv/config';
+import express, { Request, Response } from 'express';
+import { prisma } from './db';
+
+const app = express();
+app.use(express.json());
+
+// ─── Health ───────────────────────────────────────────────────────────────────
+app.get('/', (_req: Request, res: Response) => {
+  res.json({ status: 'ok', message: 'neon-prisma-starter API is running 🚀' });
+});
+
+// ─── Authors ──────────────────────────────────────────────────────────────────
+app.get('/authors', async (_req: Request, res: Response) => {
+  try {
+    const authors = await prisma.author.findMany({
+      include: { books: true },
+      orderBy: { createdAt: 'desc' },
+    });
+    res.json(authors);
+  } catch (err) {
+    res.status(500).json({ error: (err as Error).message });
+  }
+});
+
+app.get('/authors/:id', async (req: Request, res: Response) => {
+  try {
+    const author = await prisma.author.findUnique({
+      where: { id: Number(req.params.id) },
+      include: { books: true },
+    });
+    if (!author) return res.status(404).json({ error: 'Author not found' });
+    res.json(author);
+  } catch (err) {
+    res.status(500).json({ error: (err as Error).message });
+  }
+});
+
+app.post('/authors', async (req: Request, res: Response) => {
+  try {
+    const { name, bio }: { name: string; bio?: string } = req.body;
+    if (!name) return res.status(400).json({ error: 'name is required' });
+    const author = await prisma.author.create({ data: { name, bio } });
+    res.status(201).json(author);
+  } catch (err) {
+    res.status(500).json({ error: (err as Error).message });
+  }
+});
+
+app.delete('/authors/:id', async (req: Request, res: Response) => {
+  try {
+    await prisma.book.deleteMany({ where: { authorId: Number(req.params.id) } });
+    await prisma.author.delete({ where: { id: Number(req.params.id) } });
+    res.json({ message: 'Author deleted' });
+  } catch (err) {
+    res.status(500).json({ error: (err as Error).message });
+  }
+});
+
+// ─── Books ────────────────────────────────────────────────────────────────────
+app.get('/books', async (_req: Request, res: Response) => {
+  try {
+    const books = await prisma.book.findMany({
+      include: { author: true },
+      orderBy: { createdAt: 'desc' },
+    });
+    res.json(books);
+  } catch (err) {
+    res.status(500).json({ error: (err as Error).message });
+  }
+});
+
+app.post('/books', async (req: Request, res: Response) => {
+  try {
+    const { title, genre, authorId }: { title: string; genre?: string; authorId: number } = req.body;
+    if (!title || !authorId) return res.status(400).json({ error: 'title and authorId are required' });
+    const book = await prisma.book.create({
+      data: { title, genre, authorId: Number(authorId) },
+      include: { author: true },
+    });
+    res.status(201).json(book);
+  } catch (err) {
+    res.status(500).json({ error: (err as Error).message });
+  }
+});
+
+app.delete('/books/:id', async (req: Request, res: Response) => {
+  try {
+    await prisma.book.delete({ where: { id: Number(req.params.id) } });
+    res.json({ message: 'Book deleted' });
+  } catch (err) {
+    res.status(500).json({ error: (err as Error).message });
+  }
+});
+
+// ─── Start ────────────────────────────────────────────────────────────────────
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(`\n🚀 Server running at http://localhost:${PORT}`);
+  console.log(`📦 Routes: GET /authors  POST /authors  GET /books  POST /books\n`);
+});

package/templates/ts/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "src/generated"]
+}