furtka/website/README.md

# website/ — furtka.org

Hugo source for [furtka.org](https://furtka.org). Intentionally minimal while
the project is pre-alpha: a single idea page in English and German, nothing more.
More pages will come back when there's something real to show.

## Local build

```sh
cd website
hugo server        # http://localhost:1313
```

Requires Hugo **extended** ≥ 0.140.

## Deploy

Hosted on `forge-runner-01` (Proxmox VM, Ubuntu 24.04). Hugo runs on the VM;
nginx serves the built output from `/var/www/furtka.org`. TLS is terminated by
an upstream openresty reverse proxy — the VM itself only speaks plain HTTP.

### Auto-deploy on push-to-main (default)

`.forgejo/workflows/deploy-site.yml` fires on every push to `main` that touches
`website/**`. The self-hosted runner *is* forge-runner-01, so the whole deploy
collapses to a local rsync into `/srv/furtka-site/` + `hugo --minify` into
`/var/www/furtka.org/`. No SSH hop, no secrets. Runs in under a minute.

The in-CI script is `website/deploy-ci.sh`. Don't invoke it from your dev box —
it assumes it's already on the target host.

### Manual deploy (fallback)

For out-of-band pushes (feature branch, CI outage), deploy from your dev
machine:

```sh
./website/deploy.sh
```

This rsyncs `website/` to `/srv/furtka-site/` on the VM over SSH and runs
`hugo --minify` into `/var/www/furtka.org`. Same end state as the CI path,
just with an SSH hop.

### First-time VM setup

Only needed once, when provisioning a fresh forge-runner VM:

```sh
ssh forge-runner
sudo /srv/furtka-site/ops/nginx/setup-vm.sh   # or copy the script over first
```

## Structure

```
hugo.toml            Hugo config (multilingual: en default, de)
content/             Markdown pages
  _index.md          Home (EN)
  _index.de.md       Home (DE)
layouts/             Custom inline theme — no external theme or framework
  _default/          baseof, single, list
  partials/          head, header, footer, gate SVG, lang switcher
  index.html         Home-only layout with editorial hero
assets/css/main.css  Stylesheet (fingerprinted + minified on build)
static/favicon.svg   Gate mark in crimson
deploy.sh            Manual rsync + remote Hugo build (over SSH, for off-CI pushes)
deploy-ci.sh         Local rsync + Hugo build — runs on forge-runner-01 from CI
```

## Design

Modern-minimal on paper-white light / near-black dark. System-UI sans
(no webfonts — zero external requests, matches the self-hosting ethos).
Deep crimson accent, `prefers-color-scheme` switch.

The gate SVG is the one brand mark — a small wicket-gate glyph repeated in the
header, footer, and favicon.