Vue d'ensemble de l'installation

Il y a deux chemins pour mettre en route un Flexweg CMS, selon que vous êtes un développeur qui veut compiler l'admin lui-même, ou un utilisateur à qui on a fourni un dist/ pré-compilé à déposer sur Flexweg.

Les deux aboutissent au même admin tournant sur votre site Flexweg, configuré contre votre projet (Firebase ou SQLite). La différence est purement la façon dont vous récupérez le bundle et où vous saisissez les identifiants.

Choix du backend

Avant tout, choisissez votre backend de données. Le formulaire d'installation in-admin gère les deux :

• Flexweg SQLite — zéro service externe, tout tourne sur votre site Flexweg via /api/v1/sqlite/*. Recommandé pour la majorité des sites.
• Firebase — Firestore + Firebase Authentication. À choisir si vous utilisez déjà Firebase ailleurs ou voulez les emails vérifiés.

Vous pouvez basculer entre les deux plus tard via Réglages → Backend de données (la migration se fait par export / import).

Chemin A — Déploiement sans build (recommandé pour les non-développeurs)

Idéal quand :

• Quelqu'un a déjà produit un dist/admin/ pour vous (une release, un collègue, …)
• Vous n'avez pas Node.js installé et ne voulez pas l'installer
• Vous voulez seulement faire tourner l'admin, pas le modifier

Étapes :

1. (Firebase uniquement) Configurer Firebase — créer le projet, activer Authentication + Firestore
2. (Firebase uniquement) Configurer les règles Firestore — coller les règles avec votre email admin
3. Configurer Flexweg — obtenir une clé API, configurer les extensions autorisées
4. Uploader dist/admin/ dans un dossier de votre site Flexweg (typiquement /admin/)
5. Uploader dist/theme-assets/ à la racine du site
6. Lancer le formulaire d'installation in-admin — remplir les identifiants Firebase ou SQLite + Flexweg dans un assistant

L'assistant valide tout (se connecte à Firebase ou installe le schéma SQLite, teste l'API Flexweg, écrit la config, upload un config.js rempli) puis recharge. Vous êtes connecté.

→ Le guide de démarrage rapide parcourt ce flux de bout en bout.

Chemin B — Build local avec .env

Idéal quand :

• Vous êtes développeur et travaillez sur des plugins, thèmes ou l'admin lui-même
• Vous voulez le HMR via npm run dev
• Vous voulez intégrer les identifiants au build plutôt que d'utiliser l'assistant

Étapes :

1. Configurer Firebase ou SQLite — comme au Chemin A
2. (Firebase) Configurer les règles Firestore — comme au Chemin A
3. Configurer Flexweg — comme au Chemin A
4. Cloner le dépôt, cp .env.example .env, remplir VITE_FIREBASE_* + VITE_ADMIN_EMAIL (mode Firebase uniquement — SQLite passe toujours par l'assistant)
5. Développement local — npm install --legacy-peer-deps && npm run dev pour développer, ou npm run build && upload dist/admin/ pour déployer

Quand le build a .env rempli, config.js est baké avec les valeurs au moment du build et le formulaire d'installation in-admin n'apparaît jamais. Ce mode est uniquement disponible pour Firebase ; SQLite nécessite toujours l'assistant pour échanger la clé maître contre un token scopé.

Chemin C — Hybride

Vous pouvez aussi compiler dist/admin/ à partir des sources sans remplir .env du tout — le bundle s'embarque alors avec config.js à null et le formulaire d'installation se déclenche au premier chargement. C'est exactement le scénario du Chemin A mais avec votre propre build au lieu d'un release.

Utile pour distribuer un dist/admin/ standard à plusieurs sites Flexweg sans avoir besoin de re-compiler à chaque fois — chaque déploiement remplit son propre config.js via l'assistant.