Changelog

Review Lotus releases to understand what changed, what was fixed, and whether an upgrade affects your documentation site.

Unreleased

• Add upcoming release notes here.

0.7.3

2026-09-02

• Added Grok and Perplexity to the default page-action menu and removed the duplicate Copy page entry from its dropdown.
• Fixed CodeBlock rendering to use astro/components/Code.astro.

0.7.2

2026-08-30

• Consolidated shared icon, Markdown transform, and image-gallery setup behind the @prosefly/astro-components/integration integration.
• Made Pagefind an optional peer dependency; install pagefind separately when selecting the Pagefind search provider.

0.7.1

2026-08-28

• Fixed stale asynchronous search results overriding newer queries and search loading errors.
• Reused resolved documentation navigation context to avoid duplicate sidebar resolution during page rendering.
• Fixed the default lang value for the root locale when no language tag is configured.
• Added cleanup and page-load reinitialization for the table of contents, mobile docs navigation, sidebar scrolling, and dropdown interactions during Astro view transitions.
• Pinned published integration dependency versions for reproducible installs.

0.7.0

2026-08-22

• Added @prosefly/astro-theme-lotus/blocks with reusable Hero, FeatureGrid, FeatureCard, Pricing, PricingCard, and CTA page blocks.
• Moved PageContainer and PageSection from @prosefly/astro-theme-lotus/layouts to @prosefly/astro-theme-lotus/blocks.
• Added Page Blocks documentation with rendered examples for landing pages, pricing pages, and custom Astro routes.
• Improved the mobile docs sidebar section switch styling.

0.6.2

2026-07-25

• Updated @prosefly/astro-components to ^0.5.0 so the bundled Expressive Code header icon plugin resolves in package development and published installs.
• Added file-type icons to Expressive Code frame headers, with language labels for untitled code frames.
• Skipped header icons for terminal frames because the terminal frame already provides that context.
• Aligned CodeBlock header height and background with Expressive Code frame headers.
• Split Expressive Code prose styles into a dedicated stylesheet.

0.6.1

2026-07-23

• Added global head config entries for metadata, social cards, verification tags, scripts, and project CSS.
• Added head style sources that are appended after Lotus default styles and watched during development.
• Added --lotus-header-background and --lotus-footer-background tokens for shell surfaces that differ from the page background.
• Changed data-accent, data-gray, data-radius, and data-theme token selectors so scoped preview areas can apply theme tokens without changing the whole document.
• Updated the published JSON Schema URL to https://prosefly.dev/schema/lotus.json.
• Updated ThemeModeButton to render as an icon-only button to avoid navbar width changes.
• Updated the footer credit link to point to https://prosefly.dev/themes/lotus/.
• Improved Expressive Code frame headers so titled and untitled frames share the same header height and use the Lotus page background.
• Fixed prose code styling so not-prose content can opt out of inline code and code block rules.

0.6.0

2026-07-21

• Renamed theme config navbar to siteNav and sidebars to docsNav.
• Added automatic theme.config.json loading with a published JSON Schema at /schema.json; options passed to lotus({...}) override JSON values.
• Moved the language selector next to the site brand and removed it from mobile menu surfaces.
• Hid heading anchors on mobile viewports.
• Declared @prosefly/astro-components as a peer dependency for theme users.

0.5.0

2026-07-21

• Updated @prosefly/astro-components to ^0.4.0 and migrated the Prosefly component token/class prefix from pl to pf.
• Added lotus-prose size variants and support for text-sm, text-base, and text-lg on prose containers.
• Exported DocsLayout as a reusable documentation chrome layout with main and right-aside slots.
• Exported a reusable Sidebar theme component for custom pages and templates.
• Added markdown.cjkFriendly, enabled automatically for configured Chinese, Japanese, and Korean locales.
• Resolved Promise-based sidebar item groups when building sidebar navigation.
• Fixed sidebar scroll chaining so page scrolling continues after the sidebar reaches its top or bottom edge.
• Updated @prosefly/astro-components to ^0.4.1 and mapped Badge radius to the active Lotus radius scale.
• Narrowed the root package exports to documented integration and theme config APIs.

0.4.0

2026-07-19

• Enabled Prosefly callout directives from @prosefly/astro-components.
• Updated @prosefly/astro-components to ^0.3.0.
• Grouped Markdown-related integration options under markdown; top-level expressiveCode, calloutDirectives, and packageManagerTabs are removed.
• Added themeModeControl for choosing the built-in theme mode control without overriding ThemeSwitch.
• Fixed the standalone SiteHeader mobile menu alignment when search and assistant triggers are disabled.

0.3.1

2026-07-19

• Added llms config for disabling /llms.txt or generating /llms-full.txt.
• Pagefind indexing attributes are now emitted only when the Pagefind search provider is enabled.

0.3.0

2026-07-19

• Added SSR heading anchors for h2, h3, and h4.
• Added a CodeBlock export for Shiki-highlighted code on custom pages.
• Added a Prose export for custom pages.
• Added Markdown alternate links to docs page metadata.
• Added an automatically generated /llms.txt endpoint for AI-readable docs discovery.
• Added semantic status color tokens for info, success, warning, and danger.
• Updated @prosefly/astro-components to 0.2.1.
• Reworked SiteHeader into a standalone site header.
• Fixed prose links inside headings.
• Improved heading anchor styling on mobile.
• Fixed docs content width so page actions no longer overlap the table of contents on wide screens.

0.2.0

2026-07-18

• Added built-in UI translations for Traditional Chinese, Japanese, Korean, French, German, Spanish, Brazilian Portuguese, Italian, Russian, and Arabic.
• Added RTL direction inference for common RTL locales such as Arabic, Persian, Hebrew, and Urdu.
• Added RTL-aware shell behavior for the header, dropdowns, mobile docs menu, sidebar, table of contents, page actions, and previous/next page navigation.
• Added sidebar diagnostics for missing entries, empty autogenerated directories, duplicate sections, and duplicate page ownership.
• Enhanced sidebar generation with autogenerate.structure, autogenerate.depth, and autogenerate.exclude.
• Refactored sidebar generation into focused resolver, autogenerate, index, and diagnostics modules.
• Simplified docs homepage routing: docsBase now controls where docs render, and setting docsBase: '/docs' leaves / available for a custom homepage.
• Removed the separate homepage config option.
• Removed source.contentRoot; edit links and contributor source paths now use the content entry file path directly.
• Updated the release workflow to generate GitHub release notes automatically.
• Improved ARIA state, focus handling, and keyboard behavior for dropdowns, local search, mobile docs navigation, and page actions.
• Fixed deployed page action URLs so generated assistant links do not keep a local development origin.
• Improved mobile clipboard handling for Copy page.
• Added high fetch priority to the header logo image.
• Kept code, keyboard, and sample text left-to-right inside RTL prose content.

0.1.1

2026-07-17

• Fixed a Tailwind CSS issue in the package release.

0.1.0

2026-07-17

• Initial release of @prosefly/astro-theme-lotus.