Skip to content

Installation FR

Alex RAMIREZ edited this page Oct 9, 2026 · 3 revisions

🇬🇧 English version

Installation

Maquette tient en un seul fichier JavaScript, maquette-card.js : la carte, son éditeur, les textes français et anglais et la démo sont dedans. Rien d'autre à installer : ni intégration, ni module complémentaire.

Prérequis

  • Home Assistant 2023.9 ou plus récent (la version déclarée à HACS). Voir FAQ › Quelle version de Home Assistant ?
  • Un navigateur récent ou l'application compagnon : Chrome / Edge 111+, Safari 16.4+ (iOS 16.4+), Firefox 121+ (la carte utilise color-mix() et :has()). Maquette est développée et testée avec des navigateurs Chromium.
  • Pour modifier le plan : un compte administrateur Home Assistant. Les autres utilisateurs voient le plan, jamais l'éditeur.

Avec HACS (dépôt personnalisé)

  1. Dans Home Assistant, ouvrir HACS.
  2. Menu ⋮ › Dépôts personnalisés.
  3. Dépôt : https://github.com/TooMuhtsh/maquette-card, type Dashboard (Tableau de bord), puis Ajouter.
  4. Chercher Maquette dans HACS, l'ouvrir et cliquer sur Télécharger.
  5. Recharger le navigateur (ou fermer et rouvrir l'application) quand HACS le demande.

HACS ajoute la ressource du tableau de bord. Les mises à jour apparaissent ensuite dans HACS comme pour toute carte ; la 0.2.0 est une version stable, l'interrupteur Pre-release n'est pas nécessaire.

Installation manuelle

  1. Télécharger maquette-card.js dans les fichiers de la dernière version du dépôt (GitHub › Releases).
  2. Le copier dans /config/www/maquette-card.js (le dossier www de la configuration ; le créer au besoin, puis redémarrer Home Assistant une fois pour que /local/ soit servi).
  3. Paramètres › Tableaux de bord › ⋮ › Ressources › Ajouter une ressource :
    • URL : /local/maquette-card.js
    • Type de ressource : Module JavaScript
  4. Recharger le navigateur.

Le menu Ressources n'apparaît qu'avec le mode avancé activé dans votre profil utilisateur.

Pour une mise à jour manuelle, remplacer le fichier et changer l'URL de la ressource pour forcer le navigateur à le recharger, par exemple /local/maquette-card.js?v=2.

Vérifier que c'est chargé

  • Dans l'éditeur, ⚙ Paramètres affiche la version installée sous son titre (Maquette 0.2.0), avec les liens Documentation et Signaler un problème.
  • La console du navigateur (F12) affiche aussi un bandeau bleu MAQUETTE 0.2.0 au chargement du fichier.
  • Dans un tableau de bord, Ajouter une carte propose Maquette et Maquette — démo.
  • Paramètres › Tableaux de bord › Ajouter un tableau de bord propose Maquette (un plan vierge) et Maquette — démo (dans les versions de Home Assistant qui listent les stratégies de tableau de bord personnalisées ; sinon, ajoutez la carte à n'importe quel tableau de bord).

Ensuite

Premiers pas : votre premier plan en quelques minutes.

Clone this wiki locally