Skip to content

feat: Phase 5 - Offline/PWA and deployment#6

Merged
bakodramane merged 1 commit into
mainfrom
phase/5-pwa-deploy
Jun 4, 2026
Merged

feat: Phase 5 - Offline/PWA and deployment#6
bakodramane merged 1 commit into
mainfrom
phase/5-pwa-deploy

Conversation

@bakodramane

Copy link
Copy Markdown
Owner

Summary

  • Install vite-plugin-pwa v1.3.0 and configure Workbox generateSW mode
  • Cache strategy: CacheFirst for all static assets (JS, CSS, SVG, images); NavigationRoute with createHandlerBoundToURL for HTML shell (offline fallback to cached index.html)
  • Manifest configured in plugin: name, short_name, icons x2, start_url, display: standalone, scoped to /SAE_Syntax_Generator/
  • Create public/icons/icon-192x192.svg and icon-512x512.svg (bar-chart placeholder icons)
  • Register service worker explicitly in src/main.tsx via virtual:pwa-register
  • Add /// <reference types="vite-plugin-pwa/client" /> to src/vite-env.d.ts
  • Add PWA meta tags to index.html (theme-color, apple-mobile-web-app-*)
  • Add live GitHub Pages URL to README.md
  • Deploy workflow unchanged; base was set in Phase 0

Test plan

  • npm run build PASS — dist/sw.js and dist/manifest.webmanifest generated
  • npm test — 430 unit tests passed, 0 failed
  • npm run test:e2e — 1 E2E test passed
  • npm run lint — 0 warnings
  • Lighthouse PWA score >= 90 — run after Pages deployment

Generated with Claude Code

…aching

- Install vite-plugin-pwa v1.3.0
- Add VitePWA plugin to vite.config.ts with generateSW mode:
    CacheFirst for JS/CSS/SVG/PNG/ICO/webmanifest assets via runtimeCaching
    NavigationRoute + createHandlerBoundToURL for HTML shell (NetworkFirst fallback)
    navigateFallbackDenylist: [/^\/api\//]
- Manifest configured inline: name, short_name, icons, start_url, display: standalone,
  scope and start_url both scoped to /SAE_Syntax_Generator/
- Create public/icons/icon-192x192.svg and icon-512x512.svg (bar-chart placeholder icons)
- Register service worker explicitly in src/main.tsx via virtual:pwa-register
- Add vite-plugin-pwa/client types reference to src/vite-env.d.ts
- Add PWA meta tags to index.html (theme-color, apple-mobile-web-app-*)
- Add live GitHub Pages URL to README.md
- Build: PASS; Unit tests: 430 passed; E2E: 1 passed; Lint: PASS

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@bakodramane bakodramane merged commit ecab577 into main Jun 4, 2026
2 checks passed
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.

1 participant