Comprendre Kreiz.

Kreiz fournit le moteur éditorial — le Core, le paquet@kreiz/core : back-office, publication, médias, formulaires, analytics, SEO. Il est partagé par tous les sites Kreiz et reste stable.

Votre site — le Project — est une application Astro qui consomme le Core par son API publique. C'est lui qui décide de tout ce qui se voit : la marque, les types de contenu, les templates, les mots.

La frontière est mécanique, pas une convention : le Project n'importe que l'API publique du Core, et le Core n'impose jamais de présentation.

Dix termes suffisent pour se repérer dans la documentation et dans l'admin.

Core

Le moteur Kreiz (paquet @kreiz/core) : back-office, publication, médias, formulaires, analytics, SEO. Stable, il n'a pas besoin que vous le touchiez.

Project

Votre site. Une application Astro qui déclare ses types de contenu et ses templates, et consomme le Core par son API publique.

Back-office

L'endroit privé (/admin) où vous modifiez votre contenu : formulaires générés, médiathèque, boîte de contact, analytics, publications.

Type de contenu

Une sorte de contenu déclarée en code, avec ses champs et son template : Article, Service, Projet, Réalisation, Produit, Équipe… Le formulaire admin est généré à partir de cette déclaration.

Template

La façon dont un contenu apparaît sur le site. Le même template sert au public et à la preview de l'admin : vous ne le modifiez qu'à un endroit.

Champ

Une information d’un type de contenu : texte, texte riche, date, sélection, liste… Le vocabulaire est borné : les formulaires admin et la validation serveur suivent la déclaration, sans surprise.

Save

Enregistrer sans publier. Le brouillon vit en base, dans l'admin ; rien n'est public, rien ne se perd.

Publish

Rendre visible. La publication fige une copie du contenu — le snapshot — et demande la reconstruction du site.

Snapshot

La copie figée que lit le site public. Les brouillons ne peuvent jamais fuiter dans le HTML servi : le build ne lit que les snapshots publiés.

Media

Les images du site, gérées dans la médiathèque : upload direct vers votre stockage, variantes responsives (WebP, AVIF) générées automatiquement.

Form

Un formulaire rempli par vos visiteurs, reçu dans la boîte de contact de l'admin — et notifié par email si vous branchez un relais.

C'est le point d'architecture qui rend Kreiz tranquille à vivre. Trois temps distincts :

• Enregistrez — vos brouillons vivent en base, dans l'admin. Le site public ne change pas.
• Publiez — le contenu courant est validé puis figé dans un snapshot immuable. Publier demande la reconstruction du site.
• Reconstruisez — le build lit uniquement les snapshots publiés et régénère le site statique. Un build raté n'endommage rien : la version précédente reste en ligne.

Deux conséquences concrètes : changer l'adresse d'une page publiée crée automatiquement une redirection 301, et dépublier un contenu le fait disparaître au prochain build — sans jamais casser le site servi.

Kreiz ne décide pas du design de votre site. Aucun thème, aucune apparence imposée, aucun « template de template ». En pratique, la partie visible de votre Project est du code Astro et Tailwind ordinaire — le vôtre.

Kreiz est un starter code-first : le site est du code, et le modifier demande de lire du code — sauf si vous faites lire ce code à une IA. C'est le pari de Kreiz : un moteur stable et lisible, un Project que vous — ou votre IA — modifiez librement, sans page builder ni abonnement.

Si vous voulez voir à quoi ressemble un site Kreiz, la démonstration (apps/demo) est la référence : trois types de contenu, un formulaire, une identité complète.