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/web/before-you-start.md (or send Accept: text/markdown).
Avant de commencer
Installez Node.js, Git et un éditeur, acceptez l'invitation de votre référentiel, téléchargez le kit et vérifiez que votre ordinateur est prêt pour la première exécution.
1. Choisissez ce que vous souhaitez exécuter
Utilisez un ordinateur Windows, macOS ou Linux avec une connexion Internet. Un navigateur exécute l'application Web ; un téléphone exécute l'application mobile ; l'application de bureau s'ouvre dans sa propre fenêtre. Votre téléphone seul ne peut pas effectuer les étapes d'installation ci-dessous.
Un référentiel est le dossier de fichiers que vous avez reçus via GitHub. Les achats Web, Mobile et Desktop fournissent chacun le référentiel de kits correspondant ; le bundle Toutes plates-formes fournit le monorepo, un dossier contenant les trois applications. Acceptez l'invitation pour le référentiel que vous avez acheté. Une caisse mobile ou de bureau nécessite toujours un backend Web accessible : le serveur qui gère les comptes et les données. Ces référentiels clients n'incluent pas le serveur Web.
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.
node --version
npm --version3. 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 --version4. 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, des applications et des packages. Il s'agit de la racine du référentiel. 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.
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack6. 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.
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. Continuez avec votre plateforme
Vous êtes prêt lorsque les versions d'impression de Node et Git, Corepack peuvent sélectionner le pnpm épinglé, et votre terminal se trouve dans le dossier contenant package.json. Choisissez un tutoriel ci-dessous. Docker est facultatif pour la démonstration Web ; une base de données est requise ultérieurement pour les comptes réels. Desktop a également besoin de Rust et d'outils de construction natifs, ce que son didacticiel explique avant sa commande de lancement.