> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Stack technique

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

## 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.

[Installez les outils et récupérez le code](https://supastack.dev/fr/docs/web/before-you-start.md)

[Apprendre les commandes, les fichiers et la configuration](https://supastack.dev/fr/docs/web/terminal-basics.md)

[Terminez le didacticiel Web de première exécution](https://supastack.dev/fr/docs/web/ship-in-5-minutes.md)

```
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](https://nextjs.org) 16, l'App Router et les server components de [React](https://react.dev) 19.

- [Next.js](https://nextjs.org)
- [React](https://react.dev)


## TypeScript + Turborepo

Le mode strict de [TypeScript](https://www.typescriptlang.org) s'applique à tout l'espace de travail pnpm, et [Turborepo](https://turborepo.com) coordonne les builds.

- [TypeScript](https://www.typescriptlang.org)
- [Turborepo](https://turborepo.com)


## Better Auth

[Better Auth](https://better-auth.com) est le moteur d'identité ; un moteur Auth.js est disponible pour les équipes qui s'y standardisent.

- [Better Auth](https://better-auth.com)


## Drizzle + PostgreSQL

La persistance passe par l'ORM [Drizzle](https://orm.drizzle.team) sur [PostgreSQL](https://www.postgresql.org) — le schéma et les helpers par lesquels chaque enregistrement transite.

- [Drizzle](https://orm.drizzle.team)
- [PostgreSQL](https://www.postgresql.org)


## Facturation

La facturation [Stripe](https://stripe.com) est le défaut, et un adaptateur [Lemon Squeezy](https://www.lemonsqueezy.com) est inclus.

- [Stripe](https://stripe.com)
- [Lemon Squeezy](https://www.lemonsqueezy.com)


## Trigger.dev

Les tâches en arrière-plan s'exécutent sur [Trigger.dev](https://trigger.dev).

- [Trigger.dev](https://trigger.dev)


## E-mail transactionnel

Les e-mails transactionnels sont envoyés via [Resend](https://resend.com) ou AWS SES.

- [Resend](https://resend.com)


## Sentry + PostHog

L'observabilité passe par [Sentry](https://sentry.io) et [PostHog](https://posthog.com).

- [Sentry](https://sentry.io)
- [PostHog](https://posthog.com)


## Expo

L'application mobile [Expo](https://expo.dev) 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.

- [Expo](https://expo.dev)


## 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
```


## Suivant

[Installation locale](https://supastack.dev/fr/docs/web/local-setup.md)