Guide d'installation
Guide d'installation avec Foundation Builder
Installation
Ce guide vous accompagne dans l'installation de Foundation Builder sur votre machine locale.
Prérequis
Avant de commencer, assurez-vous d'avoir installé :
- Node.js (version 18.17 ou supérieure)
- npm (version 9.0 ou supérieure)
- Git pour cloner le repository
Vérification des prérequis
# Vérifier la version de Node.js
node --version
# Vérifier la version de npm
npm --version
# Vérifier la version de Git
git --versionClonage du repository
1. Cloner le projet
# Cloner le repository
git clone https://github.com/votre-username/foundation.builder.git
# Se déplacer dans le dossier du projet
cd foundation.builder2. Vérifier la structure
Le projet devrait contenir les dossiers suivants :
foundation.builder/
├── src/
│ ├── app/ # Pages Next.js
│ ├── components/ # Composants réutilisables
│ ├── core/ # Architecture hexagonale
│ ├── lib/ # Utilitaires
| ├── blocks/ # Blocs de landing page
| └── content/ # Documentation
├── public/ # Assets statiques
├── package.json # Dépendances du projet
└── next.config.ts # Configuration Next.js3. Installer les packages
# Installer toutes les dépendances
npm install4. Copier le fichier d'environnement
# Copier le fichier d'exemple
cp .env.example .env.local5. Configurer les variables d'environnement
Ouvrez le fichier .env.local et configurez les variables nécessaires :
# Base de données
DATABASE_URL="postgresql://username:password@localhost:5432/database_name"
# Authentification
GOOGLE_CLIENT_ID="your_google_client_id"
GOOGLE_CLIENT_SECRET="your_google_client_secret"
AUTH_GITHUB_CLIENT_ID="your_github_client_id"
AUTH_GITHUB_CLIENT_SECRET="your_github_client_secret"
# Paiements
STRIPE_SECRET_KEY="sk_test_..."
STRIPE_WEBHOOK_SECRET="whsec_..."
# Emails
RESEND_API_KEY="re_..."
RESEND_FROM_EMAIL="noreply@yourdomain.com"
# Analytics
PLAUSIBLE_DOMAIN="yourdomain.com"
# Supabase
NEXT_PUBLIC_SUPABASE_URL="https://your-project.supabase.co"
NEXT_PUBLIC_SUPABASE_ANON_KEY="your_anon_key"6. Démarrer le serveur de développement
# Lancer le serveur de développement
npm run devLe serveur devrait démarrer sans erreur et afficher :
✓ Ready in 2.3s
✓ Local: http://localhost:3000
✓ Network: http://192.168.1.100:30007. Vérifier le fonctionnement
Ouvrez votre navigateur et accédez à http://localhost:3000
Vous devriez voir la page d'accueil de Foundation Builder.
Introduction
Un boilerplate Next.js suivant l'architecture hexagonale avec intégrations Firebase et Stripe
Architecture Hexagonale
Foundation Builder implémente une architecture hexagonale (Clean Architecture / Ports & Adapters) qui sépare clairement la logique métier des détails techniques et des dépendances externes. Cette approche garantit une application maintenable, testable et évolutive.