Les commandes de la CLI Supabase pour développer en local, versionner le schéma par migrations, déployer des Edge Functions et générer des types.

Installation

npm install supabase --save-dev     # par projet (Node.js 20+), puis npx supabase --help
brew install supabase/tap/supabase  # macOS ou Linux (Homebrew)

Windows : scoop bucket add supabase https://github.com/supabase/scoop-bucket.git puis scoop install supabase. La pile locale tourne dans des conteneurs : un moteur de conteneurs (Docker Desktop, OrbStack sur macOS, Podman, colima…) est requis.

Pile locale

CommandeCe qu’elle fait
supabase initCrée le dossier supabase/ et config.toml (fichiers locaux uniquement).
supabase startDémarre la pile locale (le premier lancement télécharge les images Docker).
supabase statusAffiche les URL et clés de la pile locale.
supabase stopArrête la pile sans réinitialiser la base locale.
supabase stop --no-backupArrête et supprime les changements de schéma et de données locaux : à sauvegarder avant.

Base de données et migrations

CommandeCe qu’elle fait
supabase migration new <nom>Crée un fichier de migration vide.
supabase migration upApplique les migrations en attente.
supabase db diffCompare le schéma à une base fantôme pour produire un diff.
supabase db resetReconstruit la base locale à partir des migrations et des données de seed.
supabase db pullRapatrie les changements du schéma distant dans une nouvelle migration.
supabase db pushPousse les migrations locales vers la base distante.
supabase gen typesGénère des types à partir du schéma.

Projet hébergé et fonctions

CommandeCe qu’elle fait
supabase loginConnecte la CLI avec un jeton d’accès personnel.
supabase linkLie le dossier local à un projet hébergé.
supabase functions new <nom>Crée une Edge Function avec du code de départ.
supabase functions serveSert les fonctions en local.
supabase functions deployDéploie une fonction vers le projet lié.
supabase secrets set NOM=valeurDéfinit des secrets pour le projet lié.

Conseils d’utilisation

  • Travailler par migrations versionnées plutôt que par modifications manuelles dans le tableau de bord.
  • Écrire et tester les politiques RLS en local avant db push : une RLS mal configurée est le premier risque de sécurité.
  • Toujours passer par db reset pour vérifier que les migrations et le seed reconstruisent bien la base.
  • Ne jamais exécuter stop --no-backup sans sauvegarde de ce qui doit être conservé.
  • Surveiller les coûts : egress et stockage dépendent du profil lecture/écriture.

Sources