Démarrage

Installez Runyard depuis le Mac App Store, lancez-le pour la première fois et modifiez votre configuration.

1. Installer depuis le Mac App Store

Runyard est distribué par l'intermédiaire du Mac App Store. Ouvrez l'App Store, recherchez Runyard et cliquez sur Obtenir (ou Installer). macOS se charge de tout — aucune commande de terminal, aucune invite de sécurité à ignorer.

Une fois installée, l'application apparaît dans votre dossier Applications.

2. Lancer Runyard

Ouvrez Runyard depuis le Launchpad ou Spotlight. L'application n'affiche ni fenêtre ni icône dans le Dock — cherchez plutôt l'icône Runyard dans la barre de menus (en haut à droite de l'écran). Cliquez dessus pour ouvrir le menu.

Au premier lancement, Runyard crée un fichier de configuration d'exemple afin de vous montrer comment le menu est organisé. Trois outils d'exemple apparaissent :

My App — un service avec une paire de processus Backend + Frontend, accompagné d'actions comme « Open Frontend » et « Clear Cache ».
Quick Links — un raccourci contenant quelques URL externes (Grafana, Jira, documentation).
My Stack — un groupe qui imbrique un service, un proxy inverse et un ensemble de liens rapides dans un sous-menu.

Ce sont des exemples — ils exécutent des commandes echo uniquement pour illustrer l'interface. Remplacez-les par vos vrais projets à l'étape suivante.

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 menu : Runyard → Edit Configuration. Cette commande ouvre config.json 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 :

Réglages → Tools — un formulaire guidé avec une barre latérale, un sélecteur de type et une validation par champ. Les enregistrements écrivent directement dans config.json. Voir le guide de la fenêtre Réglages.
Modifier config.json directement — pratique pour le diff, le copier-coller entre machines ou le contrôle de version.

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",
      "directory": "~/Code/mon-projet",
      "startCommands": [
        {
          "label": "Dev Server",
          "command": "npm",
          "args": ["run", "dev"],
          "startupFallbackPort": 3000
        }
      ],
      "actions": [
        { "label": "Ouvrir dans le navigateur", "url": "http://localhost:{{port}}/" }
      ]
    }
  ]
}

Ce que fait chaque élément

paths — répertoires ajoutés en tête du PATH avant l'exécution des commandes. Ajoutez /opt/homebrew/bin si vous avez installé des outils via Homebrew ; ajoutez le répertoire bin de votre installation Node.js (par exemple ~/.nvm/versions/node/v22.0.0/bin) pour que npm et node soient correctement résolus.
directory — le dossier depuis lequel exécuter les commandes. ~ est automatiquement remplacé par votre dossier personnel.
startCommands — le ou les processus à lancer. Chacun possède une étiquette, une commande et des arguments optionnels.
startupFallbackPort — utilisé si Runyard ne parvient pas à détecter automatiquement le port d'écoute.
actions — éléments de menu supplémentaires, comme l'ouverture d'une URL dans le navigateur. {{port}} est remplacé par le port détecté au moment de l'exécution.

5. Recharger la configuration

Après modification, cliquez sur le menu Runyard et choisissez Reload Configuration. Votre nouvel outil apparaît immédiatement. Si la configuration contient une erreur de syntaxe, Runyard affiche une alerte indiquant la ligne concernée.

6. Démarrer votre premier outil

Cliquez sur l'élément de menu de votre outil et choisissez Start. Runyard :

Exécute npm install automatiquement si le dossier node_modules/ est absent.
Lance chaque startCommand dans l'ordre, en respectant les dépendances waitFor.
Détecte le port d'écoute du processus et l'affiche à côté du nom de l'outil (par exemple, « Mon projet • :3000 »).
Interroge l'URL de vérification d'état (ou passe directement à l'état « running » si aucune n'est configurée).

Une pastille verte à côté du nom de l'outil indique qu'il est en bon état. Cliquez sur Ouvrir dans le navigateur (ou toute autre action ajoutée) pour accéder directement à votre application.

Étapes suivantes

Guide de la barre de menus — les trois types d'outils (service, shortcut, group) et toutes les actions disponibles.
Référence config.json — la liste complète des champs.
Dépannage — où se trouvent les journaux, comment récupérer d'une configuration cassée et comment forcer une langue spécifique.

Guide utilisateur