Skip to content
AMN Docs

01 - Configuration Environnement Local

01 - Configuration Environnement Local

Documentation technique

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

Terminal window
# 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

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

3.2. Remplir les variables1/2

.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

3.2. Remplir les variables2/2

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

Terminal window
# Authentification
wrangler login


# Vérification
wrangler whoami

4.2. Sanity CLI

Terminal window
# 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

Terminal window
# 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

8. Checklist de validation1/2

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é

8. Checklist de validation2/2

  • 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
Switch to normal mode

Contents

Built with StarlightPowered by Cloudflare