create-prisma 0.4.2-next.37.92.1 → 0.4.2-next.37.93.1

package/README.md

@@ -10,7 +10,7 @@ Scaffold a new app with Prisma Next already wired up.
 - adds Prisma Next dependencies for PostgreSQL or MongoDB
 - runs `prisma-next init --no-install` to scaffold `prisma/contract.*`, `prisma-next.config.ts`, `prisma/db.ts`, `prisma-next.md`, `.env.example`, and the Prisma Next agent skill
 - writes a template-specific Prisma Next runtime helper
-- adds `contract:emit`, `db:init`, `db:update`, `db:verify`, `db:seed`, `migration:plan`, `migration:apply`, `migration:status`, and `migration:show` scripts
+- adds `contract:emit`, `db:init`, `db:update`, `db:verify`, `db:seed`, `migration:plan`, `migrate`, `migration:status`, and `migration:show` scripts
 - adds `db:up` / `db:down` and `docker-compose.yml` for default MongoDB projects
 - creates or updates `.env` with `DATABASE_URL`
 - can install dependencies and run `prisma-next contract emit`
@@ -57,6 +57,12 @@ Create a project interactively:
 create-prisma
 ```
 
+Create a Minimal project non-interactively:
+
+```bash
+create-prisma --name my-script --template minimal --provider postgres
+```
+
 Create a Hono app non-interactively:
 
 ```bash
@@ -89,14 +95,15 @@ create-prisma --name my-app --template nest --provider postgres --prisma-postgre
 
 ## Supported Templates
 
-- `hono`
-- `elysia`
-- `nest`
-- `next`
-- `svelte`
-- `astro`
-- `nuxt`
-- `tanstack-start`
+- `minimal` - script-first Prisma Next starter with no web framework
+- `hono` - lightweight TypeScript API server
+- `elysia` - Bun-friendly TypeScript API server
+- `nest` - structured Node API with controllers and services
+- `next` - full-stack React app with App Router
+- `svelte` - full-stack Svelte 5 app with Vite
+- `astro` - content-oriented web app with server routes
+- `nuxt` - full-stack Vue app with Nitro server routes
+- `tanstack-start` - React app with file routes and server functions
 
 ## Supported Databases
 

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import "./create-B0eFGNQ2.mjs";
+import "./create-DGDCo1EV.mjs";
 import { createCreatePrismaCli } from "./index.mjs";
 
 //#region src/cli.ts

package/dist/{create-B0eFGNQ2.mjs → create-DGDCo1EV.mjs}

@@ -49,7 +49,7 @@ async function getAnonymousId() {
 }
 function getCommonProperties() {
 	return {
-		"cli-version": "0.4.2-next.37.92.1",
+		"cli-version": "0.4.2-next.37.93.1",
 		"node-version": process.version,
 		platform: process.platform,
 		arch: process.arch
@@ -176,7 +176,7 @@ function getCreateTemplateDependencies(template, packageManager) {
 		dependencies: [],
 		devDependencies: ["@prisma-next/vite-plugin-contract-emit"]
 	});
-	if (template === "hono" || template === "elysia" || template === "nest") {
+	if (template === "minimal" || template === "hono" || template === "elysia" || template === "nest") {
 		const runtimeDevDependencies = usesNodeStyleRuntime(packageManager) ? ["tsx"] : [];
 		if (template === "elysia" && packageManager !== "deno") targets.push({
 			packageJsonPath: "package.json",
@@ -209,6 +209,7 @@ const packageManagers = [
 ];
 const authoringStyles = ["psl", "typescript"];
 const createTemplates = [
+	"minimal",
 	"hono",
 	"elysia",
 	"nest",
@@ -1507,7 +1508,7 @@ function getCreatePrismaIntro() {
 //#endregion
 //#region src/commands/create.ts
 const DEFAULT_PROJECT_NAME = "my-app";
-const DEFAULT_TEMPLATE = "hono";
+const DEFAULT_TEMPLATE = "minimal";
 function toPackageName(projectName) {
 	return projectName.toLowerCase().replace(/[^a-z0-9._-]/g, "-").replace(/^-+/, "").replace(/-+$/, "") || "app";
 }
@@ -1538,45 +1539,50 @@ async function promptForCreateTemplate() {
 		message: "Select template",
 		initialValue: DEFAULT_TEMPLATE,
 		options: [
+			{
+				value: "minimal",
+				label: "Minimal",
+				hint: "Script-first Prisma Next starter with no web framework"
+			},
 			{
 				value: "hono",
 				label: "Hono",
-				hint: "Default TypeScript API starter"
+				hint: "Lightweight TypeScript API server"
 			},
 			{
 				value: "elysia",
 				label: "Elysia",
-				hint: "TypeScript API starter with Elysia's Node adapter"
+				hint: "Bun-friendly TypeScript API server"
 			},
 			{
 				value: "nest",
 				label: "NestJS",
-				hint: "Official Nest-style API starter with a Prisma service"
+				hint: "Structured Node API with controllers and services"
 			},
 			{
 				value: "next",
 				label: "Next.js",
-				hint: "App Router + TypeScript starter"
+				hint: "Full-stack React app with App Router"
 			},
 			{
 				value: "svelte",
 				label: "SvelteKit",
-				hint: "Official minimal SvelteKit + TypeScript starter"
+				hint: "Full-stack Svelte 5 app with Vite"
 			},
 			{
 				value: "astro",
 				label: "Astro",
-				hint: "Official minimal Astro starter with API route example"
+				hint: "Content-oriented web app with server routes"
 			},
 			{
 				value: "nuxt",
 				label: "Nuxt",
-				hint: "Official minimal Nuxt starter with Nitro API route example"
+				hint: "Full-stack Vue app with Nitro server routes"
 			},
 			{
 				value: "tanstack-start",
 				label: "TanStack Start",
-				hint: "TanStack Start React app with file routes and server functions"
+				hint: "React app with file routes and server functions"
 			}
 		]
 	});

package/dist/index.d.mts

@@ -195,6 +195,7 @@ declare const AuthoringStyleSchema: z.ZodEnum<{
   typescript: "typescript";
 }>;
 declare const CreateTemplateSchema: z.ZodEnum<{
+  minimal: "minimal";
   hono: "hono";
   elysia: "elysia";
   nest: "nest";
@@ -231,6 +232,7 @@ declare const CreateCommandInputSchema: z.ZodObject<{
   emit: z.ZodOptional<z.ZodBoolean>;
   name: z.ZodOptional<z.ZodString>;
   template: z.ZodOptional<z.ZodEnum<{
+    minimal: "minimal";
     hono: "hono";
     elysia: "elysia";
     nest: "nest";
@@ -272,6 +274,7 @@ declare const router: {
     emit: zod.ZodOptional<zod.ZodBoolean>;
     name: zod.ZodOptional<zod.ZodString>;
     template: zod.ZodOptional<zod.ZodEnum<{
+      minimal: "minimal";
       hono: "hono";
       elysia: "elysia";
       nest: "nest";

package/dist/index.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { a as DatabaseProviderSchema, i as CreateTemplateSchema, n as AuthoringStyleSchema, o as DatabaseUrlSchema, r as CreateCommandInputSchema, s as PackageManagerSchema, t as runCreateCommand } from "./create-B0eFGNQ2.mjs";
+import { a as DatabaseProviderSchema, i as CreateTemplateSchema, n as AuthoringStyleSchema, o as DatabaseUrlSchema, r as CreateCommandInputSchema, s as PackageManagerSchema, t as runCreateCommand } from "./create-DGDCo1EV.mjs";
 import { os } from "@orpc/server";
 import { createCli } from "trpc-cli";
 
 //#region src/index.ts
-const CLI_VERSION = "0.4.2-next.37.92.1";
+const CLI_VERSION = "0.4.2-next.37.93.1";
 const router = os.router({ create: os.meta({
 	description: "Create a new project with Prisma setup",
 	default: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-prisma",
-  "version": "0.4.2-next.37.92.1",
+  "version": "0.4.2-next.37.93.1",
   "private": false,
   "description": "Create Prisma Next projects with first-party templates and great DX.",
   "homepage": "https://github.com/prisma/create-prisma",

package/templates/create/minimal/.yarnrc.yml.hbs

@@ -0,0 +1,3 @@
+{{#if (eq packageManager "yarn")}}
+nodeLinker: node-modules
+{{/if}}

package/templates/create/minimal/README.md.hbs

@@ -0,0 +1,38 @@
+# {{projectName}}
+
+Generated by `create-prisma` with the Minimal template.
+
+## Scripts
+
+- `{{runScriptCommand packageManager "dev"}}` - run the Prisma Next sample script
+
+## Prisma Next
+
+Prisma Next setup is scaffolded in:
+
+- `prisma/contract{{#if (eq authoring "typescript")}}.ts{{else}}.prisma{{/if}}`
+- `prisma-next.config.ts`
+- `prisma/db.ts`
+- `src/lib/prisma.ts`
+
+Database helper scripts are added to `package.json`:
+
+- `{{runScriptCommand packageManager "contract:emit"}}` - emit contract artifacts after contract changes
+{{#if (eq provider "mongo")}}
+- `{{runScriptCommand packageManager "db:up"}}` - start the local MongoDB replica set
+- `{{runScriptCommand packageManager "db:down"}}` - stop the local MongoDB replica set
+- `{{runScriptCommand packageManager "migration:plan"}}` - create a MongoDB migration plan
+- `{{runScriptCommand packageManager "migrate"}}` - apply the planned MongoDB migration
+{{else}}
+- `{{runScriptCommand packageManager "db:init"}}` - initialize database state manually
+- `{{runScriptCommand packageManager "db:update"}}` - update database state manually
+- `{{runScriptCommand packageManager "migration:plan"}}` - create a migration plan
+- `{{runScriptCommand packageManager "migrate"}}` - apply a planned migration
+{{/if}}
+- `{{runScriptCommand packageManager "db:seed"}}` - insert sample users manually
+
+For provider-specific Prisma Next reference docs, see `prisma-next.md`. Agent-specific project guidance starts in `.agents/skills/prisma-next/SKILL.md`.
+
+Node-based Prisma Next projects expect Node.js 24 LTS or newer.
+
+Run the migration and seed scripts first, then `{{runScriptCommand packageManager "dev"}}` runs a small write/read round trip from `src/index.ts`.

package/templates/create/minimal/deno.json.hbs

@@ -0,0 +1,5 @@
+{{#if (eq packageManager "deno")}}
+{
+  "nodeModulesDir": "manual"
+}
+{{/if}}

package/templates/create/minimal/package.json.hbs

@@ -0,0 +1,13 @@
+{
+  "name": "{{projectName}}",
+  "private": true,
+  {{#if (packageManagerManifestValue packageManager)}}
+  "packageManager": "{{packageManagerManifestValue packageManager}}",
+  {{/if}}
+  "type": "module",
+  "scripts": {
+    "dev": "{{runtimeScript packageManager "start" "src/index.ts" ""}}"
+  },
+  "dependencies": {},
+  "devDependencies": {}
+}

package/templates/create/minimal/src/index.ts.hbs

@@ -0,0 +1,42 @@
+import { db, listUsers } from "./lib/prisma{{#if (eq packageManager "deno")}}.ts{{/if}}";
+
+const sampleUser = {
+  email: "first.user@prisma.io",
+  name: "First User",
+};
+
+async function main() {
+{{#if (eq provider "mongo")}}
+  const existingUser = await db.orm.users.where({ email: sampleUser.email }).first();
+  if (!existingUser) {
+    await db.orm.users.createCount([sampleUser]);
+  }
+
+  const user = await db.orm.users.where({ email: sampleUser.email }).first();
+{{else}}
+  const existingUser = await db.orm.User.where({ email: sampleUser.email }).first();
+  if (!existingUser) {
+    await db.orm.User.createCount([sampleUser]);
+  }
+
+  const user = await db.orm.User.where({ email: sampleUser.email }).first();
+{{/if}}
+  const users = await listUsers();
+
+  console.log(`Prisma Next is ready. Found ${users.length} user${users.length === 1 ? "" : "s"}.`);
+  console.log(user);
+}
+
+try {
+  await main();
+} catch (error) {
+  console.error("Prisma Next query failed.");
+  console.error("Emit the contract, set DATABASE_URL, then apply migrations before running this script.");
+  throw error;
+} finally {
+{{#if (eq provider "mongo")}}
+  await db.close();
+{{else}}
+  await db.runtime().close();
+{{/if}}
+}

package/templates/create/minimal/src/lib/prisma.ts.hbs

@@ -0,0 +1,71 @@
+import "dotenv/config";
+{{#if (eq provider "mongo")}}
+import mongo from "@prisma-next/mongo/runtime";
+{{else}}
+import postgres from "@prisma-next/postgres/runtime";
+{{/if}}
+
+{{#if (eq provider "mongo")}}
+import type { DefaultModelRow } from "@prisma-next/mongo-orm";
+{{else}}
+import type { DefaultModelRow } from "@prisma-next/sql-orm-client";
+{{/if}}
+
+import type { Contract } from "../../prisma/contract.d";
+import contractJson from "../../prisma/contract.json" with { type: "json" };
+
+{{#if (eq provider "mongo")}}
+export const db = mongo<Contract>({
+  contractJson,
+  url: process.env["DATABASE_URL"],
+});
+{{else}}
+export const db = postgres<Contract>({
+  contractJson,
+  url: process.env["DATABASE_URL"],
+});
+{{/if}}
+
+type UserRow = DefaultModelRow<Contract, "User">;
+
+{{#if (eq provider "mongo")}}
+function toStarterUser(user: Pick<UserRow, "_id" | "email" | "name">) {
+  return {
+    id: String(user._id),
+    email: user.email,
+    name: user.name ?? null,
+    createdAt: null as Date | null,
+  };
+}
+{{else}}
+function toStarterUser(user: Pick<UserRow, "id" | "email" | "name" | "createdAt">) {
+  return {
+    id: String(user.id),
+    email: user.email,
+    name: user.name ?? null,
+    createdAt: user.createdAt,
+  };
+}
+{{/if}}
+
+export async function listUsers(limit = 10) {
+
+{{#if (eq provider "mongo")}}
+  const users: ReturnType<typeof toStarterUser>[] = [];
+
+  for await (const user of db.orm.users.select("_id", "email", "name").take(limit).all()) {
+    users.push(toStarterUser(user));
+  }
+
+  return users;
+{{else}}
+  const users = await db.orm.User.select("id", "email", "name", "createdAt").take(limit).all();
+
+  return users.map(toStarterUser);
+{{/if}}
+
+}
+
+export type StarterUser = Awaited<ReturnType<typeof listUsers>>[number];
+
+export default db;

package/templates/create/minimal/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "resolveJsonModule": true,
+    "verbatimModuleSyntax": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*.ts", "prisma/**/*.ts"]
+}