Déploiement · Documentation

DémarrageDéploiement

Vue d’ensembleLien vers la section

L'exécution locale est la première étape. Déployer tôt est la deuxième étape.

Starter Free est intentionnellement simple à déployer car il ne nécessite pas encore de base de données, de secrets Auth, de clés Stripe ou de services backend.

L'objectif est d'obtenir une surface SaaS crédible en ligne rapidement afin que vous puissiez:

test de production construit
Partager une démo en direct
Valider la direction du produit
Préparer le chemin vers de vrais utilisateurs

Principe de déploiement

Déployez tôt. Fil progressivement. N'attendez pas que le backend existe avant de valider la surface du produit.

Ce que vous allez faireLien vers la section

Valider localement

Construisez et exécutez l'application localement avant de la déployer en production.

Déployer vers Vercel

Poussez le starter vers votre dépôt et importez le projet dans Vercel.

Vérifier les routes

Confirmez les principales surfaces SaaS et les flux de navigation en production.

Modèle mentalLien vers la section

Starter Free se déploie en tant que surface de produit frontale. Le câblage de production vient plus tard.

Aujourd'hui	Plus tard
Auth simulé	vrai fournisseur de session
Facturation simulée	Stripe Checkout et Portail
factures statiques	Historique des factures synchronisées
Données simulées	enregistrements sauvegardés dans la base de données
Validation UX locale	flux d'utilisateurs de production

Aucun secret n'est encore requis

Starter Free peut se déployer sans AUTH_SECRET, DATABASE_URL, STRIPE_SECRET_KEYou STRIPE_WEBHOOK_SECRET parce que ces systèmes sont intentionnellement simulés.

ÉtapesLien vers la section

Valider la construction de la production localementLien vers la section

Exécutez la construction de production avant de déployer.

terminal

pnpm build
pnpm start

Puis ouvrir :

browser

http://localhost:3000

Si l'application se construit et démarre localement, vous avez déjà détecté le problème de déploiement le plus courant.

Poussez vers votre dépôtLien vers la section

Créez ou connectez votre dépôt GitHub.

terminal

git remote remove origin
git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO.git
git push -u origin main

Utilisez votre propre nom et organisation de dépôt.

Importer sur VercelLien vers la section

Sur Vercel :

créer un nouveau projet
importer votre dépôt
conserver les paramètres Next.js détectés
déployer

Starter Free ne nécessite pas de variables d'environnement à ce stade.

Vérifier les routes de productionLien vers la section

Après le déploiement, ouvrez les routes principales :

production routes

/login
/register
/dashboard
/projects
/admin
/billing
/settings

Vous devriez être en mesure de naviguer sur la surface SaaS simulée.

Variables d'environnement futuresLien vers la section

Vous n'avez pas besoin de ces variables pour Starter Free, mais elles deviennent pertinentes lorsque le produit se déplace vers de vrais utilisateurs.

.env.local

AUTH_SECRET=
DATABASE_URL=
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=

Variables auth

Authentication variables become necessary once sessions, providers, and protected access are real.

AUTH_SECRETOAuth providersSession securityPassword reset

Liste de contrôle de productionLien vers la section

Avant de partager le déploiement, confirmez que :

pnpm build Réussir localement
l'application déployée se charge sans erreurs d'exécution
Les pages sont accessibles
Les pages du tableau de bord sont accessibles
projet routes travail
Les pages d'administration, de facturation et de paramètres sont rendues
Aucune variable d'environnement requise n'est manquante
la navigation fonctionne sur ordinateur et mobile
la facturation et l'auth simulés sont clairement compris comme câblage de non-production

Bon signal de déploiement

Si toutes les routes se chargent et que la surface du produit semble cohérente, le déploiement est prêt pour les démonstrations, la validation et l'itération du produit.

Guide de décisionLien vers la section

Déployez Starter Free lorsque :

vous souhaitez partager une démo
vous avez besoin de commentaires d'utilisateurs ou de clients
vous souhaitez valider l’UX avant le travail de backend
vous voulez une URL de production pour votre histoire de produit
vous voulez attraper les problèmes de construction plus tôt

Déplacer vers Starter Pro lorsque :

Les vrais utilisateurs ont besoin de comptes
Les routes doivent être protégées
Stripe doit facturer les clients
L'état de facturation doit débloquer les fonctionnalités
Les données backend doivent remplacer les données mock
Le déploiement doit soutenir les opérations de production

Préférez

Déployer tôt pour valider la surface du produit
courir pnpm build avant de pousser
vérifier les routes principales après le déploiement
ajouter des secrets seulement lorsque les systèmes deviennent réels
mise à niveau lorsque le câblage du backend devient le bloqueur

Éviter

attendre le intégration backend avant de déployer
la production de saut construit localement
Ajouter des variables d'environnement non utilisées trop tôt
En supposant que la facturation simulée est la facturation de production
partager une démo avant de vérifier toutes les routes principales

DépannageLien vers la section

Prochaines étapesLien vers la section

Mise à niveau vers Starter ProProSachez quand Starter Free cesse d'être suffisant et Starter Pro devient le chemin le plus rapide à lancer.Starter ProPassez de l'UX simulée à l'auth adaptées à la production, à la facturation, au backend et aux fondations de livraison sécurisées.

Libre de déployer. Pro pour lancer.

Starter Free vous donne une surface SaaS en direct. Starter Pro vous donne le câblage de production derrière elle. à

Mise à niveau vers Starter Pro