franklinbaldo.github.io

Personal blog and digital garden of Franklin Baldo. Built with Astro 7 and Pico.css v2.

Live site: https://franklinbaldo.github.io/

What lives here

The repository powers more than a chronological blog. Its public surface currently includes:

• essays and the archive, with tags, search and bilingual routes;
• curated reading paths that connect related essays into sequences;
• a public projects index;
• the Hrönir ranking, produced from committed pairwise evaluations used to curate and compare the writing corpus;
• music and books as adjacent parts of the digital garden;
• a public changelog and RSS feeds for following updates.

Hrönir is both repository machinery and a public-facing curation artifact: the evaluation data lives in .routines/hronir/, while the resulting ranking is published on the site.

Stack

• Astro 7 with @astrojs/mdx
• Pico.css v2 (semantic, classless-ish CSS)
• Typography: Fraunces (body) / Inter (UI) via @fontsource
• astro:assets for image optimization (heroes generate responsive WebP)
• Hrönir — pairwise post-ranking system. See CLAUDE.md for the full operating manual.

Commands

Requires Node >=24.0.0 (see package.json#engines).

Project layout

src/
├── components/        Astro components
├── content/
│   └── blog/          Posts (.md/.mdx) — slug = filename = URL
├── content.config.ts  Zod schema for the blog collection
├── lib/               Build-time TypeScript helpers
└── pages/             Routes (bilingual: / and /pt/)

scripts/
├── hronir/            Hrönir CLI and rating engine
├── lib/               Shared helpers (content.mjs, blog-links.mjs)
└── oneoff/            One-shot scripts, not part of the build

docs/
├── rfcs/              RFC documents (0001 …)
├── plans/             Planning documents
└── reviews/           Session reviews

.routines/
└── hronir/            Rate files produced by Hrönir sessions (committed)

Feeds

RSS feed at /rss.xml, generated from the blog collection via @astrojs/rss.

Notes on the modernization migration

A couple of legacy standalone routes were dropped during the Astro modernization:

• /encrypt.html — static page-encryption demo.
• /vault/ — unmaintained landing page.

If you depended on either, open an issue.