Aller au contenu
supastack
Parcourir la documentation
WebNext.js

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

Stack technique

Les technologies derrière le kit et le rôle de chacune.

Poser une question sur ce guide
Ouvrir dans

Avant de commencer

Ouvrez votre projet supastack téléchargé dans Visual Studio Code en utilisant Fichier → Ouvrir le dossier, puis choisissez Terminal → Nouveau terminal. La racine du référentiel est le dossier contenant package.json, les applications et les packages. Exécutez la commande ci-dessous et laissez son terminal ouvert. Si une commande n'est pas reconnue, terminez le guide d'installation de l'outil avant de continuer.

Lisez d’abord le didacticiel de la plateforme. Un serveur est le processus d'application qui répond aux requêtes du navigateur ou du téléphone. Le Web lit apps/web/.env.local, Expo lit apps/mobile/.env.local et les commandes de migration de base de données lisent root .env. La démonstration sans base de données/tableau de bord est distincte des comptes réels/auth, qui nécessitent une migration Postgres. Un paiement sur téléphone ou sur ordinateur uniquement nécessite un backend Web exécuté séparément.

corepack pnpm --filter @supastack/web dev

Stack applicatif

L'application web est une application Next.js composée de packages TypeScript partagés — les mêmes packages alimentent l'application mobile Expo. Le chrome produit utilise des modules CSS sur des design tokens, il n'y a donc pas de CSS-in-JS runtime à déboguer, et le stockage d'objets est compatible S3. Les outils ci-dessous sont les choix par défaut assumés.

Next.js + React

L'application web fonctionne avec Next.js 16, l'App Router et les server components de React 19.

TypeScript + Turborepo

Le mode strict de TypeScript s'applique à tout l'espace de travail pnpm, et Turborepo coordonne les builds.

Better Auth

Better Auth est le moteur d'identité ; un moteur Auth.js est disponible pour les équipes qui s'y standardisent.

Drizzle + PostgreSQL

La persistance passe par l'ORM Drizzle sur PostgreSQL — le schéma et les helpers par lesquels chaque enregistrement transite.

Facturation

La facturation Stripe est le défaut, et un adaptateur Lemon Squeezy est inclus.

Trigger.dev

Les tâches en arrière-plan s'exécutent sur Trigger.dev.

E-mail transactionnel

Les e-mails transactionnels sont envoyés via Resend ou AWS SES.

Sentry + PostHog

L'observabilité passe par Sentry et PostHog.

Expo

L'application mobile Expo consomme les mêmes packages TypeScript, donc les changements de contrat se vérifient sur les deux surfaces à la fois. Expo livre pour iOS et Android.

Modules partagés

Chaque capacité transverse vit dans un package avec un petit contrat : auth, db, billing, ai, jobs, email, storage, observability, config, i18n et api. Les applications les composent ; la logique métier du produit reste hors du kit.

Chaque module adossé à un fournisseur embarque un adaptateur fake ou local pour que la boucle de test et de développement par défaut n'appelle jamais un service payant.

Outillage de vérification

Vitest couvre le comportement unitaire et d'intégration, Playwright les flux navigateur, et ESLint plus Prettier gardent le code cohérent. La suite déterministe tourne sans identifiants fournisseur ; l'acceptation avec vrais fournisseurs est un chemin séparé et conditionné.

corepack pnpm test          # deterministic unit + integration
corepack pnpm check         # lint, types, tests, format
corepack pnpm build         # production builds
corepack pnpm test:e2e      # browser flows

Questions fréquentes

14 questions

Qu'est-ce que supastack ?

supastack est une fondation modulaire pour construire des produits SaaS avec IA. Elle réunit l'infrastructure commune pour que vous puissiez vous concentrer sur les fonctionnalités propres à votre produit.

Prend-il en charge le web et le mobile ?

Oui. supastack inclut des applications Next.js et Expo comme points de départ pour des expériences web et mobile.

Quelle authentification est incluse ?

Better Auth couvre e-mail/mot de passe, OTP et connexion sociale. Les espaces de travail personnels sont provisionnés avec le compte pour que les enregistrements restent délimités dès le premier jour.

Comment l'IA est-elle prise en charge ?

supastack inclut une IA multi-fournisseurs configurable, le suivi d'usage, des budgets, et la prise en charge chiffrée de vos propres clés (BYOK).

Comment les abonnements sont-ils gérés ?

Pour les produits construits sur le kit, la facturation Stripe, les abonnements et les droits d'accès forment la base de l'accès payant. Les secrets fournisseur restent côté serveur.

Où vit le code propre à mon produit ?

Les fonctionnalités propres au produit restent dans un codebase séparé, tandis que le produit configure et intègre les modules de la fondation supastack.

Comment fonctionne la tarification de supastack ?

Le kit est un achat unique avec mises à jour à vie : Un framework à 249 $ (prix de lancement temporaire — 100 $ de réduction par rapport au prix habituel de 349 $) ou Tous les frameworks (Next.js, iOS, Android) à 499 $ (prix de lancement temporaire — 100 $ de réduction par rapport au prix habituel de 599 $), plus 75 $ par siège développeur supplémentaire. Pas d'abonnement au kit. Le paiement sur ce site livre votre clé de licence par e-mail, avec accès au dépôt via invitation GitHub.

Comment les espaces de travail délimitent mes données ?

Les enregistrements appartenant aux utilisateurs sont délimités par workspaceId. Identité, droits d'accès, usage IA, événements de facturation et entrées d'audit restent dans le périmètre de l'espace personnel.

Comment fonctionnent les jobs en arrière-plan ?

Trigger.dev est le runtime de jobs explicite. Le contrat JobRunner ne promet que enqueue, status et cancel — la sémantique de workflow reste propre à Trigger.dev et explicite.

En quoi l'e-mail diffère-t-il de la prospection ?

L'e-mail transactionnel couvre les flux produit comme les avis de fin de tâche. La prospection à froid et les campagnes relèvent du produit, hors du module e-mail de ce kit.

Comment fonctionnent les achats sur mobile ?

Le mobile inclut les achats natifs et leur restauration via RevenueCat, avec un accès vérifié par votre serveur. Configurez les comptes des boutiques et terminez les tests sur appareil avant publication. La facturation web reste séparée.

Où vivent les clés des fournisseurs IA ?

Les identifiants BYOK sont chiffrés et restent côté serveur. Les clés sont masquées dans les journaux ; l'usage et les budgets restent visibles au niveau de l'espace de travail.

Quels moyens de paiement le checkout accepte-t-il ?

Le checkout hébergé par Stripe accepte les cartes et peut aussi proposer Alipay et WeChat Pay une fois ces portefeuilles activés sur le compte Stripe — pratique pour les acheteurs en Chine. Les autorisations de portefeuille se confirment de manière asynchrone : la page de licence se met à jour dès que le paiement est validé.

Puis-je obtenir un remboursement ?

Une fois que vous avez accès au dépôt, supastack vous appartient pour toujours et ne peut donc pas être remboursé. Mais rassurez-vous : vous obtenez le code source complet avec des mises à jour à vie pour créer et déployer un nombre illimité de produits pour vous ou vos clients. Vous ne pouvez simplement pas revendre le code ni redistribuer le dépôt sous forme de kit de démarrage ou de modèle.

FR
Thème