Démarrer un projet Fraza en quatre étapes

Un projet Fraza se génère par une seule commande. Le core, @fraza/start et les modules gratuits viennent de npmjs : il n’y a rien à configurer ni de compte à créer.

Avant de commencer

• Node.js 20.12 ou plus.
• PostgreSQL 14 ou plus, accessible depuis la machine.
• Un terminal bash, zsh ou PowerShell.

1. Générer le projet

Placez-vous dans un dossier vide : son nom devient celui du projet.

npx @fraza/start

La commande crée un projet Next.js avec l’App Router et Tailwind, copie les fichiers de départ, installe @fraza/core et prépare les fichiers d’environnement, clé de chiffrement comprise.

2. Configurer l’environnement

Les valeurs de la machine vont dans .env.local, que git ignore. Trois variables suffisent pour démarrer :

NEXT_PUBLIC_URL=http://localhost:3000
FRAZA_NAME=Mon site
FRAZA_DATABASE_URL=postgres://user:password@localhost:5432/mon_projet

.env.example, lui, est suivi par git et ne porte aucune valeur secrète : il sert de modèle à une nouvelle machine.

3. Initialiser la base

npx fraza-db test   # vérifier la connexion
npx fraza-db init   # créer les tables

La commande est idempotente : la relancer après chaque ajout de module ne casse rien.

4. Démarrer

npm run dev

• localhost:3000 : le site public.
• localhost:3000/auth : la première configuration, puis la connexion.
• localhost:3000/admin : l’administration.

Tant qu’aucun compte n’existe, /auth affiche le formulaire de première configuration. Le compte qu’il crée reçoit le rôle admin et arrive connecté dans l’administration. Créez-le tout de suite.

En production

Les variables se saisissent dans la plateforme d’hébergement, jamais dans un fichier suivi. FRAZA_ENCRYPTION_KEY s’y copie telle quelle depuis .env.local : elle ne doit jamais changer, sinon les données chiffrées avec elle deviennent illisibles.

La suite : Configuration pour le courriel, le stockage et les paiements, puis Déploiement.