Créer votre premier site.

Partez du template Kreiz

Sur GitHub, ouvrez cyril-belin/kreiz et cliquez« Use this template ». Vous obtenez votre propre copie du dépôt : c'est votre site. Kreiz ne s'installe pas depuis npm — le starter entier (moteur + site de démonstration) devient votre point de départ.

Pas encore de compte GitHub ? Téléchargez l'archive ZIP du dépôt (télécharge le fichier ZIP) et décompressez-la — vous pourrez relier votre dossier à GitHub plus tard.

Ouvrez le projet dans votre outil

À la main : votre éditeur habituel. Assisté par IA : un agent qui lit et modifie le dossier du projet — Codex, Claude Code, Cursor, Windsurf… — ouvre ce dépôt tel quel. La pageKreiz et l'IA vous donne le prompt maître pour cadrer la session dès le départ.

Installez les dépendances

Deux commandes à la racine. Le build compile d'abord le moteur, puis le site de démonstration : si tout passe, votre environnement est prêt.

pnpm install
pnpm build

Créez votre application

Le site visible vit dans une application sous apps/. Le plus court chemin : partir de la démonstration — apps/demo est un site complet et fonctionnel — et l'adapter. Copiez-la, renommez son paquet danspackage.json, puis réinstallez.

cp -R apps/demo apps/mon-site
rm -rf apps/mon-site/node_modules apps/mon-site/dist apps/mon-site/.astro
pnpm install

Quelques scripts du dépôt ciblent @kreiz/demo — renommez-les pour votre application. Le détail exact est dans leguide développeur (ouvre GitHub dans un nouvel onglet).

Décrivez le site que vous voulez

Pages, types de contenu, ton, style : c'est le moment de dire ce que vous voulez. Écrivez le code vous-même — ou décrivez-le à votre IA dans une phrase simple : « Crée un site pour un garage automobile avec Accueil, Services, Véhicules, À propos, Contact. » Leprompt maître lui donne le cadre Kreiz.

Lancez le site en local

Copiez apps/mon-site/.env.example en .env et renseignez deux valeurs : votre base (KREIZ_DATABASE_URL) et une clé secrète (KREIZ_SECRET). Appliquez les migrations, puis lancez le serveur.

pnpm --filter @kreiz/mon-site db:migrate
pnpm --filter @kreiz/mon-site dev

Le site tourne sur http://127.0.0.1:4321. Lesvariables détaillées sont documentées page Déployer.

Entrez dans le back-office

Créez d'abord votre compte administrateur avec la CLI Kreiz (elle litKREIZ_DATABASE_URL ; si votre shell ne charge pas le.env, exportez-la d'abord), puis ouvrez /admin et connectez-vous.

pnpm --filter @kreiz/mon-site exec kreiz admin:create

Le back-office est privé et fourni par le Core : contenus, médiathèque, formulaires reçus, analytics. Vous ne l'écrivez pas — vous créez votre compte, puis vous l'adaptez par la configuration.

Créez du contenu

Un type de contenu devient un formulaire dans l'admin. Remplissez les champs, ajoutez une image de la médiathèque, prévisualisez avec vos vrais templates — et enregistrez autant de fois que vous voulez : un brouillon n'est pas public.

Publiez

Publier fige une copie publique du contenu et demande la reconstruction du site. Votre page apparaît au prochain build — et changer son adresse crée automatiquement une redirection. C'est la règle d'or de Kreiz :enregistrer n'est jamais publier.

Déployez

Vercel est la cible de référence : le site public est prérendu en statique, le back-office tourne sur une petite fonction serveur, et un deploy hook reconstruit le site à chaque publication. La pageDéployer donne les variables et le cycle complet.