Flexweg CMS

Démarrage rapide

Ce guide vous accompagne dans le déploiement d'un Flexweg CMS fonctionnel sans aucune compilation locale. À la fin, vous aurez un admin en ligne sur votre site Flexweg, prêt à publier votre premier

Ce guide vous accompagne dans le déploiement d'un Flexweg CMS fonctionnel sans aucune compilation locale. À la fin, vous aurez un admin en ligne sur votre site Flexweg, prêt à publier votre premier post.

Le plus simple — l'auto-installeur Flexweg en un clic

Avant d'aller plus loin, vérifiez si votre compte Flexweg propose déjà l'auto-installeur pour Flexweg CMS — il déploie l'admin sur votre site en un clic, sans code, sans terminal, sans dist/ à télécharger :

  1. Ouvrez votre tableau de bord Flexweg et sélectionnez le site sur lequel installer Flexweg CMS (https://www.flexweg.com/account/sites/<your-site-id>).
  2. Si votre site est vide, vous verrez un bouton Install apps directement sur la page — cliquez dessus.
  3. Si le site contient déjà des fichiers, cliquez sur le bouton menu (à côté du sélecteur de site en haut à droite) et choisissez Install apps dans le menu déroulant.
  4. Une modale s'ouvre listant toutes les apps proposées en un clic par Flexweg. Trouvez Flexweg CMS et cliquez sur Install.
  5. Flexweg dépose le bundle admin dans votre site (sous /admin/) et ajoute un bouton « Flexweg CMS Admin » à l'interface de votre site — cliquez dessus à tout moment pour ouvrir l'admin.

C'est tout. À la première ouverture de l'admin, le formulaire d'installation vous guide à travers Firebase + votre clé API, puis vous publiez.

Si vous avez utilisé l'auto-installeur, vous pouvez passer directement au formulaire d'installation — les étapes manuelles ci-dessous ne sont nécessaires que pour un déploiement à la main ou pour un développeur qui veut compiler l'admin lui-même.

Choisir son backend

Flexweg CMS supporte deux backends. Choisissez celui qui vous correspond :

  • Flexweg SQLite (recommandé pour la plupart des sites) — aucun service externe, tout tourne sur votre site Flexweg via /api/v1/sqlite/*. Le formulaire d'installation ci-dessous crée le schéma pour vous, génère un token scopé, enregistre le premier admin côté serveur. Aucun projet Firebase nécessaire.
  • Firebase — Firestore + Firebase Authentication. À choisir si vous utilisez déjà Firebase pour d'autres projets, ou si vous voulez la connexion Google / les emails vérifiés.

La suite de ce guide couvre Firebase. Si vous choisissez SQLite, sautez simplement l'étape 1 et les parties spécifiques à Firebase de l'étape 3 — le formulaire d'installation in-admin a un chemin dédié qui gère tout en une seule étape.

Déploiement manuel (si vous ne pouvez pas utiliser l'auto-installeur)

Ce guide reproduit le même résultat à la main : créer un projet Firebase, uploader dist/admin/ sur votre site Flexweg, et remplir le formulaire d'installation.

Étape 1 — Créer un projet Firebase

  1. Ouvrez la console Firebase.
  2. Cliquez sur Ajouter un projet → entrez un nom (ex. monsite-cms) → acceptez les défauts → attendez la création.
  3. Dans le projet, ouvrez Build → Authentication → Get started.
  4. Sur l'onglet Sign-in method, activez Email/Password.
  5. Passez sur l'onglet Users et cliquez sur Add user. Utilisez l'email + mot de passe que vous voulez pour le login admin. Conservez-les pour l'étape 3.
  6. Ouvrez Build → Firestore Database → Create database.
  7. Choisissez une région proche (irréversible) → démarrez en mode production (on ajoute les règles juste après).
  8. Ouvrez Build → Firestore Database → Rules et collez les règles fournies dans le README du dépôt — en remplaçant [email protected] par l'email défini à l'étape 5.

Étape 2 — Uploader dist/admin/ sur votre site Flexweg

Si vous avez le bundle pré-compilé :

  1. Ouvrez votre tableau de bord Flexweg et sélectionnez votre site.
  2. Naviguez dans l'arborescence des fichiers (ou utilisez rsync / l'API Files).
  3. Créez un dossier /admin/ à la racine.
  4. Uploadez le contenu du dist/admin/ dedans (index.html, config.js, assets/, runtime/, plugins/, themes/, theme-assets/, external.default.json).

Si vous compilez vous-même : git clone, npm install --legacy-peer-deps, npm run build, puis uploadez dist/admin/ comme ci-dessus.

Étape 3 — Remplir le formulaire d'installation in-admin

Ouvrez https://monsite.flexweg.com/admin/. Le formulaire d'installation s'affiche automatiquement.

Mode Firebase :

  1. Collez votre config Firebase (les 6 champs apiKey, authDomain, etc., visibles dans Project settings → Your apps).
  2. Entrez votre email admin + mot de passe (créés à l'étape 1).
  3. Cliquez sur Tester la connexion Firebase — l'admin vérifie l'auth + la lecture Firestore.
  4. Cliquez sur Tester la connexion Flexweg — entrez votre clé API Flexweg (depuis Account → API keys), l'admin tape /files/storage-limits pour vérifier.
  5. Cliquez sur Installer — l'admin écrit config/flexweg en Firestore, upload config.js rempli sur Flexweg, et recharge.

Mode SQLite :

  1. Entrez votre clé API maître Flexweg et le chemin SQLite à utiliser (ex. /data/cms.sqlite).
  2. Entrez l'email + mot de passe pour le premier admin.
  3. Cliquez sur Installer — l'admin échange la clé maître contre un token scopé, crée le schéma SQLite, enregistre l'admin, persiste la clé API pour les uploads ultérieurs, et recharge.

Dans les deux cas, après le reload vous arrivez sur le tableau de bord. Cliquez sur Nouveau post, écrivez quelque chose, cliquez sur Publier. Votre première URL est en ligne.

Et après ?