Skip to content

flue.sh and README as one plain document - #137

Merged
karngyan merged 10 commits into
mainfrom
worktree-site-readme-overhaul
Aug 23, 2026
Merged

flue.sh and README as one plain document#137
karngyan merged 10 commits into
mainfrom
worktree-site-readme-overhaul

Conversation

@karngyan

@karngyan karngyan commented Aug 23, 2026

Copy link
Copy Markdown
Contributor

What changed

flue.sh read like a paid product: a 60px hero, a glow, dashed rails, a pill, cards, a numbered trust path, a sticky header. It is an MIT side project. The site is now one monospace column that reads like a README, in the spirit of code.storage: # and ## headings with their markers showing, * lists, a facts table, $ transcripts, --- rules, bracketed nav links.

The positioning changes with it. The old page sold "walk and read the answer on your phone". The thing people use is organisation: every Claude Code, Codex and terminal session across every machine in one list, with the agent history beside it. Remote access is one section in that list.

The README carries the same headline, paragraph and eight bullets, so the two cannot drift apart. Every bullet was checked against web/src and internal/ before it was written, and the list now names things the old site never did: the agents page with transcripts, tokens and cost, splits and tabs, file peek, saved views, drag to retag, and reboot revive with the printed resume command.

Site

  • site/src/components/md.tsx is new and owns the whole look: H1, H2, P, Ul, Ol, A, Code, Kbd, Pre, Shell, Table, Rule, Meta, Arrow, Column. One text size.
  • Homepage, header, footer, DocPage and the four docs pages compose those primitives. Content on the docs pages is unchanged; the CLI list is a table, the relay diagram is drawn in box characters, the FAQ is headings and answers.
  • The three drawn mocks stay, without their shadows. They keep Inter because they are pictures of the app, and the app is set in Inter. Everything else is Geist Mono.
  • Deleted: ui/button.tsx, mock/terminal.tsx, mock/diagrams.tsx, the backdrop-scan utility, the --radius tokens.
  • Light and dark both stay, with the existing toggle.
  • __root.tsx title and description and llms.txt say what the homepage says.

README

Same skeleton as the homepage. 172 lines to 154. The "Sessions outlive flue" section is now a bullet, the setup section is the four steps and one warning, and the Status section links to the releases page instead of naming a version (it said v0.5.1; the latest tag is v0.9.4).

OG image

og.png was the mark alone on black, with alt text describing a third thing. /shot (the dev-only capture route) now composes the card at 1200 by 630 in the page's own style, and the capture is checked in: meta line, the headline with its # showing, the install line.

Not in this PR

docs/hero-*.png and docs/architecture.png are unchanged.

Checks

  • cd site && pnpm run lint and pnpm run build (vite, check-pages, sitemap, check-prose): green.
  • Screenshots of every page at 1280 and at ~500px, light and dark. Nothing scrolls the page horizontally; the switcher mock still opens on the chord; the copy button copies; the theme toggle works.
  • Spec and plan are in docs/superpowers/.

🤖 Generated with Claude Code

karngyan and others added 10 commits August 23, 2026 15:04
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The page is set in Geist Mono like a README. Inter stays loaded for the
drawn mocks, which are pictures of the app and the app is set in Inter.
The hero's scan-line backdrop goes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
One column, headings with their markers showing, eight bullets that say
what flue does, a table of facts, and the install line. The mocks stay,
without their glow, and keep Inter because they are pictures of the app.
The positioning moves from remote access to organising sessions, which
is the thing people use. No version number on the page: the one in the
README was three minor releases stale, and a number nobody bumps is worse
than none.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The CLI list is a table, the relay diagram is drawn in box characters,
the FAQ is headings and answers, and the notes are block quotes. Content
is unchanged.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The same headline, paragraph and eight bullets as flue.sh, so the two
cannot drift apart. The walking story goes; organising sessions across
machines is what people use, and remote access is one section in that
list. The version number goes too: it said v0.5.1 and the latest tag was
v0.9.4, so the Status section now links to the releases page instead.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The old og.png was the mark alone on black, and its alt text described a
third thing. The /shot route now composes the card at 1200 by 630 in the
page's own style, and the capture is checked in.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@karngyan
karngyan merged commit a27de5f into main Aug 23, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant