Configuration requise
Ce qu'il faut installer avant de lancer votre pack, avec ou sans Docker.
Pour le pack Front + Back
Ce que contient chaque pack
| Pack | Applications incluses dans le téléchargement | Fonctionne seul |
|---|---|---|
| Full Stack | Tableau de bord et API | Oui, les deux ensemble |
| Tableau de bord admin | Tableau de bord | Oui, sur sa fausse API intégrée avec des données d'exemple, ou relié à une API |
Le code de l'API NestJS n'est que dans le pack Full Stack. Le pack Admin Dashboard fonctionne sans elle, sur des données d'exemple conservées dans votre navigateur.
Avec Docker
- Docker Desktop sous macOS ou Windows, ou Docker Engine avec le plugin Compose sous Linux. Les deux applications démarrent avec une seule commande
docker compose. - Une connexion internet pour le premier build, qui télécharge les images de base et les dépendances.
- Rien d'autre : Docker fournit Node.js, et la base de données est un fichier SQLite dans un volume Docker.
Avec Docker
- Docker Desktop sous macOS ou Windows, ou Docker Engine sous Linux. Le tableau de bord a son propre
Dockerfile; Compose n'est pas nécessaire. - Une connexion internet pour le premier build, qui télécharge l'image de base et les dépendances.
Sans Docker
- Node.js 22.9 ou plus récent. Vérifiez la vôtre avec
node -v. Les images Docker utilisent Node.js 24. - Yarn 4, via Corepack. Lancez
corepack enableune fois ; chaque application fixe Yarn 4.8.1 dans sonpackage.json, doncyarnchoisit cette version. Node.js 25 et les versions plus récentes sont livrés sans Corepack : lancez d'abordnpm install -g corepack, puiscorepack enable. - Aucun paquet global. Chaque application fournit son
yarn.lock, doncyarn installinstalle les versions exactes avec lesquelles le template a été testé.
Base de données
Aucun serveur de base de données. L'API utilise SQLite par défaut et yarn seed crée le fichier pour vous ; Docker utilise aussi SQLite. MySQL est pris en charge par un changement de configuration, pas de code.
Ports
Chaque application écoute sur un port local fixe. Vérifiez que rien d'autre ne les utilise, ou, avec Docker, déplacez-en un avec DASHBOARD_PORT ou API_PORT dans un .env à côté de docker-compose.yml.
| Application | Port |
|---|---|
| Tableau de bord | 3030 |
| API | 8000 |
Port
Le tableau de bord écoute sur le port 3030. Vérifiez que rien d'autre ne l'utilise, ou lancez-le sur un autre.
Services optionnels
Rien de tout cela n'est nécessaire pour lancer le tableau de bord en local. Chaque élément s'active par ses variables ; laissé vide, sa fonctionnalité reste désactivée et tout le reste fonctionne.
| Service | Sans lui |
|---|---|
| Une clé d'API Google Gemini, OpenAI ou DeepSeek, dans les paramètres de l'API | L'assistant IA demande à chaque personne sa propre clé pour ce fournisseur, qui reste dans son navigateur. Sur la fausse API, l'assistant répond à partir des données d'exemple et n'a besoin d'aucune clé. |
| Un bucket Cloudflare R2 | Les photos de profil et les pièces jointes du chat ne peuvent pas être envoyées : l'envoi répond qu'il n'est pas configuré. Sur la fausse API, les photos sont conservées dans le navigateur. |
| Une clé WeatherAPI.com | Le message d'accueil de la vue d'ensemble s'affiche sans la météo. |
| Une clé MCP de votre choix | Le endpoint MCP de l'API refuse toutes les requêtes. |