Que fait convex-quickstart ?
Crée ou ajoute Convex à une application. À utiliser pour les nouveaux projets Convex, npm create convex@latest, la configuration du frontend, les variables d'environnement ou la première exécution de npx convex dev.
Description
Cette compétence permet d'initialiser un projet avec Convex, un backend temps réel pour applications web. Elle guide l'agent à travers les étapes nécessaires :
- Création du projet via
npm create convex@latest - Configuration du frontend (Next.js, React, Vue, etc.)
- Définition des variables d'environnement requises (
CONVEX_DEPLOYMENT,NEXT_PUBLIC_CONVEX_URL) - Lancement du serveur de développement avec
npx convex dev
Utilisation
Appelez cette compétence lorsque l'utilisateur souhaite :
- Démarrer un nouveau projet avec Convex
- Ajouter Convex à un projet existant
- Configurer les variables d'environnement pour Convex
- Exécuter pour la première fois
npx convex dev
Prérequis
- Node.js installé (version 18 ou supérieure)
- npm ou bun
- Un compte Convex (créé automatiquement si nécessaire)
Exemple de workflow
# Créer un nouveau projet
npm create convex@latest mon-projet
cd mon-projet
# Configurer les variables d'environnement
export CONVEX_DEPLOYMENT=dev
export NEXT_PUBLIC_CONVEX_URL=http://localhost:3000
# Lancer le serveur de développement
npx convex dev
Notes supplémentaires
- Les fichiers de configuration (convex.json, .env.local) sont créés automatiquement.
- L'agent peut assister à la résolution des erreurs de connexion.
- Pour les projets Next.js, l'intégration se fait via le package
convex/next.