44 lines
835 B
Markdown
44 lines
835 B
Markdown
|
|
# 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
|
||
|
|
```
|