audiosilo-site

Use of AI: AudioSilo is developed by me (a human), with assistance from AI, primarily Claude Code, to help me write, clean up, document, and review the code. That doesn't mean the app is generated on autopilot or "vibe coded". Nothing goes out until I've read it, tested it, and decided it belongs. AI is what lets one person keep up this pace, and I think it's important to disclose that.

Website · Docs · Discord · Sponsor

Marketing site for AudioSilo, the self-hosted, multi-platform audiobook player.

Built with Astro (static output) + a couple of React islands, styled with Tailwind CSS v4. Dark-only, built to look like the product. Deployed to GitHub Pages on the audiosilo.app domain (see public/CNAME).

Workspace

This is the fifth repo in the ~/dev/audiosilo multi-repo workspace. Read the workspace ../CLAUDE.md and this repo's CLAUDE.md before working here. CLAUDE.md also documents the session model-routing convention (an orchestrator plus Opus implementers) and the design tokens. The visual direction lives in docs/DESIGN.md.

Develop

yarn install
yarn dev          # http://localhost:4321

Node 24 (export PATH="$HOME/.nvm/versions/node/v24.16.0/bin:$PATH"), yarn.

Build / gate

yarn build && yarn run check   # the gate: build dist/ + astro check (TypeScript)
yarn preview                   # serve the built site locally

Use yarn run check, not bare yarn check (which runs yarn's own lockfile check).

Structure

public/                 static assets: logo.svg, favicons, CNAME, og.png,
                        robots.txt, shot-*.png (pipeline-generated screenshots)
src/
  components/           .astro components + React islands (.tsx)
    home/               home-page sections (Hero, PlatformStrip, HowItWorks,
                        FeatureCards, SelfHosting, Sharing, ManagerTeaser, FinalCta)
    VersionBadge.tsx    React island: latest server release tag (runtime fetch)
  data/features.ts      home-page feature content
  layouts/              Base.astro, DocsLayout.astro
  pages/                index, download, docs/*, privacy, 404
  styles/global.css     Tailwind v4 entry, @theme design tokens, custom CSS
docs/DESIGN.md          the design brief the UI follows
CLAUDE.md               repo guide + model routing + conventions

Deploy

Pushing to master runs .github/workflows/ci.yml, which builds the site with Node 20 and publishes dist/ to GitHub Pages. Keep work on branches until it is reviewed, since a push to master deploys the live site.

Content sources

Product copy must be true: only claim shipped, live things. The verified fact base and phrasing guidance for this site live in the workspace ../CROSS-REPO.md section 16. Copy is drawn from the AudioSilo repositories (audiosilo-server, audiosilo-frontend, and the private manager). The header version badge fetches the latest server release tag from the GitHub API at runtime, falling back to a hard-coded value in src/components/VersionBadge.tsx.