create-prisma 0.4.1 → 0.4.2-next.37.80.1

package/templates/create/next/prisma/contract.ts.hbs

@@ -0,0 +1,85 @@
+{{#if (eq authoring "typescript")}}
+{{#if (eq provider "mongo")}}
+import mongoFamily from "@prisma-next/family-mongo/pack";
+import { defineContract } from "@prisma-next/mongo-contract-ts/contract-builder";
+import mongoTarget from "@prisma-next/target-mongo/pack";
+
+export const contract = defineContract(
+  { family: mongoFamily, target: mongoTarget },
+  ({ field, index, model, rel }) => ({
+    models: {
+{{#if (eq schemaPreset "basic")}}
+      User: model("User", {
+        collection: "users",
+        fields: {
+          _id: field.objectId(),
+          email: field.string(),
+          name: field.string().optional(),
+        },
+        indexes: [
+          index({ email: 1 }, { unique: true }),
+        ],
+        relations: {
+          posts: rel.hasMany("Post", { from: "_id", to: "authorId" }),
+        },
+      }),
+
+      Post: model("Post", {
+        collection: "posts",
+        fields: {
+          _id: field.objectId(),
+          title: field.string(),
+          content: field.string().optional(),
+          authorId: field.objectId(),
+        },
+        indexes: [
+          index({ authorId: 1 }),
+        ],
+        relations: {
+          author: rel.belongsTo("User", { from: "authorId", to: "_id" }),
+        },
+      }),
+{{/if}}
+    },
+  }),
+);
+{{else}}
+import sqlFamily from "@prisma-next/family-sql/pack";
+import { defineContract } from "@prisma-next/sql-contract-ts/contract-builder";
+import postgresPack from "@prisma-next/target-postgres/pack";
+
+export const contract = defineContract(
+  { family: sqlFamily, target: postgresPack },
+  ({ field, model, rel }) => ({
+    models: {
+{{#if (eq schemaPreset "basic")}}
+      User: model("User", {
+        fields: {
+          id: field.id.uuidv7(),
+          email: field.text().unique(),
+          name: field.text().optional(),
+          createdAt: field.createdAt(),
+        },
+        relations: {
+          posts: rel.hasMany("Post", { by: "authorId" }),
+        },
+      }),
+
+      Post: model("Post", {
+        fields: {
+          id: field.id.uuidv7(),
+          title: field.text(),
+          content: field.text().optional(),
+          authorId: field.uuid(),
+          createdAt: field.createdAt(),
+        },
+        relations: {
+          author: rel.belongsTo("User", { from: "authorId", to: "id" }),
+        },
+      }),
+{{/if}}
+    },
+  }),
+);
+{{/if}}
+{{/if}}

package/templates/create/next/prisma-next.config.ts.hbs

@@ -0,0 +1,13 @@
+import "dotenv/config";
+{{#if (eq provider "mongo")}}
+import { defineConfig } from "@prisma-next/mongo/config";
+{{else}}
+import { defineConfig } from "@prisma-next/postgres/config";
+{{/if}}
+
+export default defineConfig({
+  contract: "./prisma/contract{{#if (eq authoring "typescript")}}.ts{{else}}.prisma{{/if}}",
+  db: {
+    connection: process.env["DATABASE_URL"],
+  },
+});

package/templates/create/next/src/app/page.tsx.hbs

@@ -1,6 +1,3 @@
-{{#if (eq schemaPreset "basic")}}
-import { prisma } from "../lib/prisma";
-{{/if}}
 {{#if (eq packageManager "deno")}}
 
 export const dynamic = "force-dynamic";
@@ -8,28 +5,22 @@ export const dynamic = "force-dynamic";
 
 export default async function Home() {
 {{#if (eq schemaPreset "basic")}}
+  const { listUsers } = await import("../lib/prisma");
   const formatter = new Intl.DateTimeFormat("en", {
     dateStyle: "medium",
     timeStyle: "short",
   });
-  const users = await prisma.user
-    .findMany({
-      take: 10,
-      orderBy: {
-        createdAt: "desc",
-      },
-    })
-    .catch(() => undefined);
+  const users = await listUsers(10).catch(() => undefined);
 {{/if}}
 
   return (
     <main className="shell">
       <div className="hero">
-        <p className="eyebrow">Next.js + Prisma 7</p>
+        <p className="eyebrow">Next.js + Prisma Next</p>
 {{#if (eq schemaPreset "basic")}}
         <h1>Users from your database, loaded on the server.</h1>
         <p className="lede">
-          This page reads from <code>src/app/page.tsx</code> using the Prisma instance in{" "}
+          This page reads from <code>src/app/page.tsx</code> using the Prisma Next helper in{" "}
           <code>src/lib/prisma.ts</code>.
         </p>
       </div>
@@ -42,11 +33,11 @@ export default async function Home() {
 
         {!users ? (
           <p className="empty">
-            Could not query users yet. Run <code>db:migrate</code>, then <code>db:seed</code>,
+            Could not query users yet. Run <code>contract:emit</code> and apply your schema,
             then refresh.
           </p>
         ) : users.length === 0 ? (
-          <p className="empty">No users yet. Run <code>db:seed</code> after your first migration.</p>
+          <p className="empty">No users yet. Run db:seed after applying your first migration.</p>
         ) : (
           <ul className="users">
             {users.map((user) => (
@@ -55,9 +46,13 @@ export default async function Home() {
                   <strong>{user.name ?? "Unnamed user"}</strong>
                   <p>{user.email}</p>
                 </div>
-                <time dateTime={user.createdAt.toISOString()}>
-                  {formatter.format(user.createdAt)}
-                </time>
+                {user.createdAt ? (
+                  <time dateTime={user.createdAt.toISOString()}>
+                    {formatter.format(user.createdAt)}
+                  </time>
+                ) : (
+                  <span className="empty">No timestamp</span>
+                )}
               </li>
             ))}
           </ul>
@@ -66,8 +61,8 @@ export default async function Home() {
 {{else}}
         <h1>Your Next.js app is ready.</h1>
         <p className="lede">
-          Edit <code>prisma/schema.prisma</code>, run <code>db:migrate</code>, then load your data
-          in server components with the Prisma instance in <code>src/lib/prisma.ts</code>.
+          Edit your Prisma Next contract, run <code>contract:emit</code>, then load your data
+          in server components with the helper in <code>src/lib/prisma.ts</code>.
         </p>
       </div>
 
@@ -80,20 +75,20 @@ export default async function Home() {
         <ul className="users">
           <li>
             <div>
-              <strong>Prisma client</strong>
-              <p>Use the shared instance from <code>src/lib/prisma.ts</code>.</p>
+              <strong>Prisma Next runtime</strong>
+              <p>Use the shared helper from <code>src/lib/prisma.ts</code>.</p>
             </div>
           </li>
           <li>
             <div>
-              <strong>Seed script</strong>
-              <p>Run <code>db:seed</code> after your first migration.</p>
+              <strong>Manual database setup</strong>
+              <p>Run the schema setup commands when you are ready.</p>
             </div>
           </li>
           <li>
             <div>
-              <strong>Generated client output</strong>
-              <p>Prisma Client is generated into <code>src/generated/prisma</code>.</p>
+              <strong>Contract output</strong>
+              <p>Prisma Next emits contract artifacts next to your contract file.</p>
             </div>
           </li>
         </ul>

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

@@ -1,53 +1,59 @@
 import "dotenv/config";
-import { PrismaClient } from "../generated/prisma/client";
-{{#if (eq provider "postgresql")}}
-import { PrismaPg } from "@prisma/adapter-pg";
-{{/if}}
-{{#if (eq provider "cockroachdb")}}
-import { PrismaPg } from "@prisma/adapter-pg";
-{{/if}}
-{{#if (eq provider "mysql")}}
-import { PrismaMariaDb } from "@prisma/adapter-mariadb";
-{{/if}}
-{{#if (eq provider "sqlite")}}
-import { PrismaBetterSqlite3 } from "@prisma/adapter-better-sqlite3";
-{{/if}}
-{{#if (eq provider "sqlserver")}}
-import { PrismaMssql } from "@prisma/adapter-mssql";
-{{/if}}
-
-{{#if (eq provider "sqlite")}}
-const databaseUrl = process.env.DATABASE_URL ?? "file:./dev.db";
+{{#if (eq provider "mongo")}}
+import mongo from "@prisma-next/mongo/runtime";
 {{else}}
-const databaseUrl = process.env.DATABASE_URL;
-if (!databaseUrl) {
-  throw new Error("DATABASE_URL is required");
-}
+import postgres from "@prisma-next/postgres/runtime";
 {{/if}}
+import type { Contract } from "../../prisma/contract.d";
+import contractJson from "../../prisma/contract.json" with { type: "json" };
 
-{{#if (eq provider "postgresql")}}
-const adapter = new PrismaPg({
-  connectionString: databaseUrl,
+{{#if (eq provider "mongo")}}
+export const db = mongo<Contract>({
+  contractJson,
+  url: process.env["DATABASE_URL"],
 });
-{{/if}}
-{{#if (eq provider "cockroachdb")}}
-const adapter = new PrismaPg({
-  connectionString: databaseUrl,
+{{else}}
+export const db = postgres<Contract>({
+  contractJson,
+  url: process.env["DATABASE_URL"],
 });
 {{/if}}
-{{#if (eq provider "mysql")}}
-const adapter = new PrismaMariaDb(databaseUrl);
-{{/if}}
-{{#if (eq provider "sqlite")}}
-const adapter = new PrismaBetterSqlite3({
-  url: databaseUrl,
-});
+
+export type StarterUser = {
+  id: string;
+  email: string;
+  name: string | null;
+  createdAt: Date | null;
+};
+
+export async function listUsers(limit = 10): Promise<StarterUser[]> {
+{{#if (eq schemaPreset "basic")}}
+{{#if (eq provider "mongo")}}
+  const users: StarterUser[] = [];
+
+  for await (const user of db.orm.users.select("_id", "email", "name").take(limit).all()) {
+    users.push({
+      id: String(user._id),
+      email: user.email,
+      name: user.name ?? null,
+      createdAt: null,
+    });
+  }
+
+  return users;
+{{else}}
+  const users = await db.orm.User.select("id", "email", "name", "createdAt").take(limit).all();
+
+  return users.map((user) => ({
+    id: String(user.id),
+    email: user.email,
+    name: user.name ?? null,
+    createdAt: user.createdAt,
+  }));
 {{/if}}
-{{#if (eq provider "sqlserver")}}
-const adapter = new PrismaMssql(databaseUrl);
+{{else}}
+  return [];
 {{/if}}
+}
 
-const prisma = new PrismaClient({ adapter });
-
-export { prisma };
-export default prisma;
+export default db;

package/templates/create/next/tsconfig.json

@@ -9,6 +9,7 @@
     "esModuleInterop": true,
     "module": "esnext",
     "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
     "resolveJsonModule": true,
     "isolatedModules": true,
     "jsx": "react-jsx",

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

@@ -9,24 +9,35 @@ Generated by `create-prisma` with the Nuxt template.
 - `{{runScriptCommand packageManager "preview"}}` - preview the production build
 - `{{runScriptCommand packageManager "typecheck"}}` - run Nuxt type checks
 
-## Prisma
+## Prisma Next
 
-Prisma setup is scaffolded automatically in:
+Prisma Next setup is scaffolded in:
 
-- `prisma/schema.prisma`
-- `prisma/seed.ts`
+- `prisma/contract{{#if (eq authoring "typescript")}}.ts{{else}}.prisma{{/if}}`
+- `prisma-next.config.ts`
 - `server/utils/prisma.ts`
 - `server/api/users.get.ts`
-- `prisma.config.ts`
-- `server/generated/prisma`
 
 Database helper scripts are added to `package.json`:
 
-- `db:generate`
-- `db:push`
-- `db:migrate`
-- `db:seed`
+- `{{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 "migration:apply"}}` - 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 "migration:apply"}}` - apply a planned migration
+{{/if}}
+{{#if (eq schemaPreset "basic")}}
+- `{{runScriptCommand packageManager "db:seed"}}` - insert sample users manually
+{{/if}}
+
+Node-based Prisma Next projects expect Node.js 24 LTS or newer.
 {{#if (eq schemaPreset "basic")}}
 
-The starter page in `app/pages/index.vue` fetches seeded users from `server/api/users.get.ts`, and `prisma/seed.ts` inserts starter users.
+The starter page in `app/pages/index.vue` fetches users from `server/api/users.get.ts` after you initialize and apply your schema.
 {{/if}}

package/templates/create/nuxt/app/pages/index.vue.hbs

@@ -8,7 +8,7 @@ type User = {
   id: string;
   email: string;
   name: string | null;
-  createdAt: string;
+  createdAt: string | null;
 };
 
 type UsersPayload = {
@@ -32,12 +32,12 @@ function formatCreatedAt(value: string): string {
 <template>
   <main class="shell">
     <div class="hero">
-      <p class="eyebrow">Nuxt + Prisma 7</p>
+      <p class="eyebrow">Nuxt + Prisma Next</p>
 {{#if (eq schemaPreset "basic")}}
       <h1>Users from your database, loaded through Nitro.</h1>
       <p class="lede">
         This page fetches <code>/api/users</code> from <code>server/api/users.get.ts</code> using
-        the Prisma instance in <code>server/utils/prisma.ts</code>.
+        the Prisma Next helper in <code>server/utils/prisma.ts</code>.
       </p>
     </div>
 
@@ -48,10 +48,10 @@ function formatCreatedAt(value: string): string {
       </div>
 
       <p v-if="data?.error" class="empty">
-        \{{ data.error }} Run <code>db:migrate</code>, then <code>db:seed</code>, then refresh.
+        \{{ data.error }} Run <code>contract:emit</code> and apply your schema, then refresh.
       </p>
       <p v-else-if="!data?.users?.length" class="empty">
-        No users yet. Run <code>db:seed</code> after your first migration.
+        No users yet. Run db:seed after applying your first migration.
       </p>
       <ul v-else class="users">
         <li v-for="user in data.users" :key="user.id">
@@ -59,15 +59,16 @@ function formatCreatedAt(value: string): string {
             <strong>\{{ user.name ?? "Unnamed user" }}</strong>
             <p>\{{ user.email }}</p>
           </div>
-          <time :datetime="user.createdAt">\{{ formatCreatedAt(user.createdAt) }}</time>
+          <time v-if="user.createdAt" :datetime="user.createdAt">\{{ formatCreatedAt(user.createdAt) }}</time>
+          <span v-else class="muted">No timestamp</span>
         </li>
       </ul>
     </section>
 {{else}}
       <h1>Your Nuxt app is ready.</h1>
       <p class="lede">
-        Edit <code>prisma/schema.prisma</code>, run <code>db:migrate</code>, then query data in
-        Nitro routes or server utilities with the Prisma instance in <code>server/utils/prisma.ts</code>.
+        Edit your Prisma Next contract, run <code>contract:emit</code>, then query data in
+        Nitro routes or server utilities with the helper in <code>server/utils/prisma.ts</code>.
       </p>
     </div>
 
@@ -80,8 +81,8 @@ function formatCreatedAt(value: string): string {
       <ul class="users">
         <li>
           <div>
-            <strong>Prisma client</strong>
-            <p>Use the shared server instance from <code>server/utils/prisma.ts</code>.</p>
+            <strong>Prisma Next runtime</strong>
+            <p>Use the shared server helper from <code>server/utils/prisma.ts</code>.</p>
           </div>
         </li>
         <li>
@@ -92,8 +93,8 @@ function formatCreatedAt(value: string): string {
         </li>
         <li>
           <div>
-            <strong>Generated client output</strong>
-            <p>Prisma Client is generated into <code>server/generated/prisma</code>.</p>
+            <strong>Contract output</strong>
+            <p>Prisma Next emits contract artifacts next to your contract file.</p>
           </div>
         </li>
       </ul>
@@ -165,6 +166,7 @@ h2 {
 
 .panel-header span,
 .empty,
+.muted,
 time {
   color: #888;
   font-size: 0.8rem;

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

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

package/templates/create/nuxt/nuxt.config.ts

@@ -2,4 +2,20 @@
 export default defineNuxtConfig({
   compatibilityDate: "2025-07-15",
   devtools: { enabled: true },
+  typescript: {
+    tsConfig: {
+      compilerOptions: {
+        allowImportingTsExtensions: true,
+      },
+    },
+  },
+  nitro: {
+    typescript: {
+      tsConfig: {
+        compilerOptions: {
+          allowImportingTsExtensions: true,
+        },
+      },
+    },
+  },
 });

package/templates/create/nuxt/prisma/contract.prisma.hbs

@@ -0,0 +1,44 @@
+{{#if (eq authoring "psl")}}
+// use prisma-next
+{{#if (eq schemaPreset "basic")}}
+{{#if (eq provider "mongo")}}
+
+model User {
+  id    ObjectId @id @map("_id")
+  email String   @unique
+  name  String?
+  posts Post[]
+
+  @@map("users")
+}
+
+model Post {
+  id       ObjectId @id @map("_id")
+  title    String
+  content  String?
+  author   User     @relation(fields: [authorId], references: [id])
+  authorId ObjectId
+
+  @@map("posts")
+}
+{{else}}
+
+model User {
+  id        Int      @id @default(autoincrement())
+  email     String   @unique
+  name      String?
+  posts     Post[]
+  createdAt DateTime @default(now())
+}
+
+model Post {
+  id        Int      @id @default(autoincrement())
+  title     String
+  content   String?
+  author    User     @relation(fields: [authorId], references: [id])
+  authorId  Int
+  createdAt DateTime @default(now())
+}
+{{/if}}
+{{/if}}
+{{/if}}

package/templates/create/nuxt/prisma/contract.ts.hbs

@@ -0,0 +1,85 @@
+{{#if (eq authoring "typescript")}}
+{{#if (eq provider "mongo")}}
+import mongoFamily from "@prisma-next/family-mongo/pack";
+import { defineContract } from "@prisma-next/mongo-contract-ts/contract-builder";
+import mongoTarget from "@prisma-next/target-mongo/pack";
+
+export const contract = defineContract(
+  { family: mongoFamily, target: mongoTarget },
+  ({ field, index, model, rel }) => ({
+    models: {
+{{#if (eq schemaPreset "basic")}}
+      User: model("User", {
+        collection: "users",
+        fields: {
+          _id: field.objectId(),
+          email: field.string(),
+          name: field.string().optional(),
+        },
+        indexes: [
+          index({ email: 1 }, { unique: true }),
+        ],
+        relations: {
+          posts: rel.hasMany("Post", { from: "_id", to: "authorId" }),
+        },
+      }),
+
+      Post: model("Post", {
+        collection: "posts",
+        fields: {
+          _id: field.objectId(),
+          title: field.string(),
+          content: field.string().optional(),
+          authorId: field.objectId(),
+        },
+        indexes: [
+          index({ authorId: 1 }),
+        ],
+        relations: {
+          author: rel.belongsTo("User", { from: "authorId", to: "_id" }),
+        },
+      }),
+{{/if}}
+    },
+  }),
+);
+{{else}}
+import sqlFamily from "@prisma-next/family-sql/pack";
+import { defineContract } from "@prisma-next/sql-contract-ts/contract-builder";
+import postgresPack from "@prisma-next/target-postgres/pack";
+
+export const contract = defineContract(
+  { family: sqlFamily, target: postgresPack },
+  ({ field, model, rel }) => ({
+    models: {
+{{#if (eq schemaPreset "basic")}}
+      User: model("User", {
+        fields: {
+          id: field.id.uuidv7(),
+          email: field.text().unique(),
+          name: field.text().optional(),
+          createdAt: field.createdAt(),
+        },
+        relations: {
+          posts: rel.hasMany("Post", { by: "authorId" }),
+        },
+      }),
+
+      Post: model("Post", {
+        fields: {
+          id: field.id.uuidv7(),
+          title: field.text(),
+          content: field.text().optional(),
+          authorId: field.uuid(),
+          createdAt: field.createdAt(),
+        },
+        relations: {
+          author: rel.belongsTo("User", { from: "authorId", to: "id" }),
+        },
+      }),
+{{/if}}
+    },
+  }),
+);
+{{/if}}
+{{/if}}

package/templates/create/nuxt/prisma-next.config.ts.hbs

@@ -0,0 +1,13 @@
+import "dotenv/config";
+{{#if (eq provider "mongo")}}
+import { defineConfig } from "@prisma-next/mongo/config";
+{{else}}
+import { defineConfig } from "@prisma-next/postgres/config";
+{{/if}}
+
+export default defineConfig({
+  contract: "./prisma/contract{{#if (eq authoring "typescript")}}.ts{{else}}.prisma{{/if}}",
+  db: {
+    connection: process.env["DATABASE_URL"],
+  },
+});

package/templates/create/nuxt/server/api/users.get.ts.hbs

@@ -1,18 +1,12 @@
 {{#if (eq schemaPreset "basic")}}
-import prisma from "../utils/prisma";
+import { listUsers } from "../utils/prisma";
 
 export default defineEventHandler(async () => {
-  const users = await prisma.user
-    .findMany({
-      take: 10,
-      orderBy: {
-        createdAt: "desc",
-      },
-    })
+  const users = await listUsers(10)
     .then((rows) =>
       rows.map((user) => ({
         ...user,
-        createdAt: user.createdAt.toISOString(),
+        createdAt: user.createdAt?.toISOString() ?? null,
       }))
     )
     .catch((error) => {