New release v1.0.3: Versioned themes and agent-friendly publishing

We are pleased to announce microfeed v1.0.3, an update focused on versioned themes, agent-friendly content publishing, and faster content workflows.

microfeed 1.0.3 introduces immutable theme versions with isolated drafts and previews, the new @microfeed/theme-kit, an official content-management CLI with browser-controlled authorization, D1-backed item search, improved editing and media workflows, and faster public pages.

Versioned themes and modern authoring

The new theme system stores immutable theme versions in D1. Administrators can create an isolated draft, preview changes without affecting the public site, and explicitly activate a new version or roll back to an earlier one.

The yarn manage theme workflow can create, install, list, export, and activate themes, including themes hosted in public GitHub repositories. Portable snapshots now include installed theme versions and their assets.

Theme developers can use @microfeed/theme-kit to generate a starter theme, validate the theme contract, run fixture-based tests, preview a theme locally, and download JSON Feed fixtures from a microfeed site. The documented theme contract includes packaged assets, design tokens, custom fixtures, RSS stylesheets, and generic or bundled-default starting points.

Content publishing from the CLI and coding agents

Version 1.0.3 introduces the official @microfeed/cli client for managing content from a terminal or local coding agent.

The CLI uses per-instance OAuth authorization with administrator consent in the browser. Credentials stay out of prompts, and each computer appears as its own connection under Account settings. After authorization, yarn microfeed can list, search, read, create, update, and delete items; upload standalone media, cover images, and RSS enclosures; or call documented REST operations directly.

Deterministic JSON output and the bundled content-management agent skill make these workflows reliable for automation while keeping administrator passwords and API credentials private.

Faster search, editing, and publishing

Item search now runs against titles and stored plain-text content in D1. It is available from the Admin dashboard, the GET /api/v1/search/ endpoint, and the content CLI, with filters and cursor pagination.

The editor now autosaves item changes, provides clearer save and publication feedback, and improves rich-media insertion, dragging, sizing, alignment, captions, links, and native video embeds. The new Account area also provides one place to manage the administrator email and password, passkeys, active sessions, and connected CLI applications.

Public website pages, RSS, JSON Feed, and sitemap responses now use Workers Cache with content-aware invalidation. This improves response times without serving stale content after an update.

Smaller improvements

This release adds {{current_year}} for copyright text that stays current automatically, clearer guidance for built-in login and disabled API access, earlier focused deployment tests, and expanded documentation for deployment, content automation, account security, item search, theme development, and both CLIs.

Updating an existing Workers deployment

If your local repository clone is already connected to a microfeed Worker, protect any local work, update the clone, and run:

yarn install --immutable
yarn manage deploy
yarn manage status

The deployment applies the OAuth, account-security, item-search, and versioned-theme migrations; normalizes existing item text for search; runs project checks; builds and deploys the Worker; and verifies the result.

You can also open the connected repository in a local coding agent and ask:

Deploy to Cloudflare.

See the update guide and theme guide for details.

Version 1.0.3 makes microfeed easier to customize, automate, and operate while preserving its self-hosted foundation. See the full changelog for every change.