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/ship-in-5-minutes.md (or send Accept: text/markdown).
En ligne en 5 minutes
Exécutez la démonstration Web sur votre ordinateur avec des commandes Windows et macOS exactes, sans informations d'identification de fournisseur payant et un chemin clair vers de vrais comptes sauvegardés sur une base de données.
1. Préparez votre ordinateur et ouvrez le projet
Terminez d'abord 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 premier niveau de l'éditeur. Toutes les commandes ci-dessous s'exécutent depuis 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.
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 install2. 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 install3. 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 dev4. 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.
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.