For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /fr/docs/desktop/run.md (or send Accept: text/markdown).

Lancer et configurer l’enveloppe

Démarrez l’enveloppe de développement Tauri et reliez-la à votre application Web.

Poser une question sur ce guide

Parcours pas à pas pour débuter

Conditions préalables : lisez les deux guides pour débutants ci-dessous et terminez la configuration locale du bureau, y compris les conditions préalables de Rust et du système d'exploitation. Le bloc de code démarre à la fois l'application Web et Tauri dans le monorepo ; dans une extraction sur ordinateur uniquement, utilisez sa commande filtrée uniquement après avoir démarré séparément un backend Web accessible. Tauri charge ce backend.

Termes rapides : un espace de travail est constitué des utilisateurs, des données et des paramètres distincts d'une équipe. Le serveur est le backend de confiance ; gardez les clés du fournisseur hors du code du navigateur et du téléphone. Une migration est une modification de base de données versionnée qui crée ou met à jour des tables. Un modèle d'IA est le moteur qui répond ; le catalogue de modèles est la liste du serveur des identifiants de modèles et des prix disponibles. Un fournisseur est un service externe tel qu'un service d'IA, de messagerie ou de facturation. Un droit est une subvention qui permet à un espace de travail d'utiliser une fonctionnalité. Un webhook est un message qu'un service envoie au URL d'un autre service.

1. Ouvrez apps/desktop/src-tauri/src/lib.rs ; demandez à votre agent de modifier uniquement le comportement de la fenêtre/de la barre d'état système/des raccourcis clavier nommés et de conserver l'interface utilisateur du produit dans l'application Web.

2. Exécutez le shell et testez Close-to-tray, Quit et CmdOrCtrl+Shift+Space ; testez supastack:///settings/appearance?preview=1#main.

3. Il doit concentrer la fenêtre existante et conserver le chemin/requête/fragment. S'il ouvre la mauvaise page, comparez l'origine configurée et l'itinéraire exact.

Pour le code personnalisé, commencez par le prompts/README.md fourni et copiez l'invite la plus proche : prompts/new-app-screen.md pour un écran d'application ou prompts/new-landing-page.md pour une page publique. Pour le travail sur un serveur, une base de données ou un fournisseur, confiez à votre agent de codage la tâche de ce guide et demandez-lui de lire les miroirs AGENTS.md, .ai/PROJECT_CONTEXT.md et .ai/ correspondants ; inspectez les fichiers sources exacts nommés ici ; lister les fichiers et les vérifications avant de les modifier ; préserver la propriété de l'espace de travail et les secrets du serveur ; et je vous montre la différence. Indiquez-lui le comportement souhaité, les champs d'entrée et de sortie, les rôles autorisés, les succès et erreurs attendus, ainsi que le compte, le fournisseur ou l'appareil de test. Utilisez des exemples de valeurs ; ne collez jamais un vrai secret.

# Monorepo: start the web app and desktop shell together
corepack pnpm dev:desktop

# Desktop-only checkout: start Tauri after a web backend is already reachable
corepack pnpm --filter @supastack/desktop dev

Garder le comportement du shell dans Rust

src-tauri/src/lib.rs crée la webview principale de 1200×800. Fermer masque la fenêtre dans la zone ; Quitter ferme l’application. Les menus natifs proposent Accueil, précédent/suivant, rechargement, zoom/plein écran et actions de fenêtre. La restauration conserve la taille et la position.

Gérer les liens et l’affichage

La coque accepte les routes supastack:// et les résout sur l’origine HTTP(S) exacte configurée pour l’application. Par exemple, supastack:///settings/appearance?preview=1#main devient /workspace/settings?tab=billing#plans ; supastack:///auth/callback?code=... correspond à /auth/callback?code=.... Les paramètres de requête et les fragments sont conservés.

Les liens de démarrage sont appliqués avant l’affichage de la première fenêtre. Les liens reçus en cours d’exécution sur macOS passent par on_open_url de Tauri ; les arguments de seconde instance sous Windows et Linux passent par le callback single-instance avec la fonctionnalité deep-link activée. Les liens valides mettent au premier plan la fenêtre existante et la font naviguer.

Seuls les liens HTTP(S) sans identifiants dont le schéma, l’hôte et le port effectif correspondent exactement à la configuration restent dans la coque. Les liens HTTP(S) sans identifiants, mailto: et tel: peuvent être ouverts à l’extérieur ; les liens mal formés, les identifiants, les schémas non pris en charge, les ports sur les liens personnalisés et les tentatives de traversal sont rejetés. L’URL du serveur configuré rejette également les identifiants et revient au prochain choix valide ou par défaut.

SUPASTACK_APP_URL=https://your-app.example
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space

supastack:///settings/appearance?preview=1#main
# Opens https://your-app.example/workspace/settings?tab=billing#plans

Vérifier le comportement propre à la plateforme

La couche hors ligne injectée propose Réessayer, se masque lorsque la connexion revient et recharge l’application web. Testez le focus, les raccourcis, le zoom des menus, la zone et l’invocation par lien profond sur chaque système cible ; des vérifications unitaires d’URL ne prouvent pas le fonctionnement des interactions natives.

Acceptation du bureau

Configuration et paramètres

Installez les dépendances de l'espace de travail et la chaîne d'outils Rust ainsi que les prérequis par système d'exploitation de Tauri (WebView2 est livré avec Windows ; macOS et Linux ont besoin de leurs packages documentés). corepack pnpm --filter @supastack/desktop dev exécute tauri dev : il construit le noyau Rust, affiche l'interface utilisateur de l'espace réservé et charge l'application résolue URL.

SUPASTACK_APP_URL est d’abord lue à l’exécution, puis utilise la valeur intégrée au build. Seules les URL HTTP(S) sans identifiants sont acceptées ; sinon, la valeur suivante est essayée. SUPASTACK_DESKTOP_HOTKEY remplace le raccourci CmdOrCtrl+Shift+Space par défaut. Une valeur incorrecte rétablit le raccourci par défaut sans empêcher le démarrage.

corepack pnpm --filter @supastack/desktop dev
corepack pnpm --filter @supastack/desktop typecheck

SUPASTACK_APP_URL=https://app.example.com \
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space \
corepack pnpm --filter @supastack/desktop dev

Processus d’implémentation

La fenêtre principale reste sur l’origine exacte configurée, protocole et port compris. Les liens HTTP(S) sans identifiants, mailto et tel peuvent s’ouvrir dans le navigateur système ; les protocoles non autorisés sont annulés.

Les liens supastack:// enregistrés reportent leur chemin, leur requête et leur fragment sur l’origine configurée de l’application. Le démarrage, les événements système d’ouverture d’URL et les callbacks de seconde instance appliquent la même validation : un lien profond ne peut pas rediriger l’enveloppe vers un autre hôte.

L’icône de zone de notification et le raccourci global affichent et sélectionnent l’unique fenêtre principale. Si le raccourci ne fonctionne pas, une autre application utilise généralement la combinaison ; choisissez un autre SUPASTACK_DESKTOP_HOTKEY.

Vérification et dépannage

Après toute modification de src-tauri, exécutez cargo check et cargo test avec les scripts du package. Vérifiez ensuite la navigation vers l’origine exacte, l’ouverture des liens externes autorisés, une route supastack:// sur l’origine configurée, la zone de notification et le raccourci, ainsi que la persistance de la connexion après redémarrage.

Pour poursuivre la configuration, consultez Créer les comptes de publication desktop.