Documentation

Référence de configuration

Carte rapide des fichiers de configuration dans src/features/dashboard/config, src/lib et src/features.

Ouvrir dansChatGPT (s’ouvre dans un nouvel onglet)Claude (s’ouvre dans un nouvel onglet)Cursor (s’ouvre dans un nouvel onglet)Carte rapide des fichiers de configuration dans src/features/dashboard/config, src/lib et src/features.

Motoko Base garde les secrets dans les variables d’environnement et les choix produit dans des fichiers de configuration TypeScript. Cette page est un index rapide — les détails sont dans Configuration et les docs d’intégration.

Configuration à la racine (hors de src/)

FichierObjectif
.env.exampleModèle de variables d’environnement
drizzle.config.tsDrizzle Kit — chemin du schema, sortie des migrations
next.config.tsNext.js + MDX + wrapper de build Sentry
source.config.tsCollections MDX Fumadocs
openspec/config.yamlContexte agent IA et règles OpenSpec

src/features/dashboard/config/

Configuration transverse de l’app (non liée à une seule feature).

FichierContrôle
nav.ts (and settings-nav.ts for settings)Éléments de la sidebar dashboard, nav settings, titres de page, état actif

src/lib/

Infrastructure partagée. Modules de config d’intégration et points d’entrée principaux :

CheminContrôle
lib/auth/auth.tsSetup Better Auth (providers, vérification, hooks e-mail)
lib/auth/social.tsVérifications « configured » Google/GitHub
lib/db/index.tsClient Postgres (prepare: false, réglages du pool)
lib/db/schema/Définitions de tables Drizzle
lib/billing/config.tsId du provider, IDs de plan, gating feature→plan
lib/billing/index.tsAPI billing publique (checkout, hasPlan, canAccess)
lib/email/config.tsLecteurs d’env Resend
lib/analytics/config.tsHosts PostHog et contrôles d’activation
lib/analytics/events.tsTaxonomie des noms d’événements
lib/monitoring/config.tsRègles d’activation Sentry, échantillonnage des traces
lib/r2.tsClient R2, URLs présignées, parsing bucket/prefix

Deep-dives README : lib/db/README.md, lib/email/README.md, lib/monitoring/README.md, lib/security/README.md.

src/features/

Config locale de feature — limites, labels, contenu marketing :

FichierContrôle
features/marketing/config.tsLanding — hero, nav, features, pricing, FAQ, footer
lib/billing/config/plans.tsLabels et listes de features des plans Free/Pro (UI billing)
features/dashboard/config/preferences.tsOptions thème/langue
features/dashboard/schemas/security.tsRègles de longueur de mot de passe
features/dashboard/lib/avatar.tsLimites de taille et MIME de l’avatar
features/dashboard/config/notifications.tsValeurs par défaut des notifications
features/links/config.tsPagination de la liste de links (LINKS_PAGE_SIZE)
features/storage/config.tsTaille d’upload, allowlist MIME, pagination
features/ai-email/config.tsOptions ton/longueur/langue, longueur max de l’e-mail

Les features sans config.ts suivent le même schéma de dossiers (components/, actions.ts, queries.ts, schemas.ts) — les fichiers de config apparaissent quand une feature a des constantes ajustables.

Métadonnées du site

FichierContrôle
src/app/layout.tsxTemplate de titre SEO racine, defaults Open Graph
src/app/(marketing)/(site)/page.tsxMétadonnées de la landing
src/lib/email/templates/shared.tsxNom de marque dans les e-mails

Règles rapides

  • Variables d’environnement → secrets et identifiants de services externes (Environment Variables)
  • src/features/dashboard/config/ → nav dashboard et settings
  • src/lib/*/config.ts → logique d’activation des intégrations et defaults
  • src/features/*/config.ts → limites de feature et copy d’affichage
  • Ne pas mettre de clés API dans les fichiers de configuration TypeScript

Configuration — Comment modifier nav, billing et métadonnées.

Environment Variables — Référence complète des env.