Démarrer
Du dossier vide à l’admin, en quatre étapes.
Le core, le starter et les modules gratuits viennent de npm : il n’y a rien à configurer ni de compte à créer. Comptez le temps d’une installation npm.
Avant de commencer
Prérequis.
- Node.js 20.12 ou plus
- PostgreSQL 14 ou plus, accessible depuis la machine
- Un terminal bash, zsh ou PowerShell
Un compte sur le registre de Fraza n’est utile que pour les modules Pro. Voir plus bas.
- 1
Générer le projet
Dans un dossier vide. 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.
Terminal$ npx @fraza/start - 2
Configurer l’environnement
Les valeurs de la machine vont dans .env.local, que git ignore. Trois variables suffisent pour démarrer.
.env.localNEXT_PUBLIC_URL=http://localhost:3000 FRAZA_NAME=Mon site FRAZA_DATABASE_URL=postgres://user:password@localhost:5432/mon_projet
- 3
Initialiser la base
La commande crée les tables du core et celles des modules activés. Elle se relance sans risque après chaque ajout de module.
Terminal$ npx fraza-db test # vérifier la connexion $ npx fraza-db init # créer les tables
- 4
Démarrer
Ouvrez /auth : tant qu’aucun compte n’existe, la page affiche la première configuration. Le compte créé reçoit le rôle admin et arrive connecté dans l’administration.
Terminal$ npm run dev
Ce qui tourne
Trois adresses, trois usages.
- localhost:3000
- Le site public
- localhost:3000/auth
- Première configuration, puis connexion
- localhost:3000/admin
- L’administration
Ajouter un module Pro.
Les modules Pro vivent sur le registre privé de Fraza, qui ne les sert qu’avec les identifiants délivrés avec la licence. On se connecte une fois par machine, puis on écrit le jeton du projet dans son .npmrc : la machine de build le reçoit avec le dépôt.
$ npm config set "@fraza-pro:registry" https://registry.fraza.ca/ $ npm login --registry=https://registry.fraza.ca/ $ npx fraza-key
Ensuite