docsite

docsite is the source code for docs.ewancroft.uk — the central documentation hub for ewan's projects. It's a static SvelteKit site with a terminal-inspired aesthetic, driven by local Markdown files and published to the AT Protocol via Sequoia.

How It Works

Documentation is written as Markdown files in src/content/documentation/. Each file's frontmatter (title, description, date, tags, draft) is parsed at build time using gray-matter. The site lists all non-draft posts sorted by date and renders them via a Unified/remark/rehype pipeline with GFM support and heading id attributes for anchor links.

Posts are also published as site.standard.document records on the AT Protocol PDS via Sequoia, making them part of the standard.site ecosystem. The sequoia.json config at the repo root wires the content directory, output directory, and publication record together.

Routes

Quick Start

Edit .env:

Add Markdown files to src/content/documentation/, then:

Adding Documentation

Create a .md file in src/content/documentation/:

• draft: true hides the post from the index and all routes
• date is used for sorting — ISO YYYY-MM-DD format
• The filename (without extension) becomes the URL slug at /projects/[slug]

Sequoia Publishing

sequoia.json at the repo root configures the Sequoia CLI:

Running sequoia publish syncs local Markdown files to site.standard.document records on the PDS, making them accessible to any Standard.site-compatible reader.

Environment Variables