Bytestream · design review · 2026-09-24
Link card directions
Picked 2026-09-24: D7, 1px dimmer edge.
The link card is the picture a chat app shows when someone pastes a Bytestream link. Today one plate serves every link. This page proposes a family: one default and a card for a channel, a video, a Room, the docs and the style book. It shows three directions, each with real data, at full size and at the sizes chat apps crop it to.
Where the FREEDOM line goes. Every link card carries BYTESTREAM over its FREEDOM line: the homepage, a channel, a live, a video, a Room, the docs and the style book. The app itself never shows the line (Jake, 2026-09-24).
Nothing here is live. The card on bytestream.tv, /watch and /v stays as it is until you pick a direction.
What a pasted link shows today
The production rows were fetched the way a link crawler fetches them, on 2026-09-24. The staging rows come from the code, because staging now answers with a login page.
| Link | Example | Card today | Problem |
|---|---|---|---|
| Homepage | bytestream.tv | The plate: LIVE pill, BYTESTREAM, FREEDOM in Morse. Title Bytestream. | The word is 880px wide, so a centre-square crop cuts it to TESTRE. |
| Channel | bytestream.tv/watch/NHKWorldJapan.jp | The same plate. Title NHK World Japan on Bytestream, from api/watch.ts. | The picture never names the channel; only the title under it does. |
| Video | bytestream.tv/v/<slug> (staging only) | The video's still when it can be shown, else the plate (src/share/videoCard.ts). | A raw still carries no Bytestream mark. No video is approved on production yet. |
| Room or creator | bytestream.tv/<slug>, /@<slug> (staging only) | No route of its own in vercel.json: the app shell's default plate and title. | A creator's link looks like the homepage. |
| Staging | staging.bytestream.tv/… | Vercel's login page. Staging now sits behind Vercel login. | Any staging link shared for review unfurls as a login page. |
| Docs | docs.bytestream.tv/design | Title Design - Bytestream and a description. twitter:card is summary_large_image with no og:image. | A large card with no picture: X and LinkedIn show an empty or text-only card. |
| Style book | design.bytestream.tv/brand/ | The plate with STYLE BOOK where the LIVE pill sits. Title per page. | The same crop problem as the homepage. |
Rules every direction follows
- 1200 × 630 PNG, the size every app accepts.
og:image:widthandheightset, absolute URLs. - Safe square. Some apps crop a centre square. Everything that must read sits in the centre 630 × 630, inside a 35px margin: a 560px column. Turn on the safe square below to see it.
- Void ground and paper type. On every card BYTESTREAM carries its FREEDOM Morse line, exactly as wide as the word. Every lockup on this page is the picture
make-og-card.mjs --lockupdraws, so the geometry is the link card’s own. - LIVE pill only on a channel. Chat apps keep a card for days. A channel is on air whenever the link opens; a Room is not, so a baked-in LIVE would go stale. A Room says Room.
- Names in the tags. The channel, video or Room name always goes in
og:title, whatever the picture shows. - Fallback. No picture, or a picture that may not be shown (18+, gone, not out yet): the plate for that variant.
What Jake decides
- Which direction. A ships as six static PNGs, made by the script that makes today's plate. B and C draw a card for each link.
- A renderer for B or C. Drawing a card per link on Vercel needs an image renderer. The usual one is
@vercel/og(Satori), a new package. An alternative with no new package: pre-render cards at build time for the 329 channels with a guide, and fall back to the plate for the rest. - Docs card. The docs site sends a large card with no picture. It gets the docs plate in any direction;
docs.jsontakes it as a meta tag. - Staging links unfurl as Vercel's login page while staging is behind login. Fine for a private staging; worth knowing before sharing a staging link in a chat.
Crop sizes are approximate. Apps change their layouts, and each draws its own frame around the card. Fonts on this page load from Google Fonts: Barlow Condensed 600 and Inter, the app's faces.