medusajs/db-migrate

Exécute les migrations de base de données dans Medusa

Qu'est-ce que db-migrate ?

Cette compétence permet d'exécuter des migrations de base de données dans un projet Medusa. Elle est essentielle pour les développeurs qui travaillent avec Medusa, une plateforme de commerce électronique headless, car elle assure la synchronisation du schéma de base de données avec les modèles et plugins du projet. La compétence utilise la commande CLI de Medusa `npx medusa db:migrate` ou un script équivalent défini dans le projet. Elle prend en charge l'exécution locale ou dans des environnements CI/CD et peut être intégrée à des outils comme Claude Code, Cursor ou Codex pour automatiser les mises à jour de la base de données pendant le développement. Cette compétence est utile pour appliquer les migrations après des modifications de modèles ou l'ajout de nouveaux plugins nécessitant des changements de schéma. Elle garantit que la base de données reflète toujours l'état actuel du code, réduisant ainsi les erreurs manuelles et accélérant les cycles de développement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/medusajs/medusa-agent-skills/tree/main/skills/db-migrate

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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 db-migrate ?

Exécute les migrations de base de données dans Medusa

Cette compétence exécute les migrations de base de données pour un projet Medusa. Utilisez-la après avoir modifié vos modèles Medusa ou installé des plugins qui nécessitent des mises à jour de la base de données.

Utilisation

Pour exécuter les migrations, utilisez la commande suivante dans le répertoire racine de votre projet Medusa :

npx medusa db:migrate

Vous pouvez également définir un script personnalisé dans votre package.json et l'appeler :

{
  "scripts": {
    "migrate": "medusa db:migrate"
  }
}

Quand l'utiliser

  • Après avoir modifié des fichiers de modèle dans models/
  • Après avoir installé ou mis à jour des plugins Medusa
  • Lors de la configuration initiale du projet
  • Dans les pipelines CI/CD avant de démarrer le serveur

Remarques

  • Assurez-vous que votre base de données est en cours d'exécution et que la chaîne de connexion est correctement configurée dans les variables d'environnement (DATABASE_URL).
  • Les migrations Medusa sont exécutées par un outil de migration interne qui crée ou modifie automatiquement les tables en fonction de vos modèles.

Individual skills in this repo

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

medusajs/building-admin-dashboard-customizations

Load automatically when planning, researching, or implementing Medusa Admin dashboard UI (widgets, custom pages, forms, tables, data loading, navigation). REQUIRED for all admin UI work in ALL modes (planning, implementation, exploration). Contains design patterns, component usage, and data loading patterns that MCP servers don't provide.

medusajs/building-storefronts

Load automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns, data fetching). REQUIRED for all storefront development in ALL modes (planning, implementation, exploration). Contains SDK usage patterns, frontend integration, and critical rules for calling Medusa APIs.

medusajs/building-with-medusa

Load automatically when planning, researching, or implementing ANY Medusa backend features (custom modules, API routes, workflows, data models, module links, business logic). REQUIRED for all Medusa backend work in ALL modes (planning, implementation, exploration). Contains architectural patterns, best practices, and critical rules that MCP servers don't provide.

medusajs/db-generate

Generate database migrations for a Medusa module

medusajs/learning-medusa

Load automatically when user asks to learn Medusa development (e.g., "teach me how to build with medusa", "guide me through medusa", "I want to learn medusa"). Interactive guided tutorial where Claude acts as a coding bootcamp instructor, teaching step-by-step with checkpoints and verification.

medusajs/new-user

Create an admin user in Medusa

medusajs/storefront-best-practices

ALWAYS use this skill when working on ecommerce storefronts, online stores, shopping sites. Use for ANY storefront component including checkout pages, cart, payment flows, product pages, product listings, navigation, homepage, or ANY page/component in a storefront. CRITICAL for adding checkout, implementing cart, integrating Medusa backend, or building any ecommerce functionality. Framework-agnostic (Next.js, SvelteKit, TanStack Start, React, Vue). Provides patterns, decision frameworks, backend integration guidance.

Skills associés