Guide de demarrage rapide

Tout ce qu'il faut savoir pour lancer votre site en 5 minutes : installation, configuration, premier contenu, et deploiement.

Ce guide vous accompagne de l'installation au deploiement en quelques minutes.

1. Cloner et installer

git clone https://github.com/votre-user/votre-repo.git mon-site
cd mon-site
npm install

2. Configurer votre site

Ouvrez astro-frontend/src/lib/site.js et modifiez les constantes :

export const SITE_NAME = "Mon Super Site";
export const SITE_URL = "https://monsupersite.com";
export const SITE_DESCRIPTION = "Description de mon site.";
export const SITE_LANG = "fr";
export const SITE_LOCALE = "fr_FR";

3. Lancer en local

npm run dev

Ouvrez http://localhost:4321 dans votre navigateur. Le hot reload est actif : chaque modification de fichier rafraichit le navigateur.

4. Creer votre premier article

Creez un fichier content/fr/articles/mon-article.md :

---
type: blog
title: "Mon premier vrai article"
publishedAt: '2026-05-13T10:00:00.000Z'
seo:
  title: "Mon premier article"
  description: "Un article de test."
---

Le contenu de votre article ici, en **Markdown**.

Sauvegardez. L'article apparait automatiquement sur la homepage et dans /blog/.

5. Deployer

Option A : Vercel

npm i -g vercel
vercel

Option B : Hetzner / VPS

Configurez les secrets GitHub (SSH_PRIVATE_KEY, DEPLOY_HOST, DEPLOY_USER, DEPLOY_PATH) et poussez sur main. Le workflow GitHub Actions deploie automatiquement.

C'est tout

Votre site est en ligne. Pour aller plus loin, consultez le README du projet et le CLAUDE.md pour les instructions AI.