mqqt_washingMachine/.ai/PLAN.md

Plan

Status: ready_for_implement

Goal: implement ROADMAP.md Priority 4 — make the page addable to an Android home screen as "Home Lanundry" with a cartoon washing-machine icon. T-001..T-005 are done and unchanged in behavior.

Scope

• New static assets (manifest and icons), embedded routes, three <head> tags, tests, README.
• Out of scope: service worker, offline mode, TLS, install prompt UI, any change to status rule, JSON contract, SSE, page layout or the <title>.
• Transport stays plain HTTP, so Chrome offers "Add to Home screen" (shortcut), not "Install app". This is accepted; document it.

T-006 — Home screen icon and web manifest

Design decisions

• Assets live in internal/web/static/ and are embedded with go:embed (an embed.FS over a fixed file list, or individual []byte vars). No new dependencies.
• Routes (all GET, exact paths, registered on the existing mux):
  • /manifest.webmanifest — Content-Type: application/manifest+json
  • /icons/icon.svg — image/svg+xml
  • /icons/icon-192.png, /icons/icon-512.png, /icons/icon-maskable-512.png — image/png
  • /apple-touch-icon.png (180x180) — image/png
• Static assets use Cache-Control: no-cache (revalidate); the existing no-store on page/API stays.
• Manifest content: name and short_name "Home Lanundry", start_url /, scope /, display standalone, theme_color and background_color #ffffff, icons = 192 and 512 (purpose: any) plus maskable 512 (purpose: maskable).
• Icon art: flat cartoon front-loading washing machine — light-blue rounded-square background, white/pastel body, round porthole with blue water and a few bubbles, two or three control knobs and a small display on top. For the maskable variant, extend the background full-bleed and keep all artwork inside the central 80% safe zone.

Files to change (tests first)

1. internal/web/handler_test.go (write first, confirm failing):
   • Table test for each new route: 200, expected Content-Type, non-empty body; PNG routes start with the PNG signature; POST returns 405.
   • Manifest test: decode JSON; assert name/short_name == "Home Lanundry", display == "standalone", start_url == "/", and that every icons[].src resolves to a route that returns 200 and has the declared sizes (decode PNG config) and type; one icon has purpose "maskable".
   • Extend TestPageAndRouting expected substrings with rel="manifest", name="theme-color", rel="apple-touch-icon".
2. internal/web/static/icon.svg (new): source art, 512x512 viewBox.
3. internal/web/static/icon-192.png, icon-512.png, icon-maskable-512.png, apple-touch-icon.png (new): rendered from the SVG (full-bleed variant for maskable). Suggested tools: headless google-chrome --screenshot or Pillow; keep the generation script out of the repo, or add it as internal/web/static/README-free scripts/ only if small — implementer's choice, but the committed SVG must be the source of truth and PNGs must visually match it. Visually check the result (view the PNGs, including a circle-crop check of the maskable one).
4. internal/web/static/manifest.webmanifest (new): content as above.
5. internal/web/handler.go: embed the new assets, register the routes with correct content types and cache header, update the package/handler doc comment to mention the manifest and icons.
6. internal/web/static/index.html: add to <head>: <link rel="manifest" href="/manifest.webmanifest">, <meta name="theme-color" content="#ffffff">, <link rel="apple-touch-icon" href="/apple-touch-icon.png">, <link rel="icon" href="/icons/icon.svg" type="image/svg+xml">. Do not change title, layout or script.
7. Dockerfile: no change expected (it already copies internal); verify the build still embeds the new files (.dockerignore must not exclude *.png/*.svg/*.webmanifest — check and fix if it does).
8. README.md: new "Add to Android home screen" subsection (before "Limitations"): open the page in Chrome on Android, menu → "Add to Home screen"/"Install app" if offered, name "Home Lanundry". State the plain-HTTP limitation: without HTTPS Chrome only offers a home-screen shortcut with the icon, not a full install, and there is no offline mode. Add the new routes (/manifest.webmanifest, /icons/*, /apple-touch-icon.png) to the endpoint documentation. Do not touch the AI Workflow section.
9. ROADMAP.md: already updated by the planner; no further edit.

Validation

• go fmt ./..., go vet ./..., go test ./... (plus -race on ./internal/web).
• Smoke: run the service, curl -sI each new route for status and content type; open the page in Chrome DevTools (Application → Manifest) at a 360px viewport and confirm no manifest or icon errors and a correct icon preview.
• Docker build if available (confirm assets are embedded).

Commit message

feat(web): add Home Lanundry home-screen icon and web manifest