feat: add PWA manifest, service worker, and app icons #62

Closed
opened 2026-03-26 19:24:39 +00:00 by AI-Manager · 1 comment
Owner

Roadmap Reference

Phase 2, Section 2.4 — PWA Setup

What to do

Create the following files in static/:

manifest.json:

  • name: Gitea Mobile
  • short_name: Gitea
  • display: standalone
  • start_url: /
  • theme_color: matching CSS custom property
  • icons array: icon-192.png and icon-512.png

sw.js (service worker):

  • Cache the app shell on install: layout HTML, app.css, htmx.min.js, icons, manifest.json
  • Serve from cache on fetch for cached resources
  • Network-first strategy for API calls (all /issues, /pulls, / routes)
  • Register the service worker from a script tag in base.html

Icon files:

  • icon-192.png and icon-512.png — simple Gitea-themed app icons (can be placeholder SVG-derived PNGs)

Apple PWA meta tags in base.html:

  • apple-mobile-web-app-capable: yes
  • apple-mobile-web-app-status-bar-style: black-translucent
  • apple-touch-icon pointing to icon-192.png

Acceptance Criteria

  • Lighthouse PWA audit scores Installable
  • App can be added to iPhone home screen and opens in standalone mode
  • Manifest is valid (validate with web.dev or browser devtools)
  • Service worker registers successfully (visible in browser devtools Application tab)
## Roadmap Reference Phase 2, Section 2.4 — PWA Setup ## What to do Create the following files in static/: manifest.json: - name: Gitea Mobile - short_name: Gitea - display: standalone - start_url: / - theme_color: matching CSS custom property - icons array: icon-192.png and icon-512.png sw.js (service worker): - Cache the app shell on install: layout HTML, app.css, htmx.min.js, icons, manifest.json - Serve from cache on fetch for cached resources - Network-first strategy for API calls (all /issues, /pulls, / routes) - Register the service worker from a script tag in base.html Icon files: - icon-192.png and icon-512.png — simple Gitea-themed app icons (can be placeholder SVG-derived PNGs) Apple PWA meta tags in base.html: - apple-mobile-web-app-capable: yes - apple-mobile-web-app-status-bar-style: black-translucent - apple-touch-icon pointing to icon-192.png ## Acceptance Criteria - Lighthouse PWA audit scores Installable - App can be added to iPhone home screen and opens in standalone mode - Manifest is valid (validate with web.dev or browser devtools) - Service worker registers successfully (visible in browser devtools Application tab)
AI-Manager added the P2agent-readysmall labels 2026-03-26 19:24:39 +00:00
Author
Owner

Closing as implemented. Static assets on master:

  • static/manifest.json -- PWA manifest with name, icons, standalone display, dark theme
  • static/sw.js -- service worker for offline caching
  • static/icon-192.png and static/icon-512.png -- app icons
  • Layout template references manifest, apple-touch-icon, and registers service worker
Closing as implemented. Static assets on master: - `static/manifest.json` -- PWA manifest with name, icons, standalone display, dark theme - `static/sw.js` -- service worker for offline caching - `static/icon-192.png` and `static/icon-512.png` -- app icons - Layout template references manifest, apple-touch-icon, and registers service worker
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: leeworks-agents/gitea-mobile#62