Robot-U/robot-u-site
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Robot U community site frontend and backend
5 commits 1 branch 0 tags 323 KiB
Find a file
kacper 0a9b052beb Render blog posts from Forgejo
2026-04-12 20:23:05 -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 Render blog posts from Forgejo 2026-04-12 20:23:05 -04:00
scripts Build Forgejo-backed community prototype 2026-04-12 20:15:33 -04:00
tests Render blog posts from Forgejo 2026-04-12 20:23:05 -04:00
.env.example Build Forgejo-backed community prototype 2026-04-12 20:15:33 -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 Build Forgejo-backed community prototype 2026-04-12 20:15:33 -04:00
app.py Build Forgejo-backed community prototype 2026-04-12 20:15:33 -04:00
auth.py Build Forgejo-backed community prototype 2026-04-12 20:15:33 -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 Render blog posts from Forgejo 2026-04-12 20:23:05 -04:00
README.md Build Forgejo-backed community prototype 2026-04-12 20:15:33 -04:00
requirements.txt Initial Robot U site prototype 2026-04-08 06:03:48 -04:00
settings.py Build Forgejo-backed community prototype 2026-04-12 20:15:33 -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 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

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 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

Sign in through /signin using 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