À retenir
- Créer une PWA repose sur trois briques : HTTPS, un manifest et un service worker.
- Chrome exige un manifest complet avec des icônes de 192 et 512 pixels pour proposer l'installation.
- Lighthouse n'audite plus les PWA : le panneau Application des outils de développement prend le relais.
Les étapes pour créer une PWA en 2026
Ce guide s'adresse aux développeurs et aux équipes techniques qui veulent rendre un site existant installable ou démarrer une application web progressive. Si vous cherchez d'abord à savoir ce qu'est une PWA et ce qu'elle apporte à votre entreprise, notre article PWA : définition, avantages et sobriété pose les bases avant de passer au code.
Une progressive web app reste un site web : elle s'appuie sur le HTML, le CSS et le JavaScript que vous maîtrisez déjà. Ce qui la rend installable et utilisable hors ligne tient à quelques fichiers supplémentaires et à des règles de diffusion précises. La démarche se résume en cinq étapes.
- Servir le site en HTTPS. Les service workers ne fonctionnent que sur une origine sécurisée. En développement, les navigateurs considèrent
localhostcomme sécurisé, ce qui permet de tester sans certificat. - Rédiger le manifest. Ce fichier JSON décrit le nom, les icônes, l'adresse de démarrage et le mode d'affichage de l'application installée.
- Écrire et enregistrer le service worker. Ce script met en cache les ressources et répond aux requêtes lorsque le réseau fait défaut.
- Vérifier les critères d'installabilité. Chaque navigateur applique ses propres conditions avant de proposer l'installation.
- Tester puis déployer. Les outils de développement des navigateurs permettent de contrôler le manifest, le cache et le comportement hors ligne avant la mise en production.
Sur un site dont le front est déjà propre, les trois premières étapes vont vite. L'effort se concentre en réalité sur la stratégie de cache : décider quelles pages doivent rester disponibles hors ligne demande plus de réflexion que d'écrire le code.
Préparer l'environnement de développement
Le développement d'une PWA ne demande aucun outil propriétaire. Un éditeur de code et un serveur local suffisent, à condition de pouvoir servir les fichiers depuis localhost ou en HTTPS, car un fichier ouvert directement depuis le disque ne peut pas enregistrer de service worker.
Le serveur local peut être celui de votre pile habituelle : Apache ou Nginx pour un projet PHP, ou un serveur Node.js pour un projet JavaScript. Prévoyez aussi plusieurs navigateurs de test, car le comportement d'installation diffère d'un moteur à l'autre. Firefox et les navigateurs basés sur Chromium (Chrome, Edge) disposent d'un panneau Application qui affiche le manifest et les service workers. Un iPhone ou un iPad reste indispensable pour contrôler le rendu dans Safari, qui ne peut pas être simulé fidèlement sur un ordinateur.
Créer le manifest de votre PWA
Le manifest est un fichier JSON qui définit l'apparence de votre application lors de l'installation et de son lancement. L'extension recommandée par la spécification est .webmanifest, servie avec le type application/manifest+json ; une extension .json reste acceptée par les navigateurs. Voici un manifest complet pour 2026 :
{
"id": "/",
"name": "Exemple de PWA",
"short_name": "Exemple",
"description": "Application de démonstration",
"start_url": "/",
"scope": "/",
"display": "standalone",
"background_color": "#ffffff",
"theme_color": "#ffffff",
"icons": [
{ "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png" },
{ "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png" }
]
}
Le champ id donne une identité stable à l'application, indépendante de l'adresse de démarrage. Le champ scope délimite les URL qui s'ouvrent dans la fenêtre de l'application ; les autres s'ouvrent dans le navigateur. Les couleurs background_color et theme_color servent à l'écran de démarrage et à la barre de titre. Les captures d'écran (screenshots) et la description ne sont pas obligatoires, mais la documentation de Chrome les recommande fortement pour présenter l'application au moment de l'installation.
Placez ce fichier à la racine du projet et déclarez-le dans le <head> de chaque page :
<link rel="manifest" href="/manifest.webmanifest">
Implémenter le service worker de votre PWA
Le service worker est un script que le navigateur exécute en arrière-plan, séparément de la page. Il intercepte les requêtes réseau, ce qui lui permet de servir des ressources depuis un cache local. Il s'enregistre depuis le JavaScript principal de la page, idéalement après le chargement pour ne pas concurrencer l'affichage :
if ('serviceWorker' in navigator) {
window.addEventListener('load', () => {
navigator.serviceWorker.register('/sw.js', { scope: '/' })
.catch((erreur) => console.error('Enregistrement impossible :', erreur));
});
}
Placé à la racine, le fichier sw.js contrôle l'ensemble du site. Voici une version minimale mais complète, qui met en cache les ressources de base dès l'installation, supprime les anciens caches lors d'une mise à jour et affiche une page de secours lorsque le réseau est absent :
const CACHE = 'app-v2';
const RESSOURCES = ['/', '/css/style.css', '/js/app.js', '/hors-ligne.html'];
self.addEventListener('install', (event) => {
event.waitUntil(
caches.open(CACHE).then((cache) => cache.addAll(RESSOURCES))
);
});
self.addEventListener('activate', (event) => {
event.waitUntil(
caches.keys().then((cles) => Promise.all(
cles.filter((cle) => cle !== CACHE).map((cle) => caches.delete(cle))
))
);
});
self.addEventListener('fetch', (event) => {
if (event.request.method !== 'GET') return;
event.respondWith(
caches.match(event.request).then((reponse) =>
reponse || fetch(event.request).catch(() => caches.match('/hors-ligne.html'))
)
);
});
Ce que fait chaque événement
L'événement install se déclenche une seule fois, après un enregistrement réussi. La méthode event.waitUntil() empêche l'installation de se terminer tant que toutes les ressources n'ont pas été mises en cache. L'événement activate intervient lorsque la nouvelle version prend le contrôle : c'est le bon moment pour supprimer les caches portant un ancien nom, faute de quoi ils s'accumulent sur l'appareil de l'utilisateur. L'événement fetch, enfin, reçoit chaque requête et décide d'où vient la réponse.
Choisir une stratégie de cache
L'exemple applique la stratégie « cache d'abord » : la ressource est cherchée dans le cache, puis sur le réseau si elle n'y figure pas. Elle convient aux fichiers qui changent rarement, comme les feuilles de style, les scripts versionnés ou les icônes. Pour des contenus qui évoluent souvent, comme un tableau de bord ou une liste de commandes, la stratégie « réseau d'abord » est préférable : la requête part vers le serveur et le cache ne sert qu'en cas d'échec. Changer le nom du cache (app-v2, puis app-v3) à chaque livraison garantit que les utilisateurs reçoivent les nouveaux fichiers.
Les critères d'installabilité d'une PWA en 2026
Un manifest et un service worker ne suffisent pas toujours à faire apparaître la proposition d'installation. Chaque navigateur applique ses propres règles, et celles-ci ont sensiblement évolué ces dernières années, en particulier chez Apple.
Dans Chrome, la fenêtre d'installation n'est proposée que si le site est servi en HTTPS et si le manifest contient un name ou un short_name, des icônes de 192 et 512 pixels, une start_url et un mode display parmi fullscreen, standalone, minimal-ui ou window-controls-overlay. Le champ prefer_related_applications doit être absent ou à false. Chrome attend aussi un minimum d'engagement : au moins un clic ou un appui sur la page et 30 secondes de consultation. La liste à jour figure dans la documentation des critères d'installation. Le service worker n'y figure pas, mais il reste indispensable pour le fonctionnement hors ligne.
Côté Apple, le paysage a changé. Depuis iOS et iPadOS 16.4, une web app ajoutée à l'écran d'accueil peut recevoir des notifications push, à condition que son manifest déclare un affichage standalone ou fullscreen et que l'autorisation soit demandée après une action de l'utilisateur. Depuis Safari 17 sur macOS Sonoma, n'importe quel site peut être ajouté au Dock. Avec iOS 26, tout site ajouté à l'écran d'accueil s'ouvre par défaut comme une web app, même sans manifest. Le manifest reste néanmoins utile pour maîtriser le nom, les icônes et le mode d'affichage.
Tester votre PWA
Pendant longtemps, l'audit Lighthouse comportait une catégorie dédiée aux PWA. Elle a été supprimée avec la version 12 de l'outil, et les contrôles se font désormais dans le panneau Application des outils de développement. Firefox comme Chrome et Edge y affichent le manifest interprété, les éventuelles erreurs de champ, l'état du service worker et le contenu des caches.
Trois vérifications s'imposent avant chaque livraison. Il faut d'abord contrôler que le manifest est lu sans avertissement et que les icônes s'affichent. On passe ensuite le navigateur en mode hors ligne afin de recharger les pages prévues pour fonctionner sans réseau. On publie enfin une nouvelle version du service worker pour vérifier que l'ancien cache disparaît bien après activation.
Lighthouse reste utile pour la performance, l'accessibilité et le SEO de la PWA. Une application installable mais lente perd une grande part de son intérêt : mesurez donc aussi les indicateurs Core Web Vitals (LCP, INP, CLS) sur les pages principales, en particulier sur mobile.
Déployer votre PWA en production
Une fois la PWA testée, le déploiement suit les règles d'un site classique, avec deux points de vigilance. Le premier est le HTTPS, sans lequel le service worker ne s'enregistre pas. Le second est la configuration du serveur : le manifest doit être servi avec le bon type MIME, et le fichier sw.js ne doit pas rester bloqué dans un cache intermédiaire, sans quoi les mises à jour n'atteignent pas les utilisateurs.
Le choix de l'hébergement pèse aussi sur l'expérience. Un serveur proche de vos utilisateurs et correctement dimensionné réduit le temps de première réponse, qui conditionne la vitesse de la toute première visite, avant que le cache ne prenne le relais. Pour un service utilisé chaque jour par des équipes, un suivi des erreurs JavaScript en production permet de repérer rapidement un service worker défaillant.
Installer une PWA sur un appareil
L'installation d'une PWA ne passe pas par les stores d'applications. Elle se fait depuis le navigateur, selon une procédure qui varie d'un système à l'autre. Une PWA peut aussi être publiée dans le Microsoft Store, ce qui permet aux utilisateurs de Windows de l'installer comme n'importe quel logiciel.
Sur un appareil mobile
Sur Android, Chrome affiche une proposition d'installation lorsque les critères sont remplis ; l'utilisateur peut aussi passer par le menu du navigateur. Sur iPhone et iPad, il faut ouvrir le site dans Safari, toucher l'icône de partage (le carré avec une flèche vers le haut), puis choisir « Sur l'écran d'accueil » et confirmer.
Sur un ordinateur
Dans Chrome et Edge, une icône d'installation apparaît dans la barre d'adresse lorsque la PWA est installable ; un clic suffit pour l'ajouter. Sur Mac, Safari permet d'ajouter n'importe quel site au Dock par le menu Fichier, puis « Ajouter au Dock ». L'application s'ouvre alors dans sa propre fenêtre, comme un logiciel.
Faire développer votre PWA par une équipe dédiée
Créer une PWA de démonstration prend quelques heures. Concevoir une application fiable pour vos clients ou vos équipes demande davantage : une stratégie de cache adaptée à vos données, une gestion propre des mises à jour, des tests sur les appareils réellement utilisés et un code maintenable sur plusieurs années.
Codyweb conçoit des applications web et PWA sur mesure, développées sans surcouche inutile pour rester légères et rapides. Si votre projet suppose aussi des échanges avec vos outils internes, notre approche du développement web sur mesure garantit que vous restez propriétaire du code et libre de le faire évoluer.
- vote(s)