Show offline-ready and update notices, and install guidance on iOS

Ouverte
  • Quelque chose ne va pas ?
#48 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
3/5
Temps estimé
1-2 jours
Accessibilité débutants
72/100
Type d'issue
Fonctionnalité
Clarté
Clairement spécifiée
Activité
Active
Stack technique
typescript, vite
Domaine
frontend, mobile-dev

Piste de recherche

Start with shared/pwa.ts, src/hub/main.ts, and shared/toast.ts to trace service worker registration, the install control, and toast styling. Run npm run dev to inspect the hub, then use npm run typecheck and npm run build to verify the changes. Done when the hub announces offline readiness and updates, and iOS Safari users outside standalone mode receive the install hint.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

enhancement severity: medium

Summary

Offline play is a headline feature, but a player never learns when the arcade is safe to use offline or that an update arrived. The install button only appears in browsers that fire beforeinstallprompt, so Safari and Firefox users get no guidance.

Where

  • shared/pwa.ts:7-13 (registerSW({ immediate: true }) with no callbacks)
  • src/hub/main.ts:19-33 (install button)
  • shared/toast.ts:8

Proposal

  • Pass onOfflineReady and show the existing toast ("Ready to play offline"). The toast styles need to load on the hub.
  • On an update, show a "New version, reload" toast or a small hub badge.
  • On iOS Safari outside standalone mode, show a one-time "Share, then Add to Home Screen" hint next to the install control.

Acceptance criteria

  • First visit shows a notice once caching completes
  • A deployed update is announced on the next visit

Getting started

  • Relevant files: shared/pwa.ts, shared/toast.ts, src/hub/main.ts
  • Run locally: npm install, then npm run dev
  • Checks: npm run typecheck and npm run build (there is no test suite yet)
  • Related docs: README.md

Filed by repo-audit/full-audit at b001f5d. Severity: medium. Effort: M. audit-key: enhancement|shared/pwa.ts|registerOffline

Langage dominant
TypeScript
Étoiles
3
Forks
3
Aucune PR mergée en 30 j

Préparer son environnement

Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de TMHSDigital/GH-Arcade

Toutes les issues de TMHSDigital/GH-Arcade

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.