Premiers pas

Ce guide part d’un projet existant, par exemple une app Vite ou Laravel dans ~/Code/monprojet. Vous n’avez pas de projet sous la main ? Créez-en un depuis un modèle.

1. Ajoutez le projet

   Glissez le dossier dans la fenêtre de Joppa, ou cliquez sur Ajouter un projet (raccourci N) et choisissez-le.

   Joppa lit le dossier (scripts de package.json, workspaces, artisan, Docker Compose) et propose un domaine pour chaque serveur de dev trouvé :

   monprojet.test        → :5173   vite
   api.monprojet.test    → :8000   laravel

   Ajustez les sous-domaines ou les ports si besoin, puis validez. Voir Ajouter un projet.

2. Lancez le serveur de dev

   Lancez-le comme d’habitude dans votre terminal (bun dev, php artisan serve…), ou laissez Joppa s’en charger : onglet Processus (P) › Analyser le projet, puis Enregistrer et démarrer. Voir Processus.

3. Ouvrez https://

   Appuyez sur O sur la page du projet : https://monprojet.test s’ouvre, avec le cadenas.

4. Branchez une base de données

   Dans Services, ajoutez PostgreSQL (ou MySQL, MariaDB) et démarrez-le. Puis, dans l’onglet Environnement du projet (E), cliquez sur Utiliser PostgreSQL : Joppa crée la base du projet et montre le diff du .env avant de l’écrire.

5. Prenez le clavier

   ⌘ K ouvre la palette : tapez « ouvrir », « copier », « démarrer »… Toutes les actions de l’app y sont. Voir Raccourcis clavier.

Et ensuite

• Concepts : comment les pièces s’assemblent.
• La commande joppa : la même chose depuis le terminal.
• Serveur MCP : laissez Claude ou Cursor démarrer vos services.