Communitygithub.com

Express & Fastify

Modèles Express.js et Fastify : middleware, organisation des routes, validation avec Zod, gestion des erreurs, système de plugins, cycle de vie des requêtes, configuration TypeScript.

Qu'est-ce que Express & Fastify ?

Ce skill fournit un guide complet sur les bonnes pratiques pour construire des API web robustes avec Express.js et Fastify. Il couvre l'organisation des routes par domaine, la validation systématique des entrées avec Zod, la gestion centralisée des erreurs, et la configuration TypeScript avec des génériques. Les règles encouragent l'utilisation du système de plugins de Fastify pour l'encapsulation et des schémas JSON ou Zod pour la validation et la sérialisation. Les développeurs apprendront également à configurer l'ordre des middlewares, à implémenter des endpoints de santé, et à gérer un arrêt gracieux des serveurs. Le skill inclut des exemples de code concrets pour les deux frameworks, en insistant sur l'évitement de la logique métier dans les gestionnaires de routes et l'importance de valider côté serveur.

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

Demander à votre IA préférée

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

Documentation

Que fait Express & Fastify ?

Règles

  • Organiser les routes par domaine : routes/users.ts, routes/orders.ts — un routeur par ressource
  • Valider toutes les entrées avec Zod : analyser req.body, req.params, req.query avant le traitement
  • Gestionnaire d'erreurs centralisé : middleware de rattrapage (Express) ou setErrorHandler (Fastify)
  • Renvoyer un format d'erreur cohérent : { error: { code: string, message: string, details?: unknown } }
  • TypeScript : typer la requête/réponse avec des génériques — Request<Params, ResBody, ReqBody, Query>
  • Ordre des middlewares : CORS, analyseur de corps, authentification, limitation de débit, routes, gestionnaire d'erreurs
  • Utiliser des gestionnaires de routes asynchrones — les encapsuler avec la gestion des erreurs ou utiliser express-async-errors
  • Fastify : utiliser le système de plugins pour encapsuler les routes et les décorateurs — fastify.register()
  • Schémas Fastify : définir des schémas JSON ou utiliser @fastify/type-provider-zod pour la validation et la sérialisation
  • Contrôle de santé : GET /health — renvoyer 200 avec l'état de connectivité DB/Redis
  • Arrêt gracieux : écouter SIGTERM, arrêter d'accepter les connexions, terminer les requêtes en cours

Modèles

// Express + Zod validation
import { Router } from "express";
import { z } from "zod";

const router = Router();
const CreateUserSchema = z.object({ email: z.string().email(), name: z.string().min(1) });

router.post("/users", async (req, res, next) => {
  try {
    const body = CreateUserSchema.parse(req.body);
    const user = await createUser(body);
    res.status(201).json(user);
  } catch (err) { next(err); }
});
// Fastify + Zod type provider
import Fastify from "fastify";
import { serializerCompiler, validatorCompiler, ZodTypeProvider } from "fastify-type-provider-zod";

const app = Fastify().withTypeProvider<ZodTypeProvider>();
app.setValidatorCompiler(validatorCompiler);
app.setSerializerCompiler(serializerCompiler);

app.post("/users", { schema: { body: CreateUserSchema } }, async (req) => {
  return createUser(req.body); // entièrement typé
});

À éviter

  • Mettre la logique métier dans les gestionnaires de routes — l'extraire dans la couche service/domaine
  • Oublier la gestion des erreurs asynchrones dans Express — les rejets non traités font planter le processus
  • Importer toutes les routes dans un seul fichier — utiliser router.use() ou les plugins Fastify pour la modularité
  • Ignorer la validation des entrées parce que "le frontend valide" — toujours valider côté serveur

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

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

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

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

Skills associés