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

Introduction

Ce qu'est supastack, ce que vous obtenez et le chemin vers une app qui tourne.

Poser une question sur ce guide

Commencez ici : ce que vous avez reçu

Le kit est une application de démarrage que vous pouvez personnaliser. Web est l'interface du navigateur et le serveur API ; Le mobile est l'interface du téléphone ; Desktop est une fenêtre native affichant l’application Web. Un API est l'adresse du serveur qu'un client appelle pour se connecter ou lire des données. Les packages partagés sont des éléments réutilisables utilisés par ces applications.

Commencez par le didacticiel Web local ci-dessous. Il vous indique exactement comment télécharger des bibliothèques, démarrer le serveur et exécuter un faux AI task. Ajoutez ensuite la base de données des comptes enregistrés, choisissez uniquement les fournisseurs dont votre produit a besoin, personnalisez votre marque et préparez l'hébergement. Vous pourrez lire les explications techniques plus tard ; ce ne sont pas des conditions préalables pour ouvrir la première démo.

Construire sur une base commune

supastack est une base modulaire pour les produits SaaS intégrant l’IA, sur le web, mobile et ordinateur. Next.js gère l’interface et l’API web, Expo fournit des parcours natifs de référence, et le shell de bureau Tauri charge la même application web. Les packages partagés prennent en charge l’identité, les espaces de travail, la facturation, l’IA, les tâches, les e-mails, le stockage et l’observabilité.

Commencez par le parcours local de référence pour comprendre comment les modules s’articulent. Configurez les fournisseurs de production seulement une fois que ce parcours fonctionne dans votre environnement.

Se repérer

Les applications assemblent les packages partagés. Les fonctionnalités propres à un produit appartiennent à la base de code qui le consomme, et non au noyau réutilisable.

apps/
  web/       Next.js interface and API routes
  mobile/    Expo application
packages/
  auth/      Identity and sessions
  db/        Schema and workspace persistence
  billing/   Billing and entitlements
  ai/        Providers, routing, and usage
  jobs/      Background job contract
  email/     Transactional delivery

Choisir par où commencer

Commencez par la configuration locale en cinq minutes. Suivez ensuite le lien Continuer la configuration en bas de chaque guide : configurez la base de données, l’authentification, les offres et les fournisseurs avant de préparer le déploiement. Consultez l’index complet de la documentation pour trouver chaque fonctionnalité, fournisseur, composant et référence.

Le parcours local de référence a réussi dans l’environnement de développement du projet. La durée d’installation à partir d’un clone propre, les tests réels des fournisseurs, le déploiement et la validation sur appareil physique restent des étapes distinctes.

Apprenez à naviguer dans cette documentation et retrouvez les termes inconnus dans le glossaire

Bienvenue dans supastack

supastack est un kit modulaire pour produits SaaS IA : une application web Next.js, une application mobile Expo et un shell bureau Tauri, tous construits sur des packages TypeScript partagés pour l'auth, la facturation, l'IA, les jobs, l'e-mail, le stockage et l'observabilité.

Après l'achat, vous recevez une invitation GitHub vers les dépôts du kit — web, mobile et desktop (le bundle All Platforms livre le monorepo complet). Clonez la surface que vous livrez et appropriez-la-vous.

Cette documentation est un parcours pas à pas, pas un empilement de référence : faites d'abord tourner l'app en local, puis suivez les pages de configuration des fournisseurs dans l'ordre. Chaque page se termine en pointant vers la suivante.

Démarrez un serveur local

Il vous faut Node.js 22 ou plus récent. Le dépôt épingle son gestionnaire de paquets (packageManager: [email protected]), donc lancez pnpm via Corepack — aucune installation globale requise.

1. Copiez le fichier d'environnement pour créer votre configuration locale.

2. Installez les dépendances du workspace.

3. Démarrez éventuellement le conteneur Postgres local pour une vraie persistance — les valeurs par défaut fonctionnent sans lui.

4. Démarrez le serveur de dev et ouvrez http://localhost:3000.

cp .env.example .env
corepack pnpm install
docker compose up -d postgres   # optional local database
corepack pnpm dev

# → http://localhost:3000

Le fichier .env

Les paramètres d'environnement choisissent le service local ou hébergé utilisé par le kit. Copiez .env.example vers la racine .env pour les migrations et vers apps/web/.env.local pour le serveur Web. Expo utilise apps/mobile/.env.local. La copie uniquement de root .env ne configure pas toutes les applications.

Les faux fournisseurs locaux par défaut n'ont pas besoin d'informations d'identification API payantes. Ils vous permettent de réaliser la démonstration en mémoire/tableau de bord ; la véritable connexion à /auth nécessite toujours PostgreSQL et des migrations. Pour un vrai fournisseur, modifiez uniquement ses paramètres nommés dans le fichier de configuration Web, enregistrez, puis arrêtez et redémarrez le serveur. N'exposez jamais de secrets via les valeurs NEXT_PUBLIC_ ou EXPO_PUBLIC_.

Choisissez votre voie

Nouveau ici ? En ligne en 5 minutes vous mène du clone à une app qui tourne avec les seuls défauts.

Vous construisez pour téléphone ou bureau ? Les onglets Mobile et Bureau couvrent les surfaces Expo et Tauri. Une fois l'app lancée, le groupe Configurer les fournisseurs parcourt chaque intégration doc par doc.

Pour poursuivre la configuration, consultez En ligne en 5 minutes.