Communitygithub.com

YepAPI/skills

Définition de schéma Drizzle, push vs migrate, requêtes type-safe, relations, transactions et instructions préparées.

Qu'est-ce que skills ?

Ce skill fournit un guide structuré pour utiliser Drizzle ORM de manière efficace, en couvrant la définition de schéma avec `pgTable`, `mysqlTable` ou `sqliteTable`, ainsi que les bonnes pratiques de cycle de vie : `drizzle-kit push` pour le développement rapide sans fichiers de migration, et `drizzle-kit generate` + `migrate` pour une traçabilité en production. Il explique comment écrire des requêtes type-safe avec une inférence TypeScript complète, définir des relations via le helper `relations()` (`one()` / `many()`) pour les requêtes relationnelles avec `db.query`, et optimiser les performances avec des instructions préparées et des transactions. Le skill prévient également des pièges courants comme l'oubli de définir les relations, les requêtes N+1 ou le manque d'index sur les clés étrangères, et recommande Drizzle Studio pour la navigation visuelle en développement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/drizzle-orm

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Drizzle ORM

Règles

  • Définition du schéma : pgTable() / mysqlTable() / sqliteTable() dans src/db/schema.ts
  • Développement : drizzle-kit push pour itération rapide — aucun fichier de migration nécessaire
  • Production : drizzle-kit generate + drizzle-kit migrate pour un historique de migrations traçable
  • Requêtes type-safe : db.select().from(users).where(eq(users.email, email)) — inférence TypeScript complète
  • Relations : définir avec le helper relations() — one() et many() pour les requêtes relationnelles avec db.query
  • Instructions préparées : db.select().from(users).where(eq(users.id, sql.placeholder("id"))).prepare() — réutilisables pour les chemins chauds (hot paths)
  • Transactions : db.transaction(async (tx) => { ... }) — utiliser tx et non db dans la fonction de callback
  • Index : définir en ligne avec .index() ou dans la configuration de la table — ajouter sur les colonnes utilisées dans where et orderBy
  • Drizzle Studio : npx drizzle-kit studio pour un navigateur de base de données visuel pendant le développement

Exemples de code

// schema.ts
import { pgTable, text, timestamp, uuid, integer } from "drizzle-orm/pg-core";
import { relations } from "drizzle-orm";

export const users = pgTable("users", {
  id: uuid("id").primaryKey().defaultRandom(),
  name: text("name").notNull(),
  email: text("email").notNull().unique(),
  createdAt: timestamp("created_at").defaultNow().notNull(),
});

export const posts = pgTable("posts", {
  id: uuid("id").primaryKey().defaultRandom(),
  title: text("title").notNull(),
  authorId: uuid("author_id").references(() => users.id).notNull(),
});

export const usersRelations = relations(users, ({ many }) => ({
  posts: many(posts),
}));

export const postsRelations = relations(posts, ({ one }) => ({
  author: one(users, { fields: [posts.authorId], references: [users.id] }),
}));

// Requête avec relations
const result = await db.query.users.findFirst({
  where: eq(users.id, userId),
  with: { posts: true },
});

À éviter

  • drizzle-kit push en production — utiliser generate + migrate pour des migrations tracées
  • SQL brut quand l'API Drizzle le couvre — utiliser le tag template sql uniquement pour les expressions complexes
  • Oublier les définitions relations() — sans elles, les requêtes relationnelles db.query ne fonctionneront pas
  • Requêtes N+1 — utiliser with dans db.query pour joindre les relations en une seule requête
  • Index manquants sur les clés étrangères et les colonnes filtrées — Drizzle ne les crée pas automatiquement

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Skills associés