Initial Robot U site prototype

README.md

@@ -0,0 +1,43 @@
+# Robot U Site Prototype
+
+Thin frontend layer over Forgejo for community learning content, discussions, and events.
+
+## Stack
+
+- FastAPI backend
+- Preact + TypeScript frontend built with Vite
+- `bun` for frontend tooling
+- `uv` + `ruff` for Python checks
+
+## Local Development
+
+### Backend
+
+```bash
+python3 -m venv .venv
+.venv/bin/pip install -r requirements.txt
+.venv/bin/python -m uvicorn app:app --reload
+```
+
+Optional live Forgejo configuration:
+
+```bash
+export FORGEJO_BASE_URL="https://aksal.cloud"
+export FORGEJO_TOKEN="your-forgejo-api-token"
+export CALENDAR_FEED_URLS="webcal://example.com/calendar.ics,https://example.com/other.ics"
+```
+
+### Frontend
+
+```bash
+cd frontend
+~/.bun/bin/bun install
+~/.bun/bin/bun run dev
+```
+
+### Quality Checks
+
+```bash
+./scripts/check_python_quality.sh
+./scripts/check_frontend_quality.sh
+```