aspireves.org/README.md
Jalil Arfaoui c231016016 Préfixer les variables StoryBlok avec PUBLIC_ pour les exposer dans import.meta.env
Les variables système (Clever Cloud) n'étaient pas disponibles via import.meta.env car Vite ne les inclut que pour les variables préfixées PUBLIC_. Sans ce préfixe, getVersion() était compilé à "published" même sur l'instance preview, empêchant le live preview du visual editor StoryBlok.
2026-03-07 01:27:43 +01:00

1.7 KiB

Compagnie AspiRêves

Site web de la Compagnie AspiRêves, compagnie de spectacle vivant basée dans le Tarn.

Construit avec Astro et StoryBlok comme CMS headless.

Prérequis

  • Node.js >= 20
  • Un fichier .env (voir .env.example)

Développement

npm install
npm run dev

Le serveur démarre sur http://localhost:3030.

Builds

Le projet supporte deux modes de build via la variable PUBLIC_STORYBLOK_IS_PREVIEW :

Production (SSG)

Site statique, performant, sans serveur Node.js. Utilise le Public Access Token StoryBlok et ne récupère que le contenu publié.

npm run build

Génère des fichiers HTML statiques dans dist/. Le rebuild doit être déclenché par un webhook StoryBlok (Settings > Webhooks) à chaque publication de contenu.

Preview (SSR)

Serveur Node.js avec le visual editor StoryBlok (bridge + live preview). Utilise le Preview Access Token et récupère le contenu en draft.

PUBLIC_STORYBLOK_IS_PREVIEW=true npm run build
HOST=0.0.0.0 node dist/server/entry.mjs

Le serveur démarre sur le port 8080 par défaut (configurable via PORT).

Variables d'environnement

Variable Production Preview
PUBLIC_STORYBLOK_TOKEN Public Access Token Preview Access Token
PUBLIC_STORYBLOK_IS_PREVIEW (non défini) true
CC_POST_BUILD_HOOK npm run build npm run build
HOST - 0.0.0.0

Configuration StoryBlok

  • Settings > Visual Editor : mettre l'URL de l'instance preview comme environnement par défaut
  • Settings > Webhooks : configurer un webhook vers l'instance production pour déclencher le rebuild à chaque publication