Une PWA (Progressive Web App, ou application web progressive) est un site web qui s'installe sur le téléphone comme une application : une icône sur l'écran d'accueil, un affichage plein écran, et surtout un fonctionnement même sans connexion. Pas de magasin d'applications, pas de téléchargement lourd. Dans ce tutoriel, vous transformez un site simple en PWA installable, avec une page hors ligne.

Niveau : débutant à intermédiaire (bases de HTML et JavaScript). Durée : environ 45 minutes. Prérequis : un site servi en HTTPS (obligatoire pour une PWA, sauf en test sur localhost) et un navigateur Chrome ou Edge pour tester. Le code de ce tutoriel a été testé : Chrome ne signale aucune erreur d'installation, et le site s'affiche correctement hors connexion.

Pourquoi une PWA ?

  • Connexion faible ou coupée : les pages déjà visitées s'ouvrent instantanément, même sans réseau.
  • Peu d'espace sur le téléphone : une PWA pèse quelques centaines de kilo-octets, loin des dizaines de méga-octets d'une application classique.
  • Une seule version à maintenir pour le web, Android et ordinateur.
  • Pas de validation de magasin : une mise à jour du site est immédiatement disponible.

Une PWA n'a pas accès à toutes les fonctions du téléphone comme une application native. Pour comparer les deux approches, voir application native, Flutter ou PWA.

Les fichiers du projet

mon-site/
├── index.html
├── hors-ligne.html        ← page affichée sans connexion
├── style.css
├── app.js                 ← enregistre le service worker, bouton d'installation
├── sw.js                  ← le service worker (à la racine du site)
├── manifest.webmanifest   ← l'identité de l'application
└── icons/
    ├── icon-192.png
    ├── icon-512.png
    └── icon-maskable-512.png

Étape 1 : le manifeste

Le fichier manifest.webmanifest décrit votre application : son nom, ses icônes, ses couleurs, sa page de démarrage.

{
  "name": "Ma Boutique",
  "short_name": "Boutique",
  "description": "Commandez nos produits, même avec une connexion faible.",
  "start_url": "/",
  "scope": "/",
  "display": "standalone",
  "background_color": "#ffffff",
  "theme_color": "#0a4fa3",
  "lang": "fr",
  "icons": [
    { "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png" },
    { "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png" },
    { "src": "/icons/icon-maskable-512.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" }
  ]
}
  • short_name : le nom affiché sous l'icône. Restez court, une douzaine de caractères.
  • display: standalone : l'application s'ouvre sans la barre d'adresse du navigateur.
  • Icônes : au minimum 192 et 512 pixels. L'icône « maskable » garde le logo au centre avec une marge, car Android la découpe en cercle ou en carré arrondi.

Étape 2 : relier le manifeste à la page

Dans le <head> de vos pages :

<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="theme-color" content="#0a4fa3">
<link rel="manifest" href="/manifest.webmanifest">
<link rel="icon" href="/icons/icon-192.png">
<link rel="apple-touch-icon" href="/icons/icon-192.png">

Ajoutez dans le <body> un bouton d'installation, caché par défaut, et le script :

<button id="installer" hidden>Installer l'application</button>
<script src="/app.js"></script>

Vérifiez que votre serveur envoie le manifeste avec le type application/manifest+json. La plupart des serveurs le font ; sinon, ajoutez ce type dans leur configuration.

Étape 3 : le service worker

Le service worker est un petit script qui s'intercale entre la page et le réseau. C'est lui qui garde les fichiers en mémoire et sert le site hors connexion. Créez sw.js à la racine du site (il ne contrôle que les pages de son dossier et des sous-dossiers) :

// Service worker : met en cache l'essentiel du site pour qu'il s'ouvre même hors connexion.
const VERSION = 'boutique-v1';
const FICHIERS = ['/', '/index.html', '/style.css', '/app.js', '/hors-ligne.html', '/icons/icon-192.png'];

// 1. Installation : on télécharge les fichiers essentiels une fois pour toutes.
self.addEventListener('install', (event) => {
  event.waitUntil(caches.open(VERSION).then((cache) => cache.addAll(FICHIERS)));
  self.skipWaiting();
});

// 2. Activation : on supprime les caches des anciennes versions.
self.addEventListener('activate', (event) => {
  event.waitUntil(
    caches.keys().then((noms) => Promise.all(noms.filter((n) => n !== VERSION).map((n) => caches.delete(n))))
  );
  self.clients.claim();
});

// 3. Requêtes : pages = réseau d'abord (contenu à jour), sinon cache, sinon page hors ligne ;
//    fichiers (CSS, JS, images) = cache d'abord (rapide), sinon réseau.
self.addEventListener('fetch', (event) => {
  const req = event.request;
  if (req.method !== 'GET' || new URL(req.url).origin !== location.origin) return;

  if (req.mode === 'navigate') {
    event.respondWith(
      fetch(req)
        .then((rep) => {
          const copie = rep.clone();
          caches.open(VERSION).then((cache) => cache.put(req, copie));
          return rep;
        })
        .catch(() => caches.match(req).then((rep) => rep || caches.match('/hors-ligne.html')))
    );
    return;
  }

  event.respondWith(caches.match(req).then((rep) => rep || fetch(req)));
});

Les deux stratégies utilisées :

  • Pages : réseau d'abord. Avec une connexion, le visiteur voit toujours la dernière version, qui est aussi enregistrée. Sans connexion, il voit la dernière version enregistrée, ou la page hors ligne s'il n'a jamais visité cette page.
  • Fichiers : cache d'abord. CSS, JavaScript et images s'affichent instantanément depuis le téléphone.

Le code ignore volontairement les requêtes autres que GET (envoi de formulaire, paiement) et celles vers d'autres sites : elles doivent toujours passer par le réseau.

Étape 4 : enregistrer le service worker et proposer l'installation

Créez app.js :

// Enregistrement du service worker
if ('serviceWorker' in navigator) {
  window.addEventListener('load', () => {
    navigator.serviceWorker.register('/sw.js')
      .catch((err) => console.error('Service worker non enregistré :', err));
  });
}

// Bouton « Installer l'application » (Chrome, Edge et navigateurs Android compatibles)
let demandeInstallation = null;
const bouton = document.getElementById('installer');

window.addEventListener('beforeinstallprompt', (event) => {
  event.preventDefault();
  demandeInstallation = event;
  bouton.hidden = false;
});

bouton.addEventListener('click', async () => {
  if (!demandeInstallation) return;
  demandeInstallation.prompt();
  await demandeInstallation.userChoice;
  demandeInstallation = null;
  bouton.hidden = true;
});

window.addEventListener('appinstalled', () => {
  bouton.hidden = true;
});

Le bouton n'apparaît que lorsque le navigateur juge la PWA installable. Sur iPhone, Safari ne déclenche pas cet événement : l'utilisateur installe la PWA par le bouton Partager, puis « Sur l'écran d'accueil ». Pensez à l'expliquer dans une petite bulle d'aide pour vos visiteurs sur iPhone.

Étape 5 : la page hors ligne

Créez hors-ligne.html, une page simple et rassurante qui utilise la même feuille de style :

<main>
  <h1>Vous êtes hors connexion</h1>
  <p>Cette page n'a pas encore été enregistrée sur votre téléphone. Vérifiez votre connexion et réessayez.</p>
  <a href="/">Retour à l'accueil</a>
</main>

Étape 6 : tester

  1. Ouvrez le site dans Chrome, puis les outils de développement (touche F12), onglet Application.
  2. Rubrique Manifest : le nom, les icônes et les couleurs doivent s'afficher sans avertissement.
  3. Rubrique Service workers : le statut doit être « activated and is running ».
  4. Cochez Offline dans cette même rubrique, puis rechargez : la page d'accueil s'affiche toujours. Ouvrez une adresse jamais visitée : la page hors ligne apparaît.
  5. Sur un téléphone Android, ouvrez le site dans Chrome : le bouton « Installer l'application » ou une proposition d'installation apparaît.

Mettre à jour la PWA

Quand vous modifiez le CSS, le JavaScript ou la liste des fichiers, changez la valeur de VERSION dans sw.js (par exemple boutique-v2). Le navigateur détecte un nouveau service worker, télécharge les nouveaux fichiers et supprime l'ancien cache. Sans ce changement, vos visiteurs pourraient garder l'ancienne feuille de style.

Les erreurs fréquentes

  • Le service worker ne s'enregistre pas : le site n'est pas en HTTPS, ou sw.js n'est pas à la racine. Pour activer HTTPS sur votre serveur, voir notre tutoriel VPS avec Nginx et HTTPS.
  • Le bouton d'installation n'apparaît jamais : manifeste invalide, icônes manquantes ou mauvais type de fichier. L'onglet Application de Chrome indique la cause exacte.
  • Le site affiche une ancienne version : la VERSION n'a pas été changée après une modification.
  • Les données dynamiques (paniers, comptes) en cache : ne mettez jamais en cache les réponses personnelles ou les pages de paiement.

Questions fréquentes

Une PWA peut-elle être publiée sur Google Play ?

Oui, une PWA peut être emballée pour Google Play (avec l'outil Bubblewrap, par exemple), à condition de respecter les règles du magasin. Sur l'App Store, c'est beaucoup plus restrictif.

Une PWA peut-elle envoyer des notifications ?

Oui sur Android et sur ordinateur. Sur iPhone, les notifications web sont possibles pour une PWA ajoutée à l'écran d'accueil, avec une version récente d'iOS.

Les données de l'utilisateur sont-elles stockées sur le téléphone ?

Seulement ce que vous mettez en cache. Gardez-y les fichiers publics du site, jamais d'informations personnelles ou de paiement.

Faut-il refaire tout son site ?

Non. Un site existant devient une PWA en ajoutant un manifeste, un service worker et quelques lignes dans le <head>. C'est l'une des améliorations les plus rentables pour les visiteurs avec une connexion faible.

Être accompagné

NEWTIV transforme vos sites en PWA rapides et installables, ou développe des applications mobiles quand vous avez besoin des fonctions natives du téléphone. Pour estimer un budget, voir combien coûte une application mobile en Côte d'Ivoire. Demandez un devis, nous vous répondons sous 48 heures ouvrées.