website

website is the source code for ewancroft.uk. It's a fully AT Protocol-integrated personal site built with SvelteKit 5, Tailwind CSS 4, and Svelte 5 Runes. While the repository includes Ewan-specific configuration, the codebase is designed to be adapted for anyone running their own AT Protocol-powered site.

Features at a Glance

AT Protocol integration — Bluesky profile (avatar, banner, bio, pronouns, follower counts), Standard.site blog posts, teal.fm music status, kibun.social mood status, Tangled repositories, and Linkat link board — all fetched live with configurable in-memory caching.

Content system — Multi-publication Standard.site support with friendly URL slugs, per-publication RSS 2.0 feeds, an /archive page, and redirects from /{slug}/{rkey} to the full document on Standard.site.

Bluesky post display — Latest non-reply posts with full thread context, quoted post embedding, image galleries, external link cards, HLS.js video streaming, and real-time like/repost counts via Constellation API.

Music integration — Album artwork via a cascading server-side proxy: MusicBrainz Cover Art Archive → iTunes → Deezer → Last.fm → AT Protocol blob fallback. All with smart caching and CORS-free via /api/artwork.

Theming — 12 colour themes (Sage, Monochrome, Slate, Ruby, Coral, Sunset, Amber, Forest, Teal, Ocean, Lavender, Rose) using OKLCH colour space, system preference detection, and persistent selection.

Fun bits — Wolf mode (converts page text to wolf sounds while preserving numbers, abbreviations, and interactive elements), decimal clock, Happy Mac easter egg, scroll-to-top button.

Quick Start

git clone git@github.com:ewanc26/website
cd website
npm install
cp .env .env.local

Edit .env.local:

PUBLIC_ATPROTO_DID=did:plc:your-did-here
PUBLIC_SITE_TITLE=Your Site Title
PUBLIC_SITE_URL=https://yoursite.com

Configure publication slugs in src/lib/config/slugs.ts, then:

npm run dev

Environment Variables

Variable	Required	Description
PUBLIC_ATPROTO_DID	Yes	Your AT Protocol DID
PUBLIC_SITE_TITLE	No	Site title for SEO
PUBLIC_SITE_URL	No	Canonical site URL
PUBLIC_CORS_ALLOWED_ORIGINS	No	Comma-separated CORS origins for /api/
CACHE_TTL_PROFILE	No	Profile cache TTL in seconds (default: 60)
CACHE_TTL_MUSIC_STATUS	No	Music status TTL (default: 120)
CACHE_TTL_KIBUN_STATUS	No	Mood status TTL (default: 120)

Publication System

Map friendly slugs to Standard.site publication rkeys in src/lib/config/slugs.ts:

export const slugMappings: SlugMapping[] = [
  { slug: 'blog', publicationRkey: '3m3x4bgbsh22k' }
];

This creates routes at /blog, /blog/{rkey}, and /blog/rss.

AT Protocol Services

All AT Protocol data fetching lives in src/lib/services/atproto/:

• fetch.ts — Profile, links, music and mood status
• posts.ts — Bluesky posts and Standard.site documents
• documents.ts — Standard.site document management
• engagement.ts — Like and repost counts via Constellation API
• media.ts — Blob URL construction and image handling
• musicbrainz.ts — Album artwork with cascading fallbacks
• cache.ts — In-memory caching with configurable TTL
• agents.ts — PDS resolution with Bluesky public API fallback

Custom Lexicons Used

• uk.ewancroft.site.info — Site metadata (tech stack, credits, privacy statement)
• blue.linkat.board — Link board
• fm.teal.alpha.actor.status + fm.teal.alpha.feed.play — Music status
• social.kibun.status — Mood status
• sh.tangled.repo — Code repositories
• site.standard.* — Longform content documents and publications

Tech Stack

SvelteKit 2.50+ with Svelte 5, Tailwind CSS 4, @atproto/api v0.18.1, HLS.js, Lucide icons, Vite 7, TypeScript 5.9+. Deployed on Vercel via @sveltejs/adapter-vercel.

Licence

See LICENSE and THIRD-PARTY-LICENSES.txt in the repository.