Installation locale

1. Préparez votre ordinateur et ouvrez le projet

Première étape Avant de commencer : acceptez l'invitation GitHub, installez Node.js 22 ou plus récent, Git, un éditeur et Corepack, puis clonez votre référentiel Web ou le monorepo Toutes Plateformes. Ouvrez le dossier supastack dans l'éditeur et sélectionnez Terminal → Nouveau terminal. Vous devriez voir package.json dans la liste des fichiers de niveau supérieur de l'éditeur. Toutes les commandes ci-dessous s'exécutent à partir de la racine de ce référentiel.

Cela démarre la démonstration locale sans comptes chez les fournisseurs d'IA, de facturation ou de messagerie et sans Docker. Prévoyez du temps supplémentaire pour les premiers téléchargements de dépendances. Suivez uniquement le bloc Windows ou uniquement le bloc macOS/Linux dans les étapes suivantes ; ne lancez pas les deux.

• Installez les outils et récupérez le code
• Apprenez à exécuter une commande et à modifier un fichier

2. Créez des fichiers de configuration — macOS / Linux

Dans votre terminal, exécutez chaque ligne ci-dessous. La première copie crée .env pour les commandes de migration ultérieures. La seconde crée apps/web/.env.local, que le serveur Web lit réellement. Les deux contiennent les paramètres locaux de l’exemple. Si l'un des fichiers de destination existe déjà, conservez-le et ignorez cette commande de copie ; n’écrasez pas les paramètres enregistrés. Les utilisateurs Windows utilisent plutôt la section suivante.

corepack pnpm install télécharge les bibliothèques dont l'application a besoin. Si Corepack demande de télécharger pnpm, répondez y. Attendez qu'il se termine et que l'invite du terminal revienne. Un message final Done sans erreur signifie que vous pouvez continuer.

cp .env.example .env
cp .env.example apps/web/.env.local
corepack pnpm install

2. Créer des fichiers de configuration — Windows PowerShell

Utilisez ces commandes dans PowerShell à partir du dossier contenant package.json. Si .env ou apps/web/.env.local existe déjà, ignorez sa ligne de copie et conservez vos paramètres. Attendez la fin de l'installation avant de démarrer le serveur. Si l'exécution du script est bloquée, utilisez corepack.cmd au lieu de corepack comme expliqué dans Avant de commencer.

Copy-Item .env.example .env
Copy-Item .env.example apps/web/.env.local
corepack pnpm install

3. Démarrez le serveur Web – laissez ce terminal ouvert

Exécutez la commande ci-dessous à partir de la racine du référentiel. Il démarre uniquement l'application Web, il fonctionne donc à la fois dans le référentiel Web uniquement et dans le monorepo toutes plates-formes. Attendez que le terminal affiche Local: http://localhost:3000 et Ready. La compilation de la première page peut prendre un peu plus de temps. Le terminal devrait continuer à fonctionner ; c'est prévu.

Dans le monorepo Toutes les plateformes, corepack pnpm dev démarre ensemble les espaces de travail de développement disponibles. Si apps/docs est présent, cette application de documentation distincte utilise http://localhost:3001.. Les guides publics que vous lisez font partie de l'application Web sur http://localhost:3000/docs.. Vous n'avez pas besoin du port 3001 pour suivre ce didacticiel.

corepack pnpm --filter @supastack/web dev

4. Ouvrez l'application et effectuez une tâche locale

Dans la barre d'adresse de votre navigateur, ouvrez http://localhost:3000 pour voir la page d'accueil. Ensuite, ouvrez http://localhost:3000/dashboard.. Conservez le nom et l'adresse e-mail pré-remplis, ou entrez vos propres valeurs de test, puis cliquez sur Start local reference flow. Cela crée un espace de travail de démonstration en mémoire ; il ne crée pas de compte persistant et n'envoie pas de véritable e-mail.

Dans la démonstration, ouvrez AI task à partir de la barre latérale, saisissez une courte requête telle que Résumer les critères d'acceptation locaux, puis cliquez sur Queue local task. Lorsque son statut est en file d'attente, cliquez sur Run local task, puis sur View result. Vous devriez voir une sortie terminée et un état Email queued. La réponse de l’IA est délibérément fausse et reproductible ; l'e-mail en file d'attente est local. Le redémarrage du serveur efface ces données de démonstration.

Pour utiliser /auth pour une véritable inscription, démarrez d'abord Postgres et appliquez les migrations à l'aide du guide Base de données et migrations. Après cela, les messages d'inscription ou OTP de EMAIL_PROVIDER=local peuvent être inspectés sur http://localhost:3000/mail-preview;, ils n'atteignent pas une boîte de réception externe. La connexion mobile utilise également cette authentification basée sur une base de données, plutôt que la session de démonstration.

• Ajouter Postgres et des comptes persistants

5. Arrêtez, redémarrez et résolvez les problèmes courants de première exécution

Le succès signifie que la page d'accueil se charge, que l'espace de travail local s'ouvre et qu'une tâche en file d'attente est terminée. Lorsque vous avez terminé, cliquez sur le terminal du serveur et appuyez sur Ctrl + C. Pour reprendre plus tard, rouvrez un terminal à la racine du référentiel et répétez la commande du serveur à partir de l'étape 3 ; vous ne réinstallez pas les dépendances à chaque fois.

Si localhost:3000 ne s'ouvre pas, vérifiez que le terminal serveur est toujours en cours d'exécution et affiche Ready. Si le port 3000 est utilisé, arrêtez l'autre serveur de développement avec Ctrl + C et réessayez. Si vous voyez une erreur de base de données après avoir ouvert /auth, revenez à /dashboard pour la démonstration ou complétez le guide de base de données. Si la démonstration locale est manquante, vérifiez APP_ENV=local, AI_PROVIDER=fake, BILLING_PROVIDER=local, EMAIL_PROVIDER=local et JOB_PROVIDER=local dans apps/web/.env.local, puis redémarrez.

Pour personnaliser le nom et le texte marketing, ouvrez apps/web/src/marketing/site-config.ts dans l'éditeur. Suivez Branding pour connaître les champs exacts et les étapes de vérification. Pour les paramètres d'apparence du compte réel, terminez d'abord la configuration de la base de données, puis ouvrez /settings/apparence. Les commandes d'acceptation automatisées prennent plus de temps que cette procédure pas à pas de première exécution ; recherchez-les sous les commandes de l'espace de travail.

• Corriger une erreur de première exécution
• Modifiez le nom et la copie de votre produit