Prisma 7

Prisma 7 ORM

Rust-free TypeScript ORM with 90% smaller bundles and 3x faster queries.

Agent Workflow (MANDATORY)

Before ANY implementation, launch in parallel:

1. fuse-ai-pilot:explore-codebase - Analyze existing schema and database patterns
2. fuse-ai-pilot:research-expert - Verify latest Prisma 7 docs via Context7/Exa
3. mcp__context7__query-docs - Check breaking changes and migration guide

After implementation, run fuse-ai-pilot:sniper for validation.

Overview

When to Use

• Database access in Next.js 16 applications
• Type-safe queries with full TypeScript inference
• Schema-first database modeling and migrations
• Complex queries requiring TypedSQL
• Excluding sensitive fields with Omit API

Why Prisma 7

Breaking Changes from v6

Critical Migration Points

Required Schema Changes

Provider must be prisma-client with explicit output path. No more generation to node_modules.

Driver Adapters Required

PostgreSQL requires @prisma/adapter-pg, MySQL requires @prisma/adapter-mariadb, SQLite requires @prisma/adapter-better-sqlite3.

SOLID Architecture

Module Structure

Database code organized in modules/cores/db/:

• modules/cores/db/prisma.ts - Singleton PrismaClient
• modules/cores/db/generated/ - Generated client
• prisma/schema.prisma - Schema definition
• prisma/migrations/ - Migration history
• prisma.config.ts - Prisma configuration

File Organization

Key Concepts

Singleton Pattern (Next.js)

Prevent multiple PrismaClient instances during hot-reload. Use globalThis to cache instance in development.

Output Path

Generated client goes to custom path, not node_modules. Import from generated folder.

Driver Adapters

Direct database driver integration for better performance and control. Configure connection pooling at driver level.

TypedSQL

Write raw SQL with full type safety. Results are typed based on query.

Omit API

Exclude fields globally or per-query. Perfect for passwords and sensitive data.

Reference Guide (130 files)

Core Setup

Schema & Modeling

Queries & Operations

Advanced Queries

Migrations

Performance

Security

Databases

Extensions & Integrations

Framework Integrations

Auth Integrations

Deployment

Tooling

Monitoring

ORM Comparisons

Migration Guides

Best Practices

1. Singleton in Next.js - Cache PrismaClient in globalThis
2. Output path required - Never generate to node_modules
3. Driver adapters - Use native drivers for better performance
4. Omit sensitive fields - Configure global omit for passwords
5. TypedSQL for complex - Use for queries Prisma can't express
6. Index verification - Check query plans for N+1 issues

Forbidden Patterns