01 - Configuration Environnement Local

Audience : Nouveaux développeurs rejoignant l’équipe
Durée estimée : 30-45 minutes
Prérequis : Aucun

---

1. Prérequis

1.1. Outils requis

Outil	Version minimale	Installation
Node.js	20+	https://nodejs.org/
Git	2.30+	https://git-scm.com/
VS Code	Dernière	https://code.visualstudio.com/
Wrangler CLI	Dernière	npm install -g wrangler
Task	Dernière	go install github.com/go-task/task/v3/cmd/task@latest

1.2. Comptes requis

• Compte GitHub avec accès au repository
• Compte Cloudflare avec accès au workspace
• Compte Sanity avec accès au projet

---

2. Clonage du repository

# Cloner le repository
git clone git@github.com:votre-org/votre-repo.git

# Se déplacer dans le dossier
cd votre-repo

# Installer les dépendances
task install

---

3. Configuration des variables d’environnement

3.1. Création du fichier .env

# Copier le fichier d'exemple
cp .env.example .env

3.2. Remplir les variables

.env

SANITY_PROJECT_ID=your-project-id
SANITY_DATASET=production
SANITY_API_READ_TOKEN=your-read-token
SANITY_API_WRITE_TOKEN=your-write-token
SANITY_PREVIEW_SECRET=your-preview-secret

CLOUDFLARE_ACCOUNT_ID=your-account-id

Où trouver ces valeurs :

• SANITY_PROJECT_ID : Dashboard Sanity → Settings → API
• SANITY_DATASET : production ou staging
• SANITY_API_READ_TOKEN : Dashboard Sanity → Settings → API → Tokens
• SANITY_API_WRITE_TOKEN : Dashboard Sanity → Settings → API → Tokens
• SANITY_PREVIEW_SECRET : Généré aléatoirement (ex: openssl rand -base64 32)
• CLOUDFLARE_ACCOUNT_ID : Dashboard Cloudflare → Workers & Pages → Account ID

---

4. Authentification

4.1. Cloudflare Wrangler

# Authentification
wrangler login

# Vérification
wrangler whoami

4.2. Sanity CLI

# Authentification
sanity login

# Vérification
sanity manage whoami

---

5. Configuration VS Code

5.1. Extensions recommandées

Extension	Usage
Astro	Support Astro
Sanity	Support Sanity
Tailwind CSS IntelliSense	Support Tailwind
ESLint	Linting
Prettier	Formatting
GitLens	Git amélioré

5.2. Configuration .vscode/settings.json

{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  },
  "files.associations": {
    "*.astro": "astro"
  }
}

---

6. Vérification de l’installation

# Vérifier les dépendances
task install

# Vérifier le typecheck
task typecheck

# Vérifier le linting
task lint

---

7. Dépannage

7.1. Problèmes courants

Symptôme	Cause probable	Solution
task install échoue	Version Node.js incompatible	Mettre à jour Node.js
wrangler login échoue	Permissions insuffisantes	Vérifier les permissions Cloudflare
Variables d’environnement non chargées	Fichier .env manquant	Créer le fichier .env

7.2. Ressources

• Documentation Astro : https://docs.astro.build/
• Documentation Sanity : https://www.sanity.io/docs
• Documentation Cloudflare : https://developers.cloudflare.com/

---

8. Checklist de validation

Avant de passer au lancement des services, vérifier :

• Node.js 20+ installé
• Git installé
• VS Code installé
• Wrangler CLI installé
• Task installé
• Repository cloné
• Dépendances installées
• Variables d’environnement configurées
• Authentification Cloudflare réussie
• Authentification Sanity réussie
• Typecheck passe
• Linting passe

---

9. Prochaine étape

Une fois la configuration terminée, passer à : 02 - Lancement des Services

---

10. Historique des modifications

Date	Version	Description	Auteur
2026-09-16	1.0	Création initiale	Devin