Dépannage

Docker n'est pas lancé

failed to connect to the docker API at unix:///…/docker.sock; check if the path is correct and if the daemon is running

Les anciennes versions de Docker affichent plutôt « Cannot connect to the Docker daemon ». Dans les deux cas, le moteur Docker n'est pas démarré.

1. 01

   Ouvrez Docker Desktop

   Lancez Docker Desktop et attendez qu'il indique que le moteur est en marche. Sous Linux, démarrez le service : sudo systemctl start docker.
2. 02

   Vérifiez que Docker répond

   TerminalCopier

   docker info

   Résultat attendu: Une section Server s'affiche au lieu d'une erreur.
3. 03

   Relancez votre commande

   docker build -t financial-dashboard ., puis docker run -p 3030:3030 financial-dashboard.

Un port est déjà utilisé

Bind for 0.0.0.0:3030 failed: port is already allocated
ports are not available: exposing port TCP 0.0.0.0:3030 … bind: address already in use
Error: listen EADDRINUSE: address already in use :::3030

Les deux premières lignes viennent de Docker, la dernière de yarn dev ou yarn start. Un autre programme écoute déjà sur le port 3030 : souvent un lancement précédent de ce tableau de bord, ou le serveur d'un autre projet.

1. 01

   Trouvez ce qui occupe le port

   Sous macOS ou Linux :

   TerminalCopier

   lsof -i :3030

   Sous Windows, dans PowerShell :

   TerminalCopier

   netstat -ano | findstr :3030
2. 02

   Arrêtez-le

   Fermez ce programme, ou arrêtez le lancement précédent : Ctrl+C dans son terminal, ou docker stop avec l'ID du conteneur donné par docker ps. Puis redémarrez le tableau de bord.
3. 03

   Ou utilisez un autre port

   Gardez l'autre programme et démarrez le tableau de bord sur un port libre, ici 3041 :

   Comment vous la lancez	Commande
   Docker	docker run -p 3041:3030 financial-dashboard
   Serveur de développement	yarn dev -p 3041
   Build de production	yarn start -p 3041

   Avec Docker, changez seulement le nombre à gauche de -p : l'application dans le conteneur écoute toujours sur 3030.

   Résultat attendu: Le tableau de bord répond sur localhost:3041Local.

Le build échoue

docker build s'arrête avec « failed to solve » et l'étape qui a échoué ; yarn build s'arrête avec l'erreur elle-même. Les causes habituelles :

• Pas de connexion ou délai dépassé : la construction télécharge les dépendances, ainsi que les polices Inter et Noto Sans Arabic depuis Google Fonts. Un message comme « Failed to fetch Inter from Google Fonts. » signifie que la construction n'a pas pu les atteindre. Relancez la commande une fois en ligne ; avec Docker, les étapes terminées sont conservées en cache.
• No space left on device : libérez de l'espace dans Docker Desktop, ou vérifiez ce que Docker occupe avec docker system df.
• L'échec survient toujours à la même étape : reconstruisez sans le cache.

docker build --no-cache -t financial-dashboard .

Sans Docker, supprimez les dossiers node_modules et .next, puis relancez yarn install et yarn build.

Yarn indique la version 1.22

This project's package.json defines "packageManager": "yarn@4.12.0". However the current global version of Yarn is 1.22…

Le projet impose Yarn 4 via Corepack. Ce message signifie que Corepack n'est pas encore activé, donc un ancien Yarn global a répondu à sa place.

corepack enable

Puis relancez yarn install. Utilisez Yarn plutôt que npm : yarn.lock garde votre installation sur les versions avec lesquelles le template a été testé.

La commande corepack est introuvable

corepack: command not found

Node.js 25 et les versions suivantes n'incluent plus Corepack. Installez-le une fois avec npm, puis activez-le :

npm install -g corepack
corepack enable

Puis relancez yarn install. Les mêmes deux commandes règlent yarn: command not found.

Node.js est trop ancien

You are using Node.js 18.20.4. For Next.js, Node.js version ">=20.9.0" is required.

Next.js 16 a besoin de Node.js 20.9 ou plus récent. Vérifiez votre version avec node -v. Installez Node.js 22 ou 24, ouvrez un nouveau terminal, relancez corepack enable, puis yarn install et yarn dev.

Avec Docker, cela ne s'applique pas : l'image apporte son propre Node.js 24.

La connexion est refusée

The email or password is incorrect.

Le tableau de bord n'accepte qu'un seul compte. Saisissez ses identifiants exactement : le mot de passe est sensible à la casse. Vérifiez-les dans le guide d'installation.

« Please enter a valid email address » ou « Password must be at least 6 characters » sous un champ signifie que le formulaire s'est arrêté avant de vérifier le compte : corrigez d'abord ce champ.

• Les identifiants de connexion

Le tableau de bord me renvoie à la page de connexion

Chaque page sous /dashboard demande un utilisateur connecté, et les autres sont renvoyés vers /login. La connexion fournie ne vous garde connecté que dans ce navigateur : vous vous reconnectez donc dans une fenêtre privée, dans un autre navigateur, après avoir effacé les données du site, ou après Logout dans le menu utilisateur ou Sign Out dans les paramètres.

• Comment fonctionne la connexion

Un paramètre modifié n'a aucun effet

NEXT_PUBLIC_DEMO_MODE et les autres valeurs NEXT_PUBLIC_ sont compilées dans l'application lors de sa construction. En modifier une ne change rien tant que l'application n'est pas reconstruite.

• Les paramètres

yarn start échoue, ou affiche une ancienne version

Could not find a production build in the '.next' directory. Try building your app with 'next build' before starting the production server.

yarn start sert le dernier build de production, depuis le dossier .next. Lancez d'abord yarn build, et de nouveau après chaque modification.

Si l'application affiche des erreurs qui ne correspondent pas à votre code, souvent après avoir changé la version d'une dépendance ou BUILD_STANDALONE, supprimez le dossier .next et reconstruisez :

rm -rf .next
yarn build

Sous Windows, dans PowerShell, supprimez-le avec Remove-Item -Recurse -Force .next.

La carte du monde reste vide

La carte du monde de la vue d'ensemble télécharge la forme des pays depuis cdn.jsdelivr.net, dans le navigateur. Sans connexion à internet, ou si un pare-feu bloque cette adresse, la carte n'affiche aucun pays. Le reste du tableau de bord fonctionne hors ligne.

• Servir la carte vous-même

Un bouton ne fait rien, ou n'enregistre rien

C'est ainsi que le template est livré. Il n'a pas de back end : les boutons qui demanderaient quelque chose à un serveur sont prêts pour votre propre code :

• Apple, Google, Remember me et Forgot password? sur la page de connexion.
• Add Transaction, le virement rapide et le transfert express : leurs formulaires s'ouvrent et vérifient ce que vous saisissez, mais rien n'est enregistré.
• Add Card sur la page des cartes, les boutons de recherche et d'actualisation de l'en-tête, et Save Changes et Help & Support dans les paramètres.

La plage de dates et la boîte de dialogue Filter de la page des transactions fonctionnent : elles réduisent le tableau dans le navigateur. Elle s'ouvre sur les 30 derniers jours, qui contiennent toutes les transactions d'exemple.

• Données d'exemple et votre API

Une nouvelle couleur de marque ne s'affiche pas

Avec le mode démo activé, le sélecteur de couleur flottant enregistre dans le navigateur la couleur que vous choisissez, et ce choix l'emporte sur la couleur définie dans le code. Choisissez la même couleur dans le sélecteur, ou effacez les données du site pour localhost:3030 dans votre navigateur. Avec le mode démo désactivé, l'application utilise toujours la couleur définie dans le code.

• Couleurs et mode sombre

Le tableau de bord s'ouvre en arabe

Ouvrir / envoie le visiteur vers /ar quand son navigateur préfère l'arabe, et vers /en sinon. Choisissez l'autre langue dans le menu des langues de l'en-tête, ou ouvrez /en/login directement.

• Langues

Le dossier ne correspond pas

Lancez les commandes dans le dossier où le ZIP s'extrait, dashboard-template-1. Il contient Dockerfile, package.json, yarn.lock, messages, public et src. Si la commande unzip est absente, extrayez le ZIP avec votre gestionnaire de fichiers ; certains outils ajoutent un dossier supplémentaire nommé d'après le ZIP, entrez alors dans le dossier intérieur.