Développement local · Documentation

Starter ProDéveloppement local

L’environnement local doit être réelLien vers la section

Starter Pro est conçu de manière à ce que le développement local valide un comportement SaaS réaliste au lieu de pages de démonstration déconnectées.

L’environnement local soutient :

Authentification
facturation
Routes protégées
Prisma
Stripe
Comportement PWA
workflows adaptées à la production

Commencez à partir d'un environnement local adaptées à la production.

Validez l'authentification, la facturation, l'expérience utilisateur mobile et l'infrastructure de produit avant d'écrire la logique de domaine.

Premiers pas

Paiement unique — Accès instantané après achat

Principe de base

Le développement local devrait valider l'infrastructure de produit, pas seulement la composition de l'interface utilisateur.

Pourquoi cela compteLien vers la section

De nombreux produits SaaS deviennent difficiles à mettre à l’échelle car les environnements de développement locaux ne reflètent jamais le comportement réel de la production.

Cela crée généralement :

Flux d'auth incohérents
Facturation
Onboarding cassé
Hypothèses de déploiement dangereuses
régressions UX mobiles
Configuration de l'environnement fragile

Starter Pro est structuré pour réduire cette dérive opérationnelle dès le début.

local-development-model.txt

Local setup
  ↓
Environment variables
  ↓
Database
  ↓
Auth
  ↓
Billing
  ↓
Protected routes
  ↓
PWA behavior
  ↓
Production confidence

Aperçu de la production

Une configuration locale forte n'est pas seulement une question de commodité. C'est la première porte de sortie pour votre infrastructure de produits.

Modèle mentalLien vers la section

Couche infrastructure

The infrastructure layer includes environment variables, database access, local services, and development scripts.

EnvironmentPostgreSQLPrisma

Infrastructure incluseLien vers la section

Authentification

Auth, les fournisseurs OAuth, les sessions et le routage protégé.

Facturation

Infrastructure de facturation Stripe-ready et flux sensibles aux abonnements.

Base de données

Environnement de développement PostgreSQL alimenté par Prisma.

PWA

Comportement des applications installables, routage hors ligne, zones sécurisées et tests autonomes.

Débit de configuration recommandéLien vers la section

Installer les dépendancesLien vers la section

pnpm install

Configurer les variables d'environnementLien vers la section

cp .env.example .env.local

Démarrage de l'infrastructureLien vers la section

pnpm db:up

Semer et migrerLien vers la section

pnpm app:setup

Lancer le développementLien vers la section

pnpm dev

Liste de contrôle du développement localLien vers la section

Requis

Validation des infrastructures

Confirmez que l'environnement local est prêt avant de personnaliser la logique du produit.

Dépendances installées
Variables d'environnement configurées
base de données en cours d'exécution
Client Prisma généré
données d’exemple terminées

Requis

Validation du produit

Confirmez que Starter Pro se comporte comme un vrai SaaS localement.

auth flows travail
affichage des routes de facturation
les pages de paramètres fonctionnent
pages protégées rediriger correctement
Travaux de secours PWA

Liste de contrôle de validation recommandéeLien vers la section

Valider :

Flux d'authentification
routes de facturation
Pages protégées
réactivité mobile
Installabilité PWA
comportement de secours hors ligne
Réglages des surfaces
les données d’exemple locales

Principe de validation

Validez les flux de produits réels localement avant de les personnaliser en profondeur.

Erreurs courantesLien vers la section

Environnements de démonstration uniquement

Tester des pages isolées sans valider le comportement réel de l'authentification ou de la facturation.

Sauter la validation mobile

Ignorer le mode autonome, les zones de sécurité et le comportement de navigation mobile.

Environnement Drift

Laissez les variables locales, de mise en scène et de production diverger sans documentation claire.

Validation différée

La personnalisation en profondeur avant de confirmer le fonctionnement des flux de produits par défaut.

Explorez la démo isoléeLien vers la section

Lors d'un déploiement de démonstration, /demo offre trois points d'entrée guidés. Tous les trois utilisent le même espace de travail privé et temporaire, de sorte que le changement de parcours conserve les projets et les changements d'équipe du visiteur.

Découvrir le tableau de bord

Explorez des graphiques remplis, créez un projet et examinez l'activité d'espace de travail résultante.

Collaborer avec une équipe

Invitez un coéquipier — example.invalid, simulez des rôles de membre et gérez-les à l'aide du service d'espace de travail.

Prévisualiser la facturation

Passez en revue, annulez, confirmez et redémarrez un aperçu de plan clairement étiqueté dans Facturation, sans entrer les détails de paiement.

Un aperçu du plan, pas un test de paiement

Free to Pro s'exécute localement dans le navigateur et se réinitialise en quittant la facturation ou le rechargement. Il ne crée aucun abonnement ou droit payé et ne modifie aucune permission de démonstration ou quota. La validation de la démo publique, le portail et les points de terminaison de webhook restent bloqués sur le serveur. Vérifiez la validation Stripe et les webhooks réels dans un environnement de test distinct en utilisant le guide de facturation.

Les inclus DEMO.md documents dédiés à la configuration de la base de données, aux invitations simulées, à l'expiration des visiteurs et au nettoyage. Les liens publics dépendent d'un déploiement de démonstration vérifié; ils ne sont pas activés par ces seules instructions locales.

Les recette d'entreprise pas à pas vous donner des scénarios concrets de projet, de tâche et de commentaire à essayer avec des données fictives. Conservez l'accès à leur espace de travail, archivez et rechargez les contrôles lors de l'adaptation de l'interface.

Préférez/évitezLien vers la section

Préférez

valider l'auth avant la personnalisation du produit
facturation de test localement avec le mode de test Stripe
utiliser des seed fixtures pour les états reproductibles
Tester le comportement mobile et autonome
Conserver les variables d'environnement documentées

Éviter

personnalisation avant la validation de l'installation
Tester uniquement les pages statiques
Sautez des routes protégés
Utiliser les secrets de production localement
Ignorer le comportement PWA safe-area

Variables d'environnementConfigurez l'authentification, la facturation, la base de données et l'infrastructure en toute sécurité.DéploiementDéployez Starter Pro avec une infrastructure prête à la production.Jeux de données de testValider les états de compte réalistes et les flux d'intégration.Configuration PWAValider l'installabilité locale et le comportement mobile de type app.Procédures pas à pas de recette d'affairesEffectuer le suivi des clients, les demandes de support et la validation interne avec des enregistrements fictifs.Personnalisation et mises à niveauGardez les modifications de configuration et les adaptations de domaine révisables.