Blygger Studio 0.40.0
Released 2026-10-10, the reference client. v0.40.0 on GitHub.
Migrations: none. Six contributor PRs, merged together.
/api, all additive: GET /api/reading/imported (#61); Settings gains
custom_theme, custom_theme_dark, custom_theme_name and font (#58); in
GET /api/ai/models a provider's key_secret is optional and a Workers AI
provider carries binding (#60); the lineage-glyph extension's two reads under
/api/ext/lineage-glyph/ (#53, 404 unless compiled in and enabled).
Reading API (Aneesh Sathe, #61)
GET /api/reading/imported, underowner:read: every imported item, newest observed first, with the fields a client authors from (markdown, author, signal, hopper ids, the origin's transclusions,stubOfandforkedFromverbatim,readVersion). Paged by an opaque keyset cursor over(observed_at, subscription, id), so ties split exactly and a poll between two requests never shifts or repeats rows. A cursor the server did not issue is a 400;limitis 1–100, default 50. For clients such as Blygger Desktop that would otherwise need one/imports/{sub}/{id}call per row.
Public pages (Aneesh Sathe, #62, closes #9)
- A paragraph that is only a bare YouTube link becomes a click-to-play
poster. Strict URL rule (YouTube's own hosts, video path shapes, an
11-character id, no credentials or port). The poster comes from
i.ytimg.comwith no referrer; nothing loads from YouTube itself until play, and then the player isyoutube-nocookie.com. The link stays as the caption. - An off-origin image that fails to load becomes "Image: alt ↗ (host)", a link to it (a span inside an existing link, so links never nest).
- Both are done by a page script on screen only:
content_html, feeds and item JSON are unchanged, every version (pinned ones too) gets the same treatment, and with scripts off the link is a plain link.
Theme and typeface (Miguel, #58, roadmap row 4)
Custom theme. A Custom tile beside the presets opens an editor for the
author's own palette: the same nine values a preset has (dark plus page,
paper, ink, inkSoft, rule, pencil, genBg, genRule), so the public
pages and the studio take it through the same path as any preset. It starts
from whichever preset was showing, previews live, warns when text, secondary
text, links or generated highlights fall below WCAG AA contrast on the paper
(advisory, never blocking), and exports and imports the palette as JSON so a
look can be passed from one blyg to another. Colours only: every value must
be #rrggbb, checked in the studio and again by the server before it is
stored, so nothing but a colour reaches style.css.
Light and dark. Follow the reader's light/dark setting adds a dark
companion (custom_theme_dark): the custom theme then behaves like Auto, with
the author's colours — the light palette in the base block, the dark one under
prefers-color-scheme: dark, and the studio flipping with the device the same
way. Most devices switch on their own now, and a custom theme that ignored that
would be a step back from Auto. The pair must be coherent (light dark: false,
companion dark: true, never a companion without a light half), checked in
the studio and by the server. Without a companion, a custom palette is fixed,
like a preset. A pair exports and imports as {"light": {…}, "dark": {…}}.
A name for the look. Name this look (custom_theme_name, optional,
one line, at most 40 characters) labels the Custom tile and travels with the
look when it is shared: {"name": "Pink Quill", "light": {…}, "dark": {…}}.
It is shown as text and never reaches the stylesheet.
Switching to a preset
keeps the palette, so switching back restores it; custom_theme: null clears
it, and is refused while the theme in use is custom.
Reading typeface. A choice of eight system font stacks (from Modern Font
Stacks, CC0): Book (the default, unchanged), Transitional, Humanist sans,
Geometric sans, System sans, Rounded, Slab serif, Monospace. Each names fonts
already on the reader's device, so nothing is downloaded and no third party
sees a reader; "no web fonts" still holds. Only --serif changes, so all
reading text follows the choice while the apparatus keeps its sans. Unknown
ids are refused (400). Public pages only; the studio keeps its own type.
AI providers (Aneesh Sathe, #60, closes #8)
- Cloudflare Workers AI (studio#8, after Aneesh Sathe's local patch). A
workers-aiprovider inmodels.jsonruns@cf/…models on the Worker's ownaibinding, with no API key; Gemma 4 26B, Llama 4 Scout, Llama 3.3 70B and Mistral Small 3.1 are listed, and any@cf/…id can be typed in. The binding is commented out inwrangler.jsoncand in whatnpm run initwrites: uncomment it to offer these models. Nothing runs on it until a model is chosen in Settings: still no default model and no fallback. Reasoning a model inlines into its answer is removed, and Gemma 4 is asked not to think. - OpenAI-compatible endpoints. An
openai-chatprovider calls any Chat Completions endpoint at itsbase_url(OpenRouter, Groq, Together, Cloudflare's OpenAI-compatible endpoint, a local Ollama), with its key in a Worker secret named bykey_secret. Add one inmodels.local.json; README § AI models has an example. The build now refuses a manifest whose provider could not be called: an unknown api, a missing key secret or base URL, a base URL that is not https or carries credentials, or akey_secretnamingOWNER_PASSWORDorCOOKIE_SECRET. - Both spend the daily AI budget like every other provider.
- API: in
GET /api/ai/models, a provider'skey_secretis now optional (absent for Workers AI and keyless endpoints) and a Workers AI provider carriesbinding.configuredmeans the key is set, the binding is bound, or neither is needed. - Tests never reach real, billed Workers AI (
remoteBindings: false).
Extensions (Aneesh Sathe, #53)
- lineage-glyph, #35's lineage glyph, hex view and action ring, ported
onto the extension mechanism. It has a server half (two owner reads), so it is
compiled in by an operator and never ships in release archives;
extensions.jsonis unchanged. Hrefs from foreign documents must passisFollowableUrl.
Fixes
- Composer tools place the caret at once (Aneesh Sathe, #64).
TK,[[,![[, link from clipboard, scan and the bracket picker placed the caret one animation frame late, so anything that selected or typed in between had its selection collapsed and appended instead of replacing. This was the CI flake incompose-pwa.spec.ts:179.
This announcement is drafted from the release's section of CHANGELOG.md, which is where it is maintained. To comment, respond to this item from your own blyg.