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

Thème du produit

Personnalisez le chrome du produit SaaS du kit sans modifier le thème de marque marketing.

Poser une question sur ce guide
Ouvrir dans

Configuration et paramètres

Avant toute étape, lisez Avant de commencer et Principes de base du terminal. Ces instructions supposent que vous avez ouvert le monorepo supastack complet dans VS Code ; sa racine package.json marque la racine du référentiel. Dans les commandes pnpm, un package d'espace de travail est une application ou un dossier de code partagé ; dans le produit, un espace de travail est le conteneur de données et la limite de sécurité d'une équipe. corepack pnpm --filter ... sélectionne un package dans le monorepo tandis que les commandes sont exécutées à partir de sa racine. Si vous avez ouvert uniquement un dossier mobile ou de bureau synchronisé, il ne contient pas le backend Web, la configuration Docker ou les scripts racine : exécutez le backend à partir de ce monorepo ou d'un serveur hébergé accessible et utilisez les propres scripts du dossier de plateforme. Une variable d'environnement est un paramètre nommé stocké dans un fichier .env local ou dans votre tableau de bord d'hébergement ; redémarrez l'application concernée après l'avoir modifiée et conservez les secrets du serveur en dehors des valeurs NEXT_PUBLIC_ et EXPO_PUBLIC_.

1. Dans VS Code, ouvrez apps/web/app/app-theme.css pour les écrans de produits connectés et apps/web/src/theme/catalog.ts pour ajouter un pack de couleurs. Ne modifiez pas apps/web/app/theme.css pour les couleurs du produit ; il contrôle la marque marketing.

2. À partir de la racine du référentiel, exécutez corepack pnpm --filter @supastack/web dev, puis visitez http://localhost:3000/settings/appearance..

3. Modifiez un jeton dans votre succursale locale et actualisez l'aperçu. Attendu : le tableau de bord contrôle la mise à jour tandis que la page d'accueil conserve son thème marketing sélectionné.

Le thème de marque marketing et le thème produit se trouvent dans des fichiers distincts. Modifiez apps/web/app/app-theme.css pour le tableau de bord, l’authentification, les paramètres, la facturation, le chat et le chrome des organisations. Ajoutez des palettes dans apps/web/src/theme/catalog.ts. Étendez les axes de densité, rayon, police et disposition dans apps/web/src/theme/presets.ts ainsi que les règles html[data-*] correspondantes dans app-theme.css. Choisissez l’identité marketing dans apps/web/src/theme/marketing-theme.ts (MARKETING_THEME_MODE: locked | inherit | a pack id) au lieu de modifier apps/web/app/theme.css : son verrou .marketing-theme:not(.app-theme):not([data-theme]):not([data-marketing-theme=\"inherit\"]) conserve par défaut la marque Obsidian de la page d’accueil supastack.

À l’exécution, Paramètres → Apparence → ThemePicker enregistre la couleur, la densité, le rayon, la police et la disposition dans un cookie navigateur + localStorage afin que theme-boot.ts restaure tous les axes avant le premier affichage, et synchronise le lot complet d’apparence de l’utilisateur connecté entre les navigateurs via user_appearance (GET/PUT /api/account/appearance). La même page monte la galerie UI du kit pour que les packs et préréglages mettent à jour en direct boutons, champs, cartes, badges et boîtes de dialogue. Les détails de conception et exemples prêts à copier se trouvent dans docs/design/kit-product-theme.md et docs/design/kit-ui-gallery.md.

/* Edit product chrome here — not theme.css */
.app-theme {
  --radius-card: 14px;
  background: var(--page);
  color: var(--text);
}
.app-theme .button-primary {
  background: var(--accent);
  color: var(--accent-ink);
}

/* catalog.ts — append a ThemeDefinition with every THEME_TOKEN_NAMES entry */
{
  id: "coral",
  name: "Coral",
  colorScheme: "light",
  tokens: { "--page": "#fff7f4", "--accent": "#e06b4f" /* …full token set… */ }
}

Commandes à copier

Suivez les commentaires pour voir dans quel dossier une commande s'exécute. Si deux terminaux sont étiquetés, ouvrez deux fenêtres de terminal et laissez la première commande s'exécuter pendant que vous utilisez la seconde.

corepack pnpm --filter @supastack/web dev

# In a second terminal, after changing a theme token:
corepack pnpm test -- apps/web/src/theme/contrast.test.ts

Processus d’implémentation

Dans les consommateurs de l’application (app-theme.css, alias de globals.css, routes WorkspaceShell), préférez var(--page|--section|--raised|--text|--muted|--border|--accent|…). Ne réintroduisez pas de cadres turquoise ou hexagonaux pâles et ne codez pas en dur les hexadécimaux Obsidian dans l’interface du produit.

Lors de l’ajout d’une palette, maintenez contrast.test.ts au vert. Lors de l’ajout d’un identifiant de préréglage, mettez à jour presets.ts et les correspondances html[data-density|data-radius|data-font|data-layout] dans app-theme.css afin que ThemePicker et le démarrage anti-FOUC restent cohérents.

Conservez la géométrie partagée du logo à quatre tuiles dans marketing/brand-geometry.ts pour les surfaces marketing. Les marques d’en-tête restent transparentes ; les favicons et icônes d’application gardent leur fond noir arrondi. Les pages purement marketing restent Obsidian lorsque MARKETING_THEME_MODE vaut \"locked\" (valeur par défaut du kit) ; les produits peuvent épingler une autre palette ou reprendre le choix du visiteur.

Vérification et dépannage

Si un changement de couleur affecte la page d'accueil marketing, vérifiez que vous avez modifié app-theme.css et examinez apps/web/src/theme/marketing-theme.ts.. Si le texte devient difficile à lire, restaurez la valeur précédente et exécutez corepack pnpm test -- apps/web/src/theme/contrast.test.ts à partir de la racine avant de réessayer.

Après une modification des jetons ou palettes du thème du kit, vérifiez que ThemePicker dans /settings/appearance actualise la galerie UI du kit ainsi que les cadres /dashboard, /auth, /billing, /chat et organisation. Confirmez que / conserve le verrou marketing Obsidian, sauf indication contraire de MARKETING_THEME_MODE. Exécutez les contrats unitaires du thème (catalogue, préréglages, contraste, propriété du thème, galerie UI) et les tests Playwright application-theme si disponibles. Vérifiez le focus clavier, le contraste, 320px et la réduction du mouvement.

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