New release v1.0.4: Pages, search, and editable site files

We are pleased to announce microfeed v1.0.4, an update focused on turning the public site into a more complete website with standalone Pages, credential-free Item-and-Page search, and editable root-level Site Files.

microfeed 1.0.4 also introduces the format v2 theme contract needed to present these features, improves standalone theme exports, and makes content creation from coding agents safer to validate, retry, and verify.

Standalone Pages and website navigation

Pages provide a dedicated home for website-only content such as About, Contact, or Resources without adding those documents to RSS or JSON Feed. The Page editor uses the familiar rich-text experience and adds an explicit top-level URL path, a search and social description, visibility controls, and an optional website-navigation label.

Published Pages can appear in website navigation, and their order can be arranged by dragging or with keyboard controls. Unlisted Pages remain available at their public URL but stay out of navigation and public search, while Draft Pages remain private.

New installations include a Published About Page at /about/. Eligible existing sites receive the same starter only when that path has never been used, so an update never overwrites an existing or previously deleted About Page.

Page URLs remain dependable over time. When a published path changes, microfeed permanently redirects the old path to the new one. Previous and deleted paths stay reserved so they cannot later point to unrelated content.

Every site also has a protected, editable Default 404 Page. Administrators can customize its title, description, and rich content, preview it at /404/, and use the same themed result for missing public URLs while preserving the correct 404 response.

Public Item-and-Page search

The public website can now search Published feed items and standalone Pages without credentials. Draft and Unlisted Pages, including the special 404 Page, stay out of public results.

The bundled Default theme includes a responsive typeahead search dialog that opens from its search control or with Command/Ctrl-K. Visitors can move through suggestions from the keyboard, open a result directly, or continue to the dedicated /search/ page for complete results and detailed excerpts.

Search ranks exact matches first, tolerates minor title typos, and uses a unified D1-backed corpus shared with Admin workflows. Because the corpus is derived from durable content, deployment and snapshot restore can rebuild it safely.

Theme authors can add the same experience through the format v2 webSearch slot, shared search controls, navigation_pages data, and representative Page and Search previews in Theme Kit.

Editable Site Files

Site Files make root-level text responses manageable from Admin. microfeed provides generated defaults for robots.txt, llms.txt, and sitemap.xml, and administrators can add supported custom files such as security.txt.

The generated files keep crawler and machine-readable discovery current automatically. robots.txt advertises the sitemap, llms.txt summarizes the site, Published Pages, and recent items for AI tools and links enabled API documentation, and sitemap.xml includes the home page, Published Pages, Published items, and supported image or video metadata.

Each file has a private Mustache draft with Source and Preview tabs. Format-aware highlighting helps with JSON, XML, Markdown, YAML, CSS, CSV, and other text formats, while Preview renders the exact unsaved response bytes with current site data. JSON and XML output must validate before it can be published.

Templates can use channel data, up to 100 newest Published items, and up to 100 most recently updated Published Pages. microfeed also stores the last valid rendered result for a published override, so a later content change that produces invalid output falls back safely instead of breaking the public file.

Generated files can be overridden, saved as Draft, or restored to the current microfeed default. Custom files can be created and deleted. Pages, Page path history, Site File drafts, and published overrides are included in portable snapshots and are available through the documented versioned API.

Theme compatibility and safer automation

Format v2 extends the theme contract from six to eight slots with webPage and webSearch, website navigation data, editable 404 support, and complete Feed, Item, Page, Search, and RSS previews. The bundled Default theme is the reference implementation, with responsive navigation, modern search controls and results, a shared footer, and consistent rich-text spacing.

Installed format v1 themes remain compatible and continue rendering Feed and Item pages. Administrators can draft Pages under v1, but publishing Pages and exposing public search require an active format v2 theme. During an update, microfeed installs the bundled v2 Default theme without changing the active design, so it can be previewed and activated separately.

Theme exports are now complete standalone Git-ready repositories. An active or specific installed theme can be exported, installed, validated, tested, and previewed independently from the microfeed application checkout.

The official @microfeed/cli also adds compact summary output, unwrapped reads, server-side validation-only checks, post-create verification, framed JSON input, and 24-hour idempotency keys. These options make agent-driven item creation smaller, safer to retry, and easier to recover when a request is interrupted.

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 item-idempotency, Page, public-search, editable-404, and Site File migrations; creates the starter About Page only when its path is available; rebuilds the unified search corpus; 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, Pages and Site Files guide, and theme guide for details.

Version 1.0.4 makes microfeed more useful as a complete public website while preserving its feed-first, self-hosted foundation. See the full changelog for every change.