robot-u-site/README.md

44 lines
835 B
Markdown
Raw Normal View History

2026-04-08 06:03:48 -04:00
# 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
```