Mode d'emploi
- Saisissez le Nom et le Nom court, puis l'Adresse de départ (start_url) et le Périmètre (scope) de l'application.
- Choisissez le Mode d'affichage, et saisissez la Couleur de fond et la Couleur du thème en couleurs hexadécimales.
- Écrivez une icône par ligne sous Icônes : l'adresse, puis les tailles, le type et les usages, séparés par des barres.
- Enregistrez le texte sous manifest.webmanifest, et corrigez chaque avertissement listé sous Contrôles d'installabilité.
Ce que signifient les membres
Le manifeste est un fichier JSON. Ses membres sont décrits dans la spécification W3C Web Application Manifest (section 1). Seuls les membres que vous remplissez sont écrits, si bien qu'un champ vide laisse son membre absent. Le mode d'affichage détermine la façon dont le navigateur montre l'application ; si le navigateur ne prend pas un mode en charge, il utilise le suivant de cette chaîne (section 6) : plein écran, puis autonome, puis interface minimale, puis navigateur.
Une adresse de départ située sur une autre origine que la page est ignorée, car la spécification demande la même origine. Un périmètre n'est utilisé que s'il contient l'adresse de départ ; sinon, les navigateurs utilisent le périmètre qui correspond à l'adresse de départ sans son nom de fichier, sa requête et son fragment.
Ce que vérifient les avertissements
MDN liste les membres dont les navigateurs basés sur Chromium ont besoin avant de proposer l'installation d'une application web : un nom ou un nom court, des icônes de 192 px et de 512 px, une adresse de départ et un mode d'affichage. Il indique aussi que le site doit être servi en https, ou depuis localhost, et qu'un service worker n'est pas obligatoire. Firefox n'installe pas une application web à partir d'un fichier manifeste sur ordinateur.
L'outil vérifie les membres ci-dessus et la règle du périmètre. Il ne teste ni les fichiers d'icônes, ni l'adresse HTTPS, ni le lien de vos pages : c'est à vous de les confirmer.
Les valeurs par défaut
Avec les valeurs de départ de la page, le manifeste contient les membres ci-dessous. Les contrôles n'affichent aucun avertissement, car le nom, l'adresse de départ et les deux tailles d'icône sont présents.
| Membre | Valeur |
|---|---|
| name, short_name | Notes, Notes |
| start_url, scope | /, / |
| display | standalone |
| background_color, theme_color | #ffffff, #1f6feb |
| icons | fichiers PNG de 192x192 et 512x512 ; l'icône 512 a l'usage any maskable |
Questions fréquentes
Où enregistrer le fichier de manifeste ?
Enregistrez-le à la racine du site, ou dans le dossier de l'application, et nommez-le manifest.webmanifest. Reliez-le ensuite depuis chaque page de l'application par un élément link dont rel vaut manifest, comme le décrit MDN.
Ai-je besoin d'un service worker pour installer l'application ?
Non. MDN indique qu'un service worker n'est pas une condition pour qu'une PWA soit installable, même si beaucoup d'applications en utilisent un pour fonctionner hors connexion. Le site doit tout de même être servi en https, ou depuis localhost.
Quelles tailles d'icône faut-il ?
MDN liste une icône de 192 px et une de 512 px pour les navigateurs basés sur Chromium. Écrivez les tailles sous la forme LARGEURxHAUTEUR, séparées par des espaces lorsqu'un fichier en a plusieurs. Un fichier SVG peut avoir la taille any.
Quelle différence y a-t-il entre le nom court et le nom ?
Le nom est le nom complet de l'application. Le nom court sert aux endroits où la place manque, comme le libellé sous l'icône sur un écran d'accueil. Donnez au moins l'un des deux : cet outil avertit lorsque les deux sont vides.
Pourquoi l'outil avertit-il au sujet du périmètre ?
Un périmètre n'est utilisé que s'il contient l'adresse de départ (W3C, section 1). Si l'adresse de départ est hors du périmètre, les navigateurs ignorent le périmètre et utilisent le leur par défaut ; l'application peut alors s'ouvrir en dehors de la zone que vous vouliez.
Sources
- W3C (en anglais) : Web Application Manifest, projet de travail du 6 novembre 2026, sections 1, 2 et 6
- MDN (en anglais) : Making PWAs installable
- MDN (en anglais) : membre display du manifeste d'application web
- MDN (en anglais) : membre icons du manifeste d'application web
Chiffres et texte vérifiés pour la dernière fois le mardi 10 novembre 2026.