Robot U community site frontend and backend

Find a file

kacper d84a885fdb Use encrypted cookie sessions		2026-04-12 22:02:47 -04:00
.githooks	Initial Robot U site prototype	2026-04-08 06:03:48 -04:00
blogs/building-robot-u-site	Render blog posts from Forgejo	2026-04-12 20:23:05 -04:00
docs	Initial Robot U site prototype	2026-04-08 06:03:48 -04:00
frontend	Remove redundant home return buttons	2026-04-12 21:19:09 -04:00
scripts	Build Forgejo-backed community prototype	2026-04-12 20:15:33 -04:00
tests	Use encrypted cookie sessions	2026-04-12 22:02:47 -04:00
.env.example	Use encrypted cookie sessions	2026-04-12 22:02:47 -04:00
.gitignore	Add app start script	2026-04-08 06:14:06 -04:00
.ruff.toml	Initial Robot U site prototype	2026-04-08 06:03:48 -04:00
AGENTS.md	Use encrypted cookie sessions	2026-04-12 22:02:47 -04:00
app.py	Use encrypted cookie sessions	2026-04-12 22:02:47 -04:00
auth.py	Use encrypted cookie sessions	2026-04-12 22:02:47 -04:00
calendar_feeds.py	Build Forgejo-backed community prototype	2026-04-12 20:15:33 -04:00
forgejo_client.py	Build Forgejo-backed community prototype	2026-04-12 20:15:33 -04:00
live_prototype.py	Use encrypted cookie sessions	2026-04-12 22:02:47 -04:00
README.md	Use encrypted cookie sessions	2026-04-12 22:02:47 -04:00
requirements.txt	Use encrypted cookie sessions	2026-04-12 22:02:47 -04:00
settings.py	Use encrypted cookie sessions	2026-04-12 22:02:47 -04:00

README.md

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

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python -m uvicorn app:app --reload

Start App

Build the frontend and then serve the app from FastAPI:

./scripts/start.sh

The script automatically loads .env and .env.local if present.

Optional runtime overrides:

HOST=0.0.0.0 PORT=8800 ./scripts/start.sh

Optional live Forgejo configuration:

export APP_BASE_URL="http://kacper-dev-pod:8800"
export AUTH_SECRET_KEY="$(openssl rand -hex 32)"
export FORGEJO_BASE_URL="https://aksal.cloud"
export FORGEJO_OAUTH_CLIENT_ID="your-forgejo-oauth-client-id"
export FORGEJO_OAUTH_CLIENT_SECRET="your-forgejo-oauth-client-secret"
export FORGEJO_OAUTH_SCOPES="openid profile"
export CALENDAR_FEED_URLS="webcal://example.com/calendar.ics,https://example.com/other.ics"

APP_BASE_URL must match the URL you use in the browser. Create the OAuth app in Forgejo with this redirect URI:

http://kacper-dev-pod:8800/api/auth/forgejo/callback

AUTH_SECRET_KEY is required for Forgejo OAuth sign-in. It encrypts the HttpOnly browser session cookie that carries the signed-in user's Forgejo token and identity. Set AUTH_COOKIE_SECURE=true when serving over HTTPS.

FORGEJO_TOKEN is optional. When set, it is a read fallback for local development. Browser OAuth requests only identity scopes, then the backend uses the signed-in user's Forgejo identity from the encrypted session cookie for public repo reads and public issue replies. The backend must verify repositories are public before reading discussion data or writing comments.

Or put those values in .env:

cp .env.example .env

Use the site Sign in button for Forgejo OAuth, or query the API directly with:

curl -H "Authorization: token your-forgejo-api-token" http://127.0.0.1:8800/api/prototype

Frontend

cd frontend
~/.bun/bin/bun install
~/.bun/bin/bun run dev

Quality Checks

./scripts/check_python_quality.sh
./scripts/check_frontend_quality.sh