Skip to content

Add Progressive Web App (PWA) support#90

Open
rohanod wants to merge 3 commits into
CNCKitchen:mainfrom
rohanod:feat/pwa
Open

Add Progressive Web App (PWA) support#90
rohanod wants to merge 3 commits into
CNCKitchen:mainfrom
rohanod:feat/pwa

Conversation

@rohanod

@rohanod rohanod commented Jul 12, 2026

Copy link
Copy Markdown

Summary

Enables BumpMesh to be installed as a standalone app and load faster on repeat visits.

  • Web app manifest (manifest.webmanifest) — app name, icons, theme colors, standalone display
  • Service worker (sw.js) — precaches the app shell; textures and CDN assets cached at runtime
  • PWA icons — 192×192 and 512×512, generated from the existing logo
  • HTML updates — manifest link, theme-color, Apple mobile meta tags, service worker registration
  • PWA.md — short maintainer guide for shipping cache updates (bump CACHE_VERSION in sw.js)
  • README — note to read PWA.md before committing PWA-related changes

Files changed

File Change
manifest.webmanifest New — install metadata
sw.js New — offline caching
icons/icon-192.png New — mobile icon
icons/icon-512.png New — desktop icon
index.html PWA meta tags + SW registration
PWA.md New — update instructions for maintainers
README.md Link to PWA.md

How to install

On Chrome,

  1. Go to the site
  2. Click this icon next to the bookmark star button
image
  1. Press "Install"

On iOS

  1. Click the share button
  2. Scroll down in the menu (You might have to click "View More" and then scroll if you're in chrome)
  3. Click the "Add to Home Screen" Button
  4. Make sure "Open as Web App" is ticked
  5. Click "Add"

Notes

  • You might have to wait for a bit on the first load while it downloads and saves everything
  • You will have to click "continue" (to ignore https warning) because the local server normally doesn't have a trusted certificate. Once deployed to the public site, there shouldn't be a problem

rohanod added 2 commits July 12, 2026 10:25
Enable installability and offline caching for the BumpMesh app shell:
- Web app manifest with standalone display and theme colors
- Service worker with precached assets and runtime texture caching
- PWA icons generated from the existing logo
- Apple/mobile meta tags and service worker registration in index.html
Sync theme-color and apple-mobile-web-app-status-bar-style with the
app theme (data-theme / stlt-theme), not OS prefers-color-scheme.
Bump SW cache so clients pick up the change.

@EllaFoxo EllaFoxo left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM; useful for Chrome apps and on iOS for sure. A few nitpicks but not a lot.

Comment thread manifest.webmanifest Outdated
Comment thread sw.js Outdated
Comment thread index.html Outdated
Add trailing newlines to manifest and service worker, and use braced
if statements for theme-color / status-bar meta updates.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants