# Initialisation d'un projet > Statut : stable · Niveau : tous Procédure commune à tous nos nouveaux projets (statique, Nuxt, WordPress). **[Primary](https://primary.alsacreations.com/) est la source de vérité** pour les fichiers de configuration et le kit CSS : ce document dit **quoi récupérer, où le placer et dans quel ordre**, sans recopier le contenu des fichiers. Il s'utilise aussi bien à la main (interface web de Primary) que par un agent (fichiers bruts du [dépôt Primary](https://github.com/alsacreations/primary) et ses scripts Node). > ⚠️ **Règle absolue** — Ne jamais écrire, réécrire ou « améliorer » à la main `.editorconfig`, `prettier.config.mjs`, `stylelint.config.mjs`, `postcss.config.mjs`, `eslint.config.js`, `.prettierignore`, `.stylelintignore`, `.vscode/*` ni `app.css`. Les récupérer depuis Primary. Un changement de convention se fait **dans le dépôt Primary**, pas dans un projet. --- ## Stack commune | Rôle | Outil | | --- | --- | | Gestionnaire de paquets | **pnpm** | | Compilation | **Vite** (embarqué par Nuxt et WordPlate) | | Qualité | **EditorConfig**, **Prettier**, **Stylelint**, **ESLint** | | CSS | Kit Primary : layers `config` → `base` → `components` → `utilities`, voir [CSS](../guidelines/css.md) | ## 1. Créer le projet selon sa typologie | Typologie | Création | Dossier CSS | | --- | --- | --- | | Site statique | `pnpm create vite@latest --template vanilla` (ou `vanilla-ts`), puis `pnpm install` | `src/assets/css/` | | Nuxt | `pnpm create nuxt@latest `, puis voir [Nuxt](#nuxt) | `app/assets/styles/` | | WordPress | Environnement Docker + Composer + WordPlate : voir [WordPress — Environnement](../guidelines/wordpress/environnement.md) et [WordPress — Thème](../guidelines/wordpress/theme.md) | `resources/` (sources compilées par Vite) | Projet multi-parties (mono-dépôt avec un front Vite et d'autres parties) : faire l'étape 2 **à la racine** avant de créer le front. Nettoyage d'un projet Vite statique : supprimer les fichiers d'exemple (`src/counter.js`, `src/style.css`, le contenu de `src/assets/` et de `public/`) ; réduire `src/main.js` à `import "./assets/css/app.css"` ; dans `index.html`, mettre `lang="fr"`, un `` réel, et retirer le `<link rel="icon">` par défaut. Assets statiques dans `public/`. Une fois Prettier installé (étape 2), mettre en forme les deux fichiers conservés, car l'`index.html` de Vite garde plusieurs attributs par ligne même nettoyé : ```bash pnpm exec prettier --write index.html src/main.js ``` ## 2. Récupérer les fichiers de configuration Source : dossier [`config_files/`](https://github.com/alsacreations/primary/tree/main/config_files) de Primary. Les noms y sont **sans point initial** : les renommer à la copie. | Fichier Primary | Destination dans le projet | | --- | --- | | `config_files/editorconfig` | `.editorconfig` | | `config_files/gitignore` | `.gitignore` | | `config_files/vscode/settings.json` | `.vscode/settings.json` | | `config_files/vscode/extensions.json` | `.vscode/extensions.json` | | `config_files/prettier.config.mjs` | `prettier.config.mjs` | | `config_files/stylelint.config.mjs` | `stylelint.config.mjs` | | `config_files/postcss.config.mjs` | `postcss.config.mjs` | | `config_files/eslint.config.js` | `eslint.config.js` | | `config_files/prettierignore` | `.prettierignore` | | `config_files/stylelintignore` | `.stylelintignore` | | `config_files/vite.config.js` | `vite.config.js` (projet statique uniquement, si absent) | Par un agent ou en ligne de commande, depuis la racine du projet : ```bash P=https://raw.githubusercontent.com/alsacreations/primary/main/config_files mkdir -p .vscode curl -fsSL $P/editorconfig -o .editorconfig curl -fsSL $P/gitignore -o .gitignore curl -fsSL $P/vscode/settings.json -o .vscode/settings.json curl -fsSL $P/vscode/extensions.json -o .vscode/extensions.json curl -fsSL $P/prettier.config.mjs -o prettier.config.mjs curl -fsSL $P/stylelint.config.mjs -o stylelint.config.mjs curl -fsSL $P/postcss.config.mjs -o postcss.config.mjs curl -fsSL $P/eslint.config.js -o eslint.config.js curl -fsSL $P/prettierignore -o .prettierignore curl -fsSL $P/stylelintignore -o .stylelintignore ``` Puis installer les dépendances qu'ils requièrent : ```bash pnpm add -D prettier postcss-custom-media stylelint stylelint-config-standard stylelint-config-html stylelint-order stylelint-config-property-sort-order-smacss pnpm add -D eslint @eslint/js globals eslint-config-prettier ``` Ajouter un `README.md` (informations de prise en main du projet, voir [WordPress — Environnement](../guidelines/wordpress/environnement.md) pour le contenu attendu). ESLint : `eslint.config.js` couvre le JavaScript navigateur (règles recommandées, mise en forme laissée à Prettier). Pour Vue ou Nuxt, la compléter avec la configuration officielle du framework ([Vue](https://eslint.vuejs.org/), [Nuxt](https://nuxt.com/modules/eslint)). ## 3. Générer le kit CSS Le kit comprend : `app.css` (point d'entrée), `theme.css` (primitives et tokens), `custom-media.css` (points de rupture), `styles.css`, `utilities.css`, et les fichiers externes `reset.css`, `print.css`, `natives.css`, `layouts.css`. **À la main** : [Primary](https://primary.alsacreations.com/) → importer les JSON exportés de Figma (plugin _Variables_, option « Export modes ») ou choisir « Projet vide » → cocher « Extra CSS » (et « WordPress » si besoin) → télécharger le ZIP → copier le dossier `css/` dans le dossier CSS du projet. **Par un agent** : 1. `theme.css` et `custom-media.css` — avec le script Node de Primary (aucune dépendance à installer). Si l'équipe a fourni les exports JSON de Figma, les placer dans un dossier `<json>` ; sinon passer un dossier vide (équivalent de « Projet vide », primitives et tokens par défaut). ```bash git clone --depth 1 https://github.com/alsacreations/primary.git /tmp/primary node /tmp/primary/scripts/figmatocss.js <json> /tmp/primary-out cp /tmp/primary-out/theme.css /tmp/primary-out/custom-media.css <dossier-css>/ ``` 1. `styles.css` et `utilities.css` — copier `kit/styles.css` et `kit/utilities.css` du dépôt Primary. 2. Fichiers externes, toujours dans leur dernière version. Les URL GitHub servent les mêmes fichiers que les sites et restent accessibles quand le réseau d'un agent est filtré : | Fichier | Source (site) | Source (GitHub brut) | | --- | --- | --- | | `reset.css` | `https://reset.alsacreations.com/public/reset.css` | `https://raw.githubusercontent.com/alsacreations/reset/main/public/reset.css` | | `print.css` | `https://reset.alsacreations.com/public/print.css` | `https://raw.githubusercontent.com/alsacreations/reset/main/public/print.css` | | `natives.css` | `https://knacss.com/css/natives.css` | `https://raw.githubusercontent.com/alsacreations/knacss/master/public/css/natives.css` | | `layouts.css` | `https://bretzel.alsacreations.com/` | `https://raw.githubusercontent.com/alsacreations/bretzel/refs/heads/main/public/layouts.css` | 1. `app.css` — contenu de référence (identique à celui généré par Primary). Le `@layer` doit rester en tête, immédiatement suivi d'un bloc ininterrompu de `@import` : un `@import` placé avant le `@layer` invalide silencieusement tous ceux qui suivent. ```css /* L'ordre des layers définit la priorité des styles */ /* Chaque layer écrase le précédent si conflit */ @layer config, base, components, utilities; /* Custom media queries (hors layers, requises avant leur utilisation) */ @import "custom-media.css"; /* Config */ @import "reset.css" layer(config); @import "natives.css" layer(config); @import "layouts.css" layer(config); @import "theme.css" layer(config); /* Base */ @import "styles.css" layer(base); /* Utilities */ @import "print.css" layer(utilities); @import "utilities.css" layer(utilities); ``` 1. WordPress uniquement — générer `theme.json` à partir des mêmes primitives et tokens : ```bash node /tmp/primary/scripts/generateThemeJson.js --in /tmp/primary-out --out <theme>/theme.json ``` Les feuilles de styles des composants vont dans le layer `components`. Points de rupture : utiliser les custom media de `custom-media.css` (`@media (--md)`, `@media (--until-lg)`…), compilés par `postcss-custom-media`. ## 4. Vérifier - `pnpm dev` démarre, `pnpm build` produit `dist/` sans erreur. - `pnpm exec prettier --check .`, `pnpm exec stylelint "**/*.css"` et `pnpm exec eslint .` passent. Les fichiers externes `reset.css`, `print.css`, `natives.css` et `layouts.css` sont exclus par `.prettierignore` et `.stylelintignore` ; ils ne doivent pas être modifiés. - Dans VS Code : installer les extensions recommandées (`.vscode/extensions.json`), puis « Reload Window » pour activer les linters. ## Nuxt Nuxt embarque Vite. Après `pnpm create nuxt@latest <nom>` : - Créer dans `app/` : `assets/`, `components/`, `layouts/`, `pages/`. - `app/app.vue` : ```html <template> <NuxtRouteAnnouncer /> <NuxtLayout> <NuxtPage /> </NuxtLayout> </template> ``` - `app/layouts/default.vue` : en-tête (composant), `<NuxtPage />`, pied de page (composant). - Kit CSS (étape 3) dans `app/assets/styles/`, déclaré dans `nuxt.config.ts` : `css: ['~/assets/styles/app.css']`. - Conventions Vue/Nuxt : voir [Vue.js et Nuxt](../guidelines/vue.md). ## Options selon les projets - **Sass** : `pnpm add -D sass`, puis renommer `styles.css` en `styles.scss` et adapter l'import. - **Alpine.js** : `pnpm add alpinejs`. - **Docker** (recette, préproduction) : ajouter `Dockerfile` et `docker-compose.yml` à partir des exemples et les adapter. - **Hébergement statique S3** (Vue/Nuxt) : voir [AWS S3](aws-s3.md). --- ## Voir aussi - [CSS](../guidelines/css.md) — Architecture, layers, design tokens, Bretzel. - [Visual Studio Code](../guidelines/vscode.md) — Réglages et extensions. - [Git](../guidelines/git.md) — Conventions de commit. - [WordPress — Environnement](../guidelines/wordpress/environnement.md) — Docker, Composer, WordPlate.