Retour au blog

Construire et déployer une application Next.js avec Claude, Vercel et Supabase

17 mars 20267 min
Outils de développement

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.

ToolRoleFree Tier
⌨️
Terminal
Local dev environment — shell, Node.js, Git, package managerAlways free
VS Code
VS Code
Editor + AI integration — extensions, workspace config, inline completionsAlways free
GitHub
GitHub
Source control + CI/CD — branches, PRs, Actions workflowsUnlimited public repos
Claude Code
Claude Code
AI pair programmer — reads your codebase, writes files, runs commandsFree tier available
Supabase
Supabase
DB + Auth + Storage — Postgres, Row Level Security, Realtime2 projects, 500MB DB
Vercel
Vercel
Hosting + CDN — auto-deploy on push, edge functions, preview URLs100GB bandwidth/mo
Cloudflare
Cloudflare
Edge hosting + CDN — Pages for static/SSR, Workers for serverless logicUnlimited requests
Penpot
Penpot
UI design tool — open-source Figma alternative, design-to-codeAlways free
CodeSandbox
CodeSandbox
Cloud dev environment — open any GitHub repo instantly, no local setupFree 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.

🔗 Besoin d'une longueur d'avance ?

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
# 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
📌 Remarque

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 comme alternative

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
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
# 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
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
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
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.

🔑 Connectez vos clés Supabase

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

💡 Vérité sur le niveau gratuit

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
# 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
📌 Next.js sur Cloudflare

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 Pages
deploy

Set up my Next.js app to deploy on Cloudflare Pages:

  1. Install and configure @cloudflare/next-on-pages

  2. Create wrangler.toml with:

    • Project name and compatibility date
    • KV namespace bindings for caching
    • Environment variable placeholders
  3. Update package.json scripts for:

    • Local preview with wrangler pages dev
    • Production build for Cloudflare
  4. Create functions/api/contact.ts — a Pages Function that handles contact form POST requests and forwards to Discord webhook or Resend email

  5. .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.

💡 Cloudflare contre Vercel — lequel choisir

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
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_URL et NEXT_PUBLIC_SUPABASE_ANON_KEY depuis Project Settings → API, puis ajoutez-les aux variables d'environnement Vercel.
⚠️ Piège courant

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
# 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
💡 Meilleurs cas d'usage

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 CodeSandbox
cloud 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.

Contactez-moi

Un sujet vous intéresse ? Laissez un mot et choisissez une catégorie. Je suis aussi disponible pour une réunion de conseil gratuite — écrivez-moi et nous organiserons cela.