Aller au contenu

Ton premier site en 10 minutes

Ce guide part de zéro et s’arrête à un astro build vert. La première page s’affiche sans compte : le starter embarque un snapshot de démonstration lu hors-ligne. Compte la création de compte à part, le reste tient en dix minutes.

  1. Créer le projet et le lancer

    Le starter installe un site Astro avec le loader Menestrel déjà câblé et une fixture hors-ligne.

    Fenêtre de terminal
    npm create menestrel@latest mon-site
    cd mon-site
    npm run dev

    Ouvre http://localhost:4321/. La page d’accueil, une fiche service et le badge Menestrel s’affichent, servis par le snapshot embarqué.

  2. Faire le tour du template

    Trois fichiers suffisent à comprendre le câblage :

    • src/content.config.ts : chaque collection déclare loader: menestrelLoader({ collection: '...' }).
    • src/layouts/Layout.astro : <CmsSeo>, la feuille richtext-styles.css et <MenestrelBadge>.
    • src/pages/services/[slug].astro : getStaticPaths sur les entrées, <RichText> et <CmsImage> sur les champs.
  3. Créer un projet et un token

    Dans l’admin Menestrel, crée un projet, puis un token de portée admin. Garde-le : menestrel init va le poser dans un fichier .env non versionné.

  4. Brancher le projet et pousser le schéma

    Depuis la racine du site, init écrit la config, le .env et les extraits à coller. sync envoie ton schéma au serveur.

    Fenêtre de terminal
    npx menestrel init --token cmt_adm_xxx
    npx menestrel sync --yes
  5. Éditer, publier, builder

    Édite une entrée dans l’admin et publie-la. Récupère le snapshot publié et lance le build : les pages reflètent le contenu publié.

    Fenêtre de terminal
    npx menestrel pull
    npm run build

En production, ne dépends pas de l’admin au moment du build. Pose MENESTREL_CONTENT_URL sur l’URL du snapshot publié : le build passe même si l’application est éteinte. Voir Variables d’environnement.