Meta

This page explains how this site is built and structured.

Philosophy

This site is designed to be a personal knowledge base — a collection of thoughts, ideas, and reflections organized hierarchically by topic. The design philosophy emphasizes simplicity: write markdown, organize by folders, and the site structure emerges naturally.

Technical stack

Built with Astro using content collections. No complex CMS, no database — just markdown files in a folder structure.

• Deployed as a fully static website — zero framework JavaScript shipped
• Plain CSS on a small set of design tokens; self-hosted variable fonts (Fraunces + JetBrains Mono)
• The tree is drawn with a deterministic force relaxation: same seed, same constellation, always
• Search is a client-side ⌘K palette over the tree — an accelerator, not the index
• No trackers, no third-party scripts

Content structure

All content lives in src/content/pages/ as markdown files:

src/content/pages/
├── index.md                     → / (home)
├── humanity.md                  → /humanity/ (branch page)
│   ├── fire.md                  → /humanity/fire/
│   │   └── architecture.md      → leaf page
│   ├── orkava.md                → leaf page
│   └── temporal.md              → /humanity/temporal/
│       ├── oom-investigation.md       → leaf page
│       │   └── deep-dive.md           → leaf page
│       └── worker-configuration.md    → leaf page
│           └── deep-dive.md           → leaf page
├── self.md                      → /self/ (branch page)
│   ├── addictions.md            → leaf page
│   ├── how-i-want-to-live-my-life.md  → leaf page
│   ├── pain-suffering-and-god.md      → leaf page
│   └── sport.md                 → /self/sport/
│       └── boxing.md            → leaf page
└── meta.md                      → /meta/ (this page)
    └── 2026.md                  → leaf page

Folder structure = site structure. No configuration needed.

Design choices

Hierarchy: visual hierarchy matches content hierarchy — home is special, branches organize, leaves contain.

Static: everything is served statically. Reading is the product; there is no backend.

Status

The site is live at its final hostname: web.miquelpuigturon.com.