Deploy Kit — Skill de Déploiement Web

Simplifie le déploiement d'apps web sur Vercel, Railway et Supabase via leurs CLIs.

Quand utiliser ce skill

L'utilisateur demande de déployer une app, créer une base de données, configurer un hébergement, ou gérer des variables d'environnement sur ces plateformes.

Workflow principal

1. Détecter le projet

python3 skills/deploy-kit/scripts/deploy.py detect <chemin>

Retourne : framework, langage, fichiers clés trouvés.

2. Vérifier les CLIs disponibles

python3 skills/deploy-kit/scripts/deploy.py check

Si un CLI manque, guide l'installation (voir références).

3. Recommander une plateforme

python3 skills/deploy-kit/scripts/deploy.py recommend <chemin>

| Type de projet | Plateforme recommandée | |---|---| | Frontend statique / SSR (Next, Astro, Vite, Svelte, Nuxt) | Vercel | | Backend / API (Express, Flask, FastAPI, Django) | Railway | | App full-stack avec BDD | Railway + Supabase | | BDD / Auth / Storage / Edge Functions | Supabase |

4. Déployer

python3 skills/deploy-kit/scripts/deploy.py deploy <chemin> --platform <vercel|railway|supabase>

⚠️ TOUJOURS demander confirmation avant de déployer. Le script demande aussi une confirmation interactive.

Détection de projet — Règles

| Fichier trouvé | Framework détecté | |---|---| | next.config.* | Next.js | | astro.config.* | Astro | | vite.config.* | Vite | | svelte.config.* | SvelteKit | | nuxt.config.* | Nuxt | | remix.config.* / app/root.tsx | Remix | | angular.json | Angular | | requirements.txt / Pipfile | Python | | manage.py | Django | | package.json → scripts.start | Node.js app | | Dockerfile | Docker (Railway) | | supabase/config.toml | Supabase project |

Variables d'environnement

• Vercel : vercel env add NOM_VAR ou via dashboard
• Railway : railway variables set NOM=VALEUR
• Supabase : secrets via supabase secrets set NOM=VALEUR

Toujours vérifier .env / .env.local pour les vars existantes avant déploiement.

Domaines custom

• Vercel : vercel domains add mondomaine.com
• Railway : railway domain (génère un sous-domaine), custom via dashboard

Références détaillées

Charger à la demande selon la plateforme :

• skills/deploy-kit/references/vercel.md — Vercel CLI complet
• skills/deploy-kit/references/railway.md — Railway CLI complet
• skills/deploy-kit/references/supabase.md — Supabase CLI complet

Commandes rapides

| Action | Commande | |---|---| | Deploy preview Vercel | vercel | | Deploy prod Vercel | vercel --prod | | Deploy Railway | railway up | | Push DB Supabase | supabase db push | | Deploy edge function | supabase functions deploy <nom> | | Voir les logs | vercel logs <url> / railway logs | | Lister les projets | vercel ls / railway list |

Règles pour l'agent

1. Ne jamais déployer sans confirmation explicite de l'utilisateur
2. Toujours détecter le projet avant de recommander
3. Vérifier que le CLI est installé et authentifié
4. Charger la référence détaillée de la plateforme si besoin de commandes avancées
5. Proposer un déploiement preview avant production
6. Mentionner les coûts potentiels si projet hors free tier