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/before-you-start.md (or send Accept: text/markdown).

Avant de commencer

Installez Node.js, Git, un éditeur, Rust et les outils de build natifs, acceptez l'invitation à votre dépôt, téléchargez le kit et vérifiez que votre ordinateur est prêt pour la première exécution desktop.

Poser une question sur ce guide

1. Choisissez ce que vous souhaitez exécuter

Utilisez un ordinateur Windows, macOS ou Linux avec une connexion Internet. L'application Desktop est une fenêtre native installée sur ce même ordinateur — aucun téléphone n'est impliqué. Les étapes ci-dessous installent ses outils et téléchargent le projet.

Un dépôt est le dossier de fichiers que vous avez reçu via GitHub. Un achat Desktop fournit le dépôt du kit Desktop ; le pack All Platforms fournit le monorepo, un dossier contenant les trois applications. Acceptez l'invitation du dépôt que vous avez acheté. Le dépôt Desktop contient le shell Tauri — la fenêtre native autour de votre application web —, mais pas le backend Web, donc la fenêtre se connecte à une adresse de backend exécutée séparément.

Préparez ces outils une fois. Le téléchargement des outils et de la première compilation native peut prendre bien plus de cinq minutes. Les guides de cinq minutes commencent après ces préparatifs ; l'exécution locale ne publie pas votre application sur Internet.

2. Installez Node.js

Ouvrez la page de téléchargement officielle de Node.js ci-dessous. Choisissez une version LTS numérotée 22 ou supérieure et le programme d'installation pour votre ordinateur : .msi sous Windows ou .pkg sous macOS. Ouvrez le programme d'installation téléchargé, conservez ses valeurs par défaut et terminez l'installation. Node.js permet à votre ordinateur d'exécuter le JavaScript de l'application ; npm est installé avec.

Fermez et rouvrez votre terminal après l'installation. Sous Windows, ouvrez Démarrer, tapez PowerShell et ouvrez-le. Sur macOS, appuyez sur Commande + Espace, tapez Terminal et appuyez sur Entrée. Sous Linux, ouvrez Terminal depuis le menu de vos applications. Collez la commande ci-dessous, puis appuyez sur Entrée. Un résultat tel que v22.x.x ou v24.x.x confirme que Node est disponible. Si vous voyez une commande introuvable ou non reconnue, rouvrez le terminal ou réinstallez Node avec son option PATH activée.

Installateurs officiels Node.js

node --version
npm --version

3. Installez Git et un éditeur de texte

Ouvrez la page de téléchargement Git ci-dessous, sélectionnez votre système d'exploitation et suivez son programme d'installation. Git télécharge votre référentiel privé et enregistre les modifications apportées aux fichiers. Sur macOS, l'exécution de la commande ci-dessous peut proposer l'installation des outils de ligne de commande d'Apple ; acceptez-le et réexécutez la commande une fois qu'elle est terminée. Sous Linux, utilisez la commande d'installation indiquée pour votre distribution sur la page Git.

Installez Visual Studio Code à partir de sa page de téléchargement officielle. Il s'agit d'un éditeur de texte permettant d'ouvrir le projet et d'enregistrer les fichiers de configuration. Ouvrez-le, choisissez Fichier → Ouvrir le dossier (Fichier → Ouvrir sur macOS), puis sélectionnez le dossier supastack que vous téléchargez. Vous n'avez pas besoin d'écrire du code pour réaliser la première démonstration locale.

Dans un terminal nouvellement ouvert, exécutez la commande ci-dessous. Un résultat commençant la version de Git signifie que Git est prêt. Si la commande est manquante, terminez le programme d'installation et rouvrez le terminal.

git --version

4. Acceptez votre invitation GitHub

Connectez-vous à GitHub dans votre navigateur en utilisant le compte que vous avez fourni lors de l'achat. Ouvrez votre e-mail d'invitation GitHub, sélectionnez Afficher l'invitation et acceptez l'accès. Ensuite, ouvrez le référentiel invité. Vous devriez voir ses fichiers et un bouton Code vert. Un 404 signifie généralement que l'invitation n'a pas été acceptée ou que vous êtes connecté à un autre compte GitHub.

Sélectionnez Code → Local → HTTPS et copiez l'adresse affichée. Utilisez cette adresse exacte à l’étape suivante. Les exemples d'adresses contenant des crochets angulaires sont des modèles : remplacez-les plutôt que de coller les crochets. Vous n'avez pas besoin de deviner le nom d'une organisation ou de rendre public le référentiel privé.

5. Téléchargez le projet sur votre ordinateur

Choisissez un dossier pour vos projets, tel que Documents. Ouvrez ce dossier dans l'Explorateur de fichiers ou le Finder. Sous Windows, cliquez avec le bouton droit sur une zone vide et choisissez Ouvrir dans le terminal, puis choisissez PowerShell si nécessaire. Sur macOS, ouvrez le terminal, tapez cd suivi d'un espace, faites glisser le dossier dans le terminal et appuyez sur Entrée. Le terminal fonctionne maintenant dans ce dossier.

Dans la première commande ci-dessous, remplacez YOUR_COPIED_HTTPS_ADDRESS par l'adresse HTTPS que vous venez de copier. Exécutez une ligne à la fois. La première ligne crée un nouveau dossier nommé supastack ; la deuxième ligne y entre. Si Git vous demande de vous connecter, complétez la connexion au navigateur. N'utilisez pas le mot de passe de votre compte GitHub comme mot de passe Git. Si la connexion au navigateur n'est pas disponible, suivez le guide d'authentification HTTPS de GitHub lié ci-dessous.

Succès : le dossier supastack contient package.json, pnpm-workspace.yaml, apps et packages. Un checkout Desktop n'affiche que le shell desktop dans apps ; le monorepo All Platforms affiche aussi les applications web et mobile. C'est la racine du dépôt. Si Git indique que la destination existe déjà, utilisez un autre dossier vide ou ouvrez le clone existant ; ne supprimez pas votre travail. Gardez ce terminal ouvert pour l'étape suivante.

Aide à l'authentification GitHub HTTPS

git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack

6. Vérifiez Corepack et le gestionnaire de packages épinglé

Exécutez la première commande ci-dessous. Corepack sélectionne la version pnpm enregistrée dans package.json ; pnpm télécharge les bibliothèques utilisées par le projet. Si Corepack demande la permission de télécharger cette version, tapez y et appuyez sur Entrée. Cette vérification épingle pnpm 11.19.0 ; conservez son code PIN plutôt que de choisir un autre gestionnaire de paquets.

Si le corepack est manquant, exécutez npm install --global corepack, rouvrez votre terminal et réessayez. Si PowerShell indique qu'un script npm.ps1 ou corepack.ps1 ne peut pas s'exécuter, utilisez npm.cmd ou corepack.cmd pour cette commande, y compris corepack.cmd pnpm install. Vous n'avez pas besoin de modifier la politique d'exécution de votre ordinateur.

Les commandes filtrées de première exécution appellent directement Corepack. Si vous utilisez une commande Turbo telle que corepack pnpm dev, Turbo a également besoin d'une commande pnpm sur PATH. La configuration de Windows ci-dessous crée cette commande dans un dossier accessible en écriture par l'utilisateur ; son changement PATH ne dure que pour le terminal actuel. Exécutez à nouveau ce bloc après avoir ouvert un nouveau terminal si pnpm est manquant. Sous macOS/Linux, exécutez corepack enable ; s'il signale une erreur d'autorisation, utilisez plutôt la commande filtrée de première exécution.

Apprenez à exécuter une commande et à modifier un fichier

corepack --version
corepack pnpm --version

# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"

7. Installez Rust et les outils de build natifs

Sous Windows, installez Microsoft C++ Build Tools à l’aide du lien des conditions préalables Tauri ci-dessous. Dans son programme d'installation, sélectionnez Développement de bureau avec C++, conservez Windows SDK sélectionné et terminez l'installation. Assurez-vous que le runtime Microsoft Edge WebView2 est installé. Installez Rust à partir de rustup.rs à l'aide de rustup-init.exe ; conserver la chaîne d'outils MSVC par défaut. Rouvrez votre terminal après l'installation.

Sur macOS, exécutez xcode-select --install dans Terminal et complétez la boîte de dialogue des outils de ligne de commande s'ils ne sont pas installés. Installez Rust à l'aide de la commande macOS de rustup.rs. Sous Linux, suivez la page des prérequis Tauri pour connaître les packages WebKitGTK, compilateur, plateau et bibliothèque système de votre distribution exacte, puis installez Rust. Les noms des packages Linux varient ; n'exécutez pas les commandes d'une autre distribution.

Ouvrez un terminal à la racine du référentiel et exécutez les vérifications de version ci-dessous. rustc et cargo doivent imprimer des versions ; cargo est l'outil de construction de Rust. Si l’un ou l’autre est manquant, terminez l’installation et rouvrez le terminal avant de continuer.

rustc --version
cargo --version

8. Continuer avec les guides Desktop

Vous êtes prêt lorsque Node et Git affichent des versions, que Corepack peut sélectionner le pnpm épinglé, que rustc et cargo affichent des versions et que votre terminal se trouve dans le dossier contenant package.json. Choisissez un tutoriel ci-dessous.