bext.config.toml

bext.config.toml se trouve à la racine d'une application PRISM et configure le comportement du serveur, du build et du rendu. Cette page documente chaque section. Pour l'arborescence de routes que pilotent ces réglages, voir Routage et rendu.

Exemple minimal

Une configuration minimale fonctionnelle — une application PRISM qui surveille ses sources pour le live-reload et effectue le rendu avec l'ISR sur une revalidation de 10 minutes :

[server]
app_dir = "."
static_dir = "public"

[framework]
type = "prism"

[build]
watch_dirs = ["src/app", "src/components", "src/lib"]
live_reload = true

[rendering]
mode = "isr"
revalidate = 600

[server]

Clé Exemple Notes
app_dir "." Racine de l'application.
static_dir "public" Répertoire servi tel quel pour les ressources statiques.

[framework]

Clé Valeur Notes
type "prism" Sélectionne le framework PRISM.

[build]

Clé Exemple Notes
watch_dirs ["src", ...] Répertoires que le watcher de live-reload observe.
live_reload true Invalide le cache de la route table et les bundles ~1-2 s après un changement sous watch_dirs.
Note

public/islands/* n'est volontairement pas surveillé — cache-bustez les scripts d'island avec une requête ?v= sur le <script src>. Voir Déployer un site PRISM.

[build.css]

Clé Valeur Notes
route_css true Compiler Tailwind en JIT vers /_bext/globals-compiled.css.

[rendering]

Clé Exemple Notes
mode "isr" ou "ssr" Régénération statique incrémentale, ou rendu à chaque requête.
revalidate 600 Fenêtre de revalidation ISR, en secondes.
Note

Les routes qui exportent un loader ou une action sautent automatiquement l'ISR et effectuent un rendu à neuf, et une route peut renoncer entièrement au cache avec export const dynamic = "force-dynamic". Voir Routage et rendu.

[seo]

Clé Valeur Notes
sitemap true Générer un sitemap.
robots true Générer robots.txt.

[compile]

Clé Valeur Notes
on_demand true Compiler les routes à la demande.

[security.csp]

Surcharges de Content-Security-Policy par site.

Attention

[security.csp] n'est pas honoré pour les sites auto-vhost — ceux liés avec vhost/upsert_auto (voir Déployer un site PRISM). Pour ceux-là, la politique globale l'emporte et votre CSP par site est ignorée.

Connexe