cyrilsebek.cz rewrite

Stack: FastAPI + Jinja2 + HTMX + Tailwind/daisyUI. Content = flat markdown files w/ frontmatter, no DB.

Dev setup

NixOS

nix-shell

Drops into shell w/ python312, node, venv auto-created + deps installed.

Fedora / other

bash setup-venv.sh
source .venv/bin/activate

Both, after venv active

npm install
npx tailwindcss -i app/static/css/input.css -o app/static/css/output.css --watch
uvicorn app.main:app --reload

Fonts: download JetBrains Mono + Inter (variable) woff2 files into app/static/fonts/ - not committed here, grab from:

• https://github.com/JetBrains/JetBrainsMono/releases
• https://github.com/rsms/inter/releases

Content

Add .md files under content/<category>/. Frontmatter schema:

---
title: "..."
date: 2026-01-15
tags: [python, homelab]
lang: en
status: active
seo_description: "..."
og_image: /static/img/....png
---

Restart process to pick up new/changed content (index built at import time).

Branch flow

• python branch: active rewrite work
• merge to main: triggers .forgejo/workflows/deploy.yml -> builds docker image, pushes to registry, deploys over SSH via docker-compose on target host

Set these repo secrets in Forgejo before first merge: REGISTRY_URL, REGISTRY_USER, REGISTRY_PASSWORD, DEPLOY_HOST, DEPLOY_USER, DEPLOY_SSH_KEY

Also check runs-on: docker in the workflow matches your actual Forgejo runner label.