website

# Website

Personal website, built as a static site with [Eleventy](https://www.11ty.dev) and

[Elena](https://elenajs.com) web components.

## Project Structure

```text

├── assets/            static css/images/icons/pdfs, copied through as-is

├── src/

│   ├── _data/          global data (site config, local repo discovery)

│   ├── _helpers/        plain JS helpers used by _data files (git plumbing)

│   ├── _includes/       layouts and partials

│   ├── components/      Elena web components

│   ├── posts/           blog post markdown

│   ├── repos/           paginated templates for repo readme/files/commits/blame

│   └── *.njk            top-level pages

├── eleventy.config.js

└── package.json

```

## Repo browsing

Pages under `/repos/:id` are generated entirely from local git checkouts that live as

**sibling directories of this project** — e.g. `../config`, `../rust-embed` next to

`website/` — not inside this repo. No API calls, no bucket access: README, file

tree/content, commit list, per-commit diffs, per-file history, and per-file blame are all

read straight from git (`git ls-tree`, `git log`, `git show`, `git blame`) at build time.

A repo listed in `src/_data/site.js` only gets pages if a matching directory exists next to

this project *and* is a git repo in its own right (has its own `.git`, not nested inside

another repo's working tree); otherwise it just shows as a plain, unlinked card on the home

page. File discovery excludes `node_modules`, `dist`, `.git`, and similar build-output

directories regardless of whether they're git-tracked, and reads the tree at `HEAD` rather

than the working directory so uncommitted local changes don't leak into the generated pages.

## Commands

| Command             | Action                                                          |

| :------------------- | :---------------------------------------------------------------- |

| `npm install`        | Install dependencies                                            |

| `npm run dev`        | Start the Eleventy dev server with reload                       |

| `npm run build`      | Build the static site to `./dist/`                               |

| `npm test`           | Build, then run the Playwright page tests                       |

| `npm run test:hurl`  | Run [hurl](https://hurl.dev) checks against the live git dumb-http endpoint (`git.pyrossh.dev`); requires the `hurl` CLI |