Un guide pratique pour configurer Terminal, VS Code, GitHub, Claude Code, Vercel et Supabase — d'un simple blog avec CMS à une véritable application de gestion de tables. Ce guide vous accompagne à travers chaque outil avec de vrais prompts IA que vous pouvez utiliser immédiatement.
| Tool | Role | Free Tier |
|---|---|---|
⌨️ Terminal | Local dev environment — shell, Node.js, Git, package manager | ✓ Always free |
| Editor + AI integration — extensions, workspace config, inline completions | ✓ Always free | |
| Source control + CI/CD — branches, PRs, Actions workflows | ✓ Unlimited public repos | |
| AI pair programmer — reads your codebase, writes files, runs commands | ✓ Free tier available | |
| DB + Auth + Storage — Postgres, Row Level Security, Realtime | ✓ 2 projects, 500MB DB | |
| Hosting + CDN — auto-deploy on push, edge functions, preview URLs | ✓ 100GB bandwidth/mo | |
| Edge hosting + CDN — Pages for static/SSR, Workers for serverless logic | ✓ Unlimited requests | |
| UI design tool — open-source Figma alternative, design-to-code | ✓ Always free | |
| Cloud dev environment — open any GitHub repo instantly, no local setup | ✓ Free personal use |
✦ Penpot : concevoir avant de construire
Avant d'écrire une seule ligne de code, esquissez votre interface dans Penpot — l'alternative à Figma open source et basée navigateur, entièrement gratuite. Clarifier d'abord vos mises en page et la structure de vos composants fait gagner des heures de refactorisation plus tard.
Explorez la galerie de modèles Next.js sur vercel.com/templates — filtrez par cas d'usage (blog, e-commerce, SaaS, portfolio) pour trouver des points de départ prêts pour la production. Beaucoup incluent déjà Supabase, Auth.js ou Tailwind préconfigurés.
01 — GitHub : contrôle de version et CI/CD
GitHub est l'endroit où vit votre code, où les coéquipiers collaborent, et où les déploiements sont déclenchés. Configurer correctement votre dépôt dès le premier jour évite bien des maux de tête plus tard.
▶ show code▼ hide code
# Authenticate, create repo, and push
gh auth login
git init && git add . && git commit -m "init"
gh repo create my-blog --public --source=. --push
# Force a redeploy on Vercel without a code change
git commit --allow-empty -m "redeploy"
git push
Reliez votre dépôt GitHub à Vercel et il se déploiera automatiquement à chaque push sur main, en plus de créer des déploiements de prévisualisation pour chaque pull request. L'astuce git commit --allow-empty est pratique pour déclencher un nouveau déploiement quand les variables d'environnement changent mais que votre code n'a pas bougé.
GitLab fonctionne partout où GitHub fonctionne — Vercel et Cloudflare Pages se connectent tous deux aux dépôts GitLab. Installez le CLI GitLab et remplacez gh par glab :
▶ show code▼ hide code
brew install glab # macOS
sudo apt install glab -y # Ubuntu / WSL2
glab auth login
glab repo create my-blog --public
git remote set-url origin https://gitlab.com/yourname/my-blog.git
git push -u origin main
Le CI/CD intégré de GitLab (.gitlab-ci.yml) est une solide alternative à GitHub Actions pour les équipes déjà dans l'écosystème GitLab.
02 — Terminal et Claude Code
Tout commence par une bonne configuration de terminal. Mettre en place votre shell, Node.js et Git prend environ 10 minutes — et vous prépare pour tout ce qui suit.
▶ show code▼ hide code
# macOS — Install Homebrew, then essentials
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node git gh
npm install -g pnpm
# Windows — Install WSL2 (run in PowerShell as Administrator)
wsl --install
# After restart, open Ubuntu and run:
sudo apt update && sudo apt install nodejs npm git -y
npm install -g pnpm gh
# Verify installs
node --version && git --version && gh --version
# Clone an existing repo to a new machine
git clone https://github.com/yourname/my-blog.git
cd my-blog && pnpm install
Claude Code est un agent IA natif au terminal qui lit l'intégralité de votre codebase, écrit des fichiers, exécute des commandes, et itère jusqu'à ce que la fonctionnalité marche. C'est le multiplicateur qui fait qu'un seul développeur se sent comme une équipe entière.
▶ show code▼ hide code
npm install -g @anthropic-ai/claude-code
cd my-blog && claude
✦ VS Code : votre éditeur
VS Code est plus qu'un éditeur de texte — avec les bonnes extensions et les bons réglages, il devient un IDE qui comprend l'intégralité de votre codebase. La clé est de le configurer une fois, correctement.
▶ show code▼ hide code
code --install-extension dbaeumer.vscode-eslint
code --install-extension esbenp.prettier-vscode
code --install-extension bradlc.vscode-tailwindcss
code --install-extension anthropics.claude-code
code --install-extension rangav.vscode-thunder-client
code --install-extension eamodio.gitlens
Extensions essentielles :
- IA hybride — Hugging Face et Claude — faites tourner un agent Hugging Face auto-hébergé pour les audits, la documentation, la recherche, les revues, les PR et les plans, tout en réservant Claude Code aux refactorisations, bugs et migrations. Inclut des prompts Claude Code pour chaque domaine de travail et une comparaison de coûts montrant combien vous économisez.
- Prettier + ESLint — gardez le code propre automatiquement. Prettier formate à l'enregistrement, ESLint détecte les bugs avant qu'ils n'atteignent vos coéquipiers.
- Thunder Client — testez vos routes API sans quitter l'éditeur. Une alternative légère à Postman intégrée directement.
- GitLens — comprenez l'historique de chaque ligne d'un coup d'œil. Survolez n'importe quelle ligne pour voir qui l'a écrite, quand, et pourquoi.
03 — Vercel : déployez en 30 secondes
Vercel est la maison de Next.js et le moyen le plus rapide de mettre votre application en ligne. Connectez votre dépôt GitHub une fois, et chaque push sur main se déploie automatiquement.
▶ show code▼ hide code
npm install -g vercel && vercel
# Or connect GitHub at vercel.com/new — 3 clicks
Après le déploiement, retournez dans Supabase → Authentication → URL Configuration et ajoutez votre URL Vercel en production à la liste des Redirect URLs.
Après le déploiement, allez dans votre projet Vercel → Settings → Environment Variables et ajoutez NEXT_PUBLIC_SUPABASE_URL et NEXT_PUBLIC_SUPABASE_ANON_KEY pour tous les environnements. Déclenchez ensuite un redéploiement : git commit --allow-empty -m "add env vars" && git push
Vercel Hobby : projets personnels illimités, 100 Go de bande passante/mois. Supabase gratuit : 2 projets, 500 Mo de base de données, 1 Go de stockage. Toute cette pile est gratuite pour des projets personnels.
✦ Cloudflare Pages : l'alternative à Vercel
Cloudflare Pages est une alternative convaincante à Vercel — surtout si vous voulez une diffusion edge mondiale, zéro cold start, et aucun plafond de bande passante. Il se connecte à GitHub tout comme Vercel et se déploie automatiquement à chaque push sur main. La différence clé : votre application tourne sur le réseau edge de Cloudflare dans plus de 300 emplacements plutôt que sur une poignée de régions serverless.
▶ show code▼ hide code
# Install the adapter for Next.js on Cloudflare
npm install --save-dev @cloudflare/next-on-pages
# Add the build script to package.json
# "build:cf": "next build && npx vercel-build"
# Deploy via CLI
npx wrangler pages deploy .vercel/output/static
# Or connect GitHub at pages.cloudflare.com — same 3-click flow as Vercel
Cloudflare Pages utilise l'Edge Runtime — pas Node.js. Cela signifie que fs, path, et certaines API spécifiques à Node ne sont pas disponibles dans les gestionnaires de routes. La plupart des applications Next.js fonctionnent sans modification, mais vérifiez toute route API personnalisée pour des imports réservés à Node avant de basculer.
🤖AI Prompt — Configuration Cloudflare Pagesdeploy▾
Set up my Next.js app to deploy on Cloudflare Pages:
-
Install and configure @cloudflare/next-on-pages
-
Create wrangler.toml with:
- Project name and compatibility date
- KV namespace bindings for caching
- Environment variable placeholders
-
Update package.json scripts for:
- Local preview with wrangler pages dev
- Production build for Cloudflare
-
Create functions/api/contact.ts — a Pages Function that handles contact form POST requests and forwards to Discord webhook or Resend email
-
.github/workflows/deploy.yml that:
- Runs on push to main
- Builds with next-on-pages
- Deploys to Cloudflare Pages via wrangler
Output all config files ready to commit.
Vercel est la voie de moindre résistance pour Next.js — zéro configuration, URL de prévisualisation instantanées, et support natif de l'ISR. Cloudflare Pages gagne sur le prix (pas de frais de bande passante, pas de limite d'invocations de fonctions) et convient mieux si vous utilisez déjà Cloudflare pour le DNS, Workers, ou le stockage R2. Les deux ont des niveaux gratuits généreux pour les projets personnels.
04 — Supabase : votre backend prêt à l'emploi
Supabase vous donne Postgres, l'authentification, le stockage de fichiers et les abonnements en temps réel — le tout avec des types TypeScript générés automatiquement et un niveau gratuit généreux.
▶ show code▼ hide code
brew install supabase/tap/supabase
pnpm add @supabase/supabase-js @supabase/ssr
supabase gen types typescript --project-id YOUR_ID > types/database.ts
Checklist de configuration de l'authentification :
- L'authentification par e-mail est activée — vérifiez sous Providers → Email.
- L'URL du site est définie — allez dans Authentication → URL Configuration et définissez votre domaine de production.
- Les Redirect URLs sont configurées — ajoutez à la fois
http://localhost:3000/**et votre URL Vercel à la liste des Redirect URLs. Sans cela, les liens magiques seront bloqués. - Les clés API sont dans Vercel — copiez
NEXT_PUBLIC_SUPABASE_URLetNEXT_PUBLIC_SUPABASE_ANON_KEYdepuis Project Settings → API, puis ajoutez-les aux variables d'environnement Vercel.
Si les liens magiques ou les connexions OAuth redirigent vers une page d'erreur, c'est presque toujours une Redirect URL manquante. Assurez-vous que http://localhost:3000/** et votre domaine Vercel en production figurent bien dans la liste des Redirect URLs — le suffixe joker /** est requis.
✦ CodeSandbox : codez de n'importe où
CodeSandbox vous permet d'ouvrir n'importe quel dépôt GitHub dans un environnement de développement cloud complet — aucune installation locale requise. Parfait pour des modifications rapides en déplacement, l'intégration de contributeurs, ou tester une branche sur une machine qui n'a pas votre environnement de développement.
Préfixez simplement n'importe quelle URL GitHub par codesandbox.io/p/github/ et votre dépôt s'ouvre dans un éditeur façon VS Code avec un serveur de développement en cours d'exécution, un accès terminal, et une intégration de prévisualisation Vercel intégrée.
▶ show code▼ hide code
# Open any GitHub repo in CodeSandbox instantly:
# https://codesandbox.io/p/github/yourname/my-blog
# Or install the browser extension to add an
# "Open in CodeSandbox" button on every GitHub repo page
# Devboxes persist your environment — install deps once,
# resume your session later exactly where you left off
Utilisez CodeSandbox quand vous êtes loin de votre machine principale, en train de revoir une PR sur une tablette, ou que vous voulez prototyper un composant sans polluer votre branche locale. Vos variables .env.local peuvent être stockées comme secrets chiffrés dans CodeSandbox afin que votre connexion Supabase fonctionne aussi dans le cloud.
🤖AI Prompt — Configuration Devbox CodeSandboxcloud dev▾
Create a .codesandbox/tasks.json configuration for my Next.js project so it starts correctly every time I open it in CodeSandbox:
Requirements:
- Auto-run pnpm install on first open
- Start the Next.js dev server on port 3000
- Show the preview in the right panel automatically
- Set Node.js version to 20 LTS
Also show me:
- How to add Supabase env vars as CodeSandbox secrets
- How to share a live preview URL with a teammate
- The .devcontainer/devcontainer.json equivalent for opening the same environment in GitHub Codespaces
Output all config files ready to commit.
Si vous cherchez une application prête à l'emploi construite exactement sur cette pile, Open Technology App est une plateforme de file de tâches et de gestion de workflow auto-hébergée sur Vercel et Supabase — gratuite pour démarrer.