From 761153371893504a85f6d678624e403794d18051 Mon Sep 17 00:00:00 2001 From: Andrej Spielmann Date: Thu, 26 Mar 2026 15:15:03 +0100 Subject: [PATCH] docs: add PWA implementation guide and git workflow notes - Document PWA feature with testing instructions - Add Git workflow: push after every task completion - Document iPhone testing steps --- AGENTS.md | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 713e3f1..5c572c9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1181,6 +1181,49 @@ CORS_ALLOWED_ORIGINS=http://localhost:3000,http://127.0.0.1:3000 --- +## Git Workflow + +**IMPORTANT: Push after EVERY task completion** + +When implementing features, push to Gitea after completing each individual task: + +```bash +# After each task completion +git add -A +git commit -m "feat(scope): description" +git push origin feature/branch-name +``` + +**Why:** +- Prevents loss of work +- Enables testing on multiple devices (e.g., iPhone testing requires network-accessible code) +- Allows rollback if issues arise +- Keeps Gitea in sync with local progress + +--- + +## PWA Implementation (COMPLETED) + +**Branch:** `feature/pwa` + +### What was implemented: +1. **manifest.json** - PWA configuration with icons, theme colors, display mode +2. **App Icons** - 192x192, 512x512, Apple Touch (180x180), Maskable +3. **Meta Tags** - viewport-fit: cover, theme-color, apple-web-app-capable +4. **Mobile CSS** - Safe areas, touch targets (44x44px), standalone mode styles +5. **InstallPrompt Component** - "Add to Home Screen" banner for iOS/Android +6. **dev:host Script** - `npm run dev:host` for network testing +7. **Network Config** - `.env.local` with API URL on 192.168.168.101.111 + +### Testing PWA on iPhone: +1. Start backend: `python manage.py runserver 0.0.0.0:8000` +2. Start frontend: `npm run dev:host` (or `npm start` after build) +3. Open Safari → http://192.168.101.111:3000 +4. Tap "Teilen" → "Zum Home Screen hinzufügen" +5. App runs standalone without Safari UI + +--- + ## Security Notes - Rate limiting on auth endpoints (5/minute)