first commit

public_web/docs/README.md

@@ -0,0 +1,25 @@
+# Public Web Frontend Documentation
+
+This folder contains documentation specific to the public web frontend service.
+
+## Documents
+
+- **[TEMPLATES.md](TEMPLATES.md)** - Template structure, naming conventions, and Jinja2 best practices
+- **[HTMX_PATTERNS.md](HTMX_PATTERNS.md)** - HTMX integration patterns and dynamic UI updates
+- **[TESTING.md](TESTING.md)** - Manual testing checklist and browser testing guide
+- **[MULTIPLAYER.md](MULTIPLAYER.md)** - Multiplayer lobby and session UI implementation
+
+## Quick Reference
+
+**Service Role:** Thin UI layer that makes HTTP requests to API backend
+
+**Tech Stack:** Flask + Jinja2 + HTMX + Vanilla CSS
+
+**Port:** 5001 (development), 8080 (production)
+
+## Related Documentation
+
+- **[../CLAUDE.md](../CLAUDE.md)** - Web frontend development guidelines
+- **[../README.md](../README.md)** - Setup and usage guide
+- **[../../docs/ARCHITECTURE.md](../../docs/ARCHITECTURE.md)** - System architecture overview
+- **[../../api/docs/API_REFERENCE.md](../../api/docs/API_REFERENCE.md)** - API endpoints to call