Flexweg CMS

Déploiement sur Flexweg

Une fois que vous avez un dossier (compilé localement avec ou téléchargé d'une release), le déploiement sur Flexweg consiste à uploader deux dossiers à deux emplacements spécifiques sur votre site

Une fois que vous avez un dossier dist/ (compilé localement avec npm run build ou téléchargé d'une release), le déploiement sur Flexweg consiste à uploader deux dossiers à deux emplacements spécifiques sur votre site Flexweg.

Ce qui va où

dist/
├── admin/             → upload vers /admin/ sur Flexweg
└── theme-assets/      → upload vers /theme-assets/ sur Flexweg (racine du site)

Cette séparation reflète la structure du site public :

  • Chaque page publiée contient <link rel="stylesheet" href="/theme-assets/<theme-id>.css"> — c'est pourquoi theme-assets/ vit à la racine du site, pas sous /admin/.
  • L'admin SPA vit intégralement sous /admin/ (ou sous le nom que vous lui avez donné — voir Renommer le dossier admin).

Premier déploiement

  1. Ouvrez votre tableau de bord Flexweg → Gestionnaire de fichiers.
  2. Créez un dossier nommé admin/ à la racine de votre site.
  3. Uploadez le contenu de dist/admin/ (pas le dossier lui-même — son contenu) dans le dossier admin/. Après ça vous devriez avoir sur Flexweg :
/admin/
├── index.html
├── config.js
├── external.default.json
├── assets/
├── runtime/
├── plugins/
│   ├── core-seo/
│   ├── flexweg-archives/
│   ├── flexweg-multilang/
│   ├── flexweg-rss/
│   ├── flexweg-search/
│   └── flexweg-sitemaps/
└── themes/
    ├── corporate/
    ├── magazine/
    ├── portfolio/
    └── storefront/
  1. Créez un dossier theme-assets/ à la racine et uploadez le contenu de dist/theme-assets/ dedans. Cela contient un fichier .css par thème embarqué :
/theme-assets/
├── corporate.css
├── magazine.css
├── portfolio.css
├── storefront.css
└── default.css

Premier accès à l'admin

Ouvrez https://votre-site.flexweg.com/admin/ dans un navigateur. Trois scénarios :

  • Vous avez compilé avec un .env rempli (Firebase) → vous arrivez sur la page de connexion. Identifiez-vous avec l'email + mot de passe du bootstrap admin.
  • Vous avez compilé sans .env ou téléchargé une release → le formulaire d'installation se déclenche. Voir Formulaire d'installation.
  • Vous utilisez SQLite → le formulaire d'installation se déclenche systématiquement (pour échanger la clé maître contre un token scopé).

Déploiements suivants

Pour les mises à jour de l'admin :

  1. Compilez (ou téléchargez) la nouvelle version
  2. Sur Flexweg, supprimez le contenu de /admin/ (gardez le dossier lui-même)
  3. Uploadez le nouveau contenu

Pour le contenu, rien à faire — l'admin pousse les nouvelles pages dès que vous cliquez sur Publier.

Pour les mises à jour de thèmes intégrés (changements dans src/themes/<theme>/), pensez à cliquer sur Sync theme assets dans la page Thèmes après le déploiement — ce bouton re-pousse les CSS des thèmes à la racine du site.

Voir aussi