@fraza/start 0.3.5 → 0.3.7

package/CHANGELOG.md

@@ -4,6 +4,18 @@ Historique des versions publiées de `@fraza/start`.
 
 Ce fichier est généré par `fraza-module changelog` à partir des messages de commit. Ne pas le modifier à la main.
 
+## 0.3.7 (2026-10-25)
+
+### Refontes
+
+- **bin/project.js** : update Next version and env file generation (544646f)
+
+## 0.3.6 (2026-10-25)
+
+### Documentation
+
+- add command to start project (5edd2f6)
+
 ## 0.3.5 (2026-10-25)
 
 ### Ajouts

package/README.md

@@ -2,6 +2,10 @@
 
 Le CLI crée un projet Next.js avec `@fraza/core` déjà branché : administration, comptes, site public et variables d'environnement prêtes à remplir.
 
+```sh
+npx @fraza/start
+```
+
 [Documentation](https://docs.fraza.ca/docs) · [Installation](https://docs.fraza.ca/docs/demarrage/installation) · [Structure du projet](https://docs.fraza.ca/docs/demarrage/structure-du-projet)
 
 > [!WARNING]
@@ -39,7 +43,7 @@ Ouvrez `http://localhost:3000/auth` pour créer le premier compte, qui reçoit l
 
 ## Ce que fait le CLI
 
-1. Crée le projet avec `create-next-app` 16.3.8, la version de Next contre laquelle le core est validé.
+1. Crée le projet avec `create-next-app` 16.4.3, la version de Next contre laquelle le core est validé.
 2. Remplace le dossier `app/` de Next par les gabarits Fraza : administration, authentification, API, page d'accueil, pages d'erreur, gabarits de page, exemples de blocs, `theme.js`, `instrumentation.js` et `jsconfig.json`.
 3. Ajoute les scripts `dev`, `build` et `postinstall`, qui lancent `fraza-modules sync`.
 4. Masque l'indicateur de développement de Next dans `next.config.mjs`.
@@ -47,7 +51,7 @@ Ouvrez `http://localhost:3000/auth` pour créer le premier compte, qui reçoit l
 6. Ajoute un bloc Fraza à l'`AGENTS.md`, qui renvoie un agent à la documentation livrée dans `node_modules/@fraza/core/dist/docs/`.
 7. Écrit le `.npmrc` du projet, sans jeton.
 8. Installe `@fraza/core`.
-9. Crée `.env.example`, suivi par git, et `.env.local`, ignoré par git, avec `FRAZA_ENCRYPTION_KEY` générée et `NEXT_PUBLIC_URL` locale.
+9. Crée `.env.example`, suivi par git, et `.env.local`, ignoré par git, avec `FRAZA_ENCRYPTION_KEY` générée et `NEXT_PUBLIC_URL` locale. Crée aussi `.env.development.local`, ignoré par git, avec `NEXT_PUBLIC_URL=http://localhost:3000` et `FRAZA_DEVKIT=true`.
 
 ## Variables d'environnement
 
@@ -55,6 +59,7 @@ Ouvrez `http://localhost:3000/auth` pour créer le premier compte, qui reçoit l
 |---|---|---|
 | `.env.example` | La liste des variables, sans aucune valeur secrète. Une variable ajoutée par le projet y entre aussi. | Oui |
 | `.env.local` | Les valeurs de cette machine : base de données, stockage, courriel, clés. | Non |
+| `.env.development.local` | Les valeurs du développement local, lues seulement par `npm run dev` : URL locale et devkit de l'admin. | Non |
 
 En production, les variables se saisissent dans la plateforme d'hébergement, jamais dans un fichier suivi par git. Partez de `.env.example` pour la liste.
 

package/bin/cli.js

@@ -169,6 +169,7 @@ async function initProject() {
 		const env = writeEnvFiles(envTemplate, cwd);
 		if (env.example) done('.env.example créé à partir du modèle de @fraza/core');
 		if (env.local) done('.env.local créé, FRAZA_ENCRYPTION_KEY générée');
+		if (env.development) done('.env.development.local créé (URL locale, devkit activé)');
 
 		const file = (name) => `${c.cyan}${name}${c.reset}`;
 		const dim = (text) => `${c.dim}${text}${c.reset}`;

package/bin/project.js

@@ -17,12 +17,14 @@ export const MIN_NODE = [20, 12];
 // Version de `create-next-app`, donc de Next, installée dans le projet généré.
 // C'est le dernier correctif de la version mineure contre laquelle le core a
 // été validé (`packages.next.tested` de son `supported.json`) : un correctif de
-// Next ne change pas d'API, et il porte souvent une faille corrigée : 16.3.5,
-// validée d'abord, est touchée par GHSA-vcvr-r3jv-pc5j, corrigée en 16.3.8,
-// la version que le core déclare maintenant.
+// Next ne change pas d'API, et il porte souvent une faille corrigée. 16.3.8
+// était touchée par GHSA-2464-fhr4-w9xw et GHSA-673q-mjm6-r5xr, deux
+// exécutions de code à distance corrigées en 16.4.1 seulement, sans correctif
+// dans la 16.3 : le core a donc été validé contre la 16.4, et l'épingle suit
+// maintenant 16.4.3, le dernier correctif de cette version mineure.
 // `npm run check:contract` échoue si l'épingle quitte la version mineure
 // validée ou passe sous la version validée (`pinFollowsTestedNext`).
-export const CREATE_NEXT_APP_VERSION = '16.3.8';
+export const CREATE_NEXT_APP_VERSION = '16.4.3';
 
 // Entrées tolérées dans le dossier cible : métadonnées d'éditeur ou de gestion
 // de versions, que ni `create-next-app` ni ce CLI n'écrivent. Toute autre entrée
@@ -255,18 +257,34 @@ export function fillLocalEnv(template, { key = randomBytes(32).toString('hex'),
 }
 
 /**
- * Crée `.env.example` (copie du modèle du core, suivie par git) et `.env.local`
- * (la même copie remplie pour cette machine, ignorée par git). Un fichier qui
+ * Contenu de `.env.development.local` : les valeurs du développement local, que
+ * Next.js ne lit qu'avec `next dev` et qui passent avant `.env.local`. On y met
+ * l'origine locale et le devkit de l'admin, qui ne doivent jamais aller en
+ * production.
+ */
+export const DEVELOPMENT_ENV = [
+	'# Valeurs du développement local, lues par Next.js avec `next dev` seulement,',
+	'# avant celles de .env.local. Ignoré par git.',
+	'NEXT_PUBLIC_URL=http://localhost:3000',
+	'FRAZA_DEVKIT=true',
+	'',
+].join('\n');
+
+/**
+ * Crée `.env.example` (copie du modèle du core, suivie par git), `.env.local`
+ * (la même copie remplie pour cette machine, ignorée par git) et
+ * `.env.development.local` (`DEVELOPMENT_ENV`, ignoré par git). Un fichier qui
  * existe déjà n'est jamais remplacé.
  * @param {string} templatePath `node_modules/@fraza/core/.env.example`.
  * @param {string} projectDir
- * @returns {{ example: boolean, local: boolean }} Les fichiers créés.
+ * @returns {{ example: boolean, local: boolean, development: boolean }} Les fichiers créés.
  */
 export function writeEnvFiles(templatePath, projectDir) {
 	const template = fs.readFileSync(templatePath, 'utf-8');
 	const examplePath = path.join(projectDir, '.env.example');
 	const localPath = path.join(projectDir, '.env.local');
-	const created = { example: false, local: false };
+	const developmentPath = path.join(projectDir, '.env.development.local');
+	const created = { example: false, local: false, development: false };
 
 	if (!fs.existsSync(examplePath)) {
 		fs.writeFileSync(examplePath, template);
@@ -277,5 +295,9 @@ export function writeEnvFiles(templatePath, projectDir) {
 		fs.writeFileSync(localPath, fillLocalEnv(template), { mode: 0o600 });
 		created.local = true;
 	}
+	if (!fs.existsSync(developmentPath)) {
+		fs.writeFileSync(developmentPath, DEVELOPMENT_ENV);
+		created.development = true;
+	}
 	return created;
 }

package/bin/version.js

@@ -1,2 +1,2 @@
 // AUTO-GÉNÉRÉ par `fraza-module sync-version`, ne pas modifier à la main.
-export const STARTER_VERSION = '0.3.5';
+export const STARTER_VERSION = '0.3.7';

package/changelog.json

@@ -1,6 +1,42 @@
 {
   "name": "@fraza/start",
   "versions": [
+    {
+      "version": "0.3.7",
+      "date": "2026-10-25",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "refactor",
+          "scope": "bin/project.js",
+          "subject": "update Next version and env file generation",
+          "hash": "544646f",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.3.6",
+      "date": "2026-10-25",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": [
+        {
+          "type": "docs",
+          "scope": null,
+          "subject": "add command to start project",
+          "hash": "5edd2f6",
+          "breaking": false
+        }
+      ]
+    },
     {
       "version": "0.3.5",
       "date": "2026-10-25",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fraza/start",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "CLI pour créer un projet Fraza avec Next.js",
   "publishConfig": {
     "access": "public"