Sections

Guide utilisateur

Démarrage

Installez Runyard, branchez-le sur votre premier projet et regardez votre environnement de développement prendre vie depuis la barre de menus.

1. Installer Runyard

Runyard est livré sous forme de DMG signé et notarisé, alors Gatekeeper le laisse s'ouvrir au premier lancement sans broncher. Téléchargez la dernière version depuis la page des releases Runyard, ouvrez le fichier .dmg et glissez Runyard.app dans votre dossier Applications.

Une fois cette première installation faite, les mises à jour suivantes sont livrées via le bouton Check for Updates intégré. Vous n'avez besoin de télécharger le DMG qu'une seule fois.

2. Lancer Runyard

Ouvrez Runyard depuis le Launchpad ou Spotlight. L'application n'affiche ni fenêtre ni icône dans le Dock. Cherchez l'icône Runyard dans la barre de menus (en haut à droite de l'écran) et cliquez dessus pour ouvrir le popover.

À la première ouverture, Runyard vous accueille avec une carte de bienvenue. Votre configuration est vide par défaut, alors vous choisissez comment la remplir :

La carte de bienvenue disparaît dès que votre configuration contient au moins un outil. Pour la revoir, supprimez tous les outils depuis Réglages → Tools (ou videz le tableau tools dans config.json).

Si vous touchez Charger des outils d'exemple, quatre entrées apparaissent :

Les services exécutent des commandes echo. Remplacez-les par vos vrais projets à l'étape suivante. Les vérifications d'état fonctionnent telles quelles et sont utiles pour garder un œil sur n'importe quel point d'accès HTTP ou TCP que vous ne gérez pas comme un processus.

3. Où se trouve le fichier de configuration

Par défaut, Runyard lit le fichier suivant :

~/Library/Application Support/Runyard/config.json

Vous pouvez l'ouvrir directement depuis le pied du popover : cliquez sur Réglages, basculez sur l'onglet General, puis utilisez Files → Open in Editor. config.json s'ouvre alors dans votre éditeur par défaut pour les fichiers .json.

Vous pouvez également déplacer le fichier vers un autre dossier (par exemple, un dossier synchronisé). Voyez Synchroniser entre plusieurs Mac.

4. Remplacer l'exemple par votre propre projet

Vous pouvez modifier vos outils de deux façons :

La suite de cette section utilise la voie JSON. Ouvrez config.json et remplacez le premier outil par un outil pointant vers un projet réel sur votre Mac. Exemple minimal fonctionnel :

{
  "paths": ["/opt/homebrew/bin"],
  "tools": [
    {
      "name": "Mon projet",
      "type": "service",
      "directory": "~/Code/mon-projet",
      "startCommands": [
        {
          "label": "Dev Server",
          "command": "npm",
          "args": ["run", "dev"],
          "startupFallbackPort": 3000
        }
      ],
      "actions": [
        { "label": "Ouvrir dans le navigateur", "type": "url", "url": "http://localhost:{{port}}/" }
      ]
    }
  ]
}

Ce que fait chaque élément

5. Recharger la configuration

Après modification, ouvrez le popover et cliquez sur la tuile Recharger dans le pied. Votre nouvel outil apparaît immédiatement. Si la configuration contient une erreur de syntaxe, Runyard affiche une alerte indiquant la ligne concernée (avec un bouton Edit Configuration qui rouvre le fichier).

6. Démarrer votre premier outil

Ouvrez le popover, repérez la carte de votre outil et cliquez sur Start au bas de la carte. Runyard :

  1. Exécute npm install automatiquement si le dossier node_modules/ est absent.
  2. Lance chaque startCommand dans l'ordre, en respectant les dépendances waitFor.
  3. Détecte le port d'écoute du processus et l'affiche comme tag bleu :3000 sur la ligne meta de la carte.
  4. Interroge l'URL de vérification d'état (ou passe directement à l'état Running si aucune n'est configurée).

La pastille d'état de la carte devient verte et affiche Running une fois que tout est en bon état. Cliquez sur votre chip Ouvrir dans le navigateur (ou toute autre action ajoutée) pour accéder directement à votre application.

Étapes suivantes