# Changelog ## 0.24.0: Tutorial Mode ```yaml version: 0.24.0 date: 2026-06-08 tags: writing, reading ``` Books can now be presented as step-by-step tutorials, with a sidebar of steps and a checklist readers work through. The saving system was reworked alongside it to be more reliable, keeping edits safe and syncing them as soon as the connection allows instead of sending once and forgetting. ### Tutorial mode A new way to present a book: as a guided walkthrough that a reader moves through one step at a time. Each step is a section of the book, shown on its own with the rest set aside, so a reader is never faced with more than the part they are on. A sidebar lists every step and tracks how far along they are. Steps get checked off as the reader goes, and they can move with the arrow keys or the Back and Next buttons. The progress sticks: close the tab and pick up later from the same place, with or without an account. Building one takes no special setup. Write the book as usual, with a heading for each step, then switch its mode to Tutorial. A shared tutorial opens the same guided way for whoever receives it, with a button to copy the walkthrough into their own library to follow at their own pace. ```bookref id: doc-tutorial title: Tutorial Mode desc: Present a book as a guided, step-by-step walkthrough with a progress checklist. share: /documentation/using-fleuron/tutorial ``` ### New - **Tutorial mode.** A document mode that presents a book as numbered steps, with a step sidebar, keyboard navigation, and a per-step checklist. - **Copy to library.** A shared tutorial can offer a button that copies the book into the reader's own library to follow along. - **Durable saving.** Edits are queued and retried until the server confirms them, so nothing is lost to a reload, a dropped connection, or a closed tab. - **Honest save status.** The indicator separates a local save from a confirmed sync, and surfaces syncing, offline, and conflict states as they happen. - **Changed elsewhere.** When a book was edited from another device, your version is kept and the other copy is set aside instead of being overwritten. ### Improved - **Opening a book.** Loads the newer version by comparing versions directly, instead of guessing from timestamps. - **Task list checkboxes.** Rendered task lists match the editor's conceal-mode checkboxes. ### Fixed - **Duplicated books on sign-in.** Claiming an anonymous book at login no longer leaves a second copy behind. - **Books that never synced.** A new book now reaches the server once a connection is available, instead of staying local indefinitely. - **Rendered code.** Font ligatures no longer activate in rendered code blocks. - **Quote attribution.** The `>>` syntax for crediting a blockquote is now documented in Markdown Basics. ## 0.23.0: Reader View ```yaml version: 0.23.0 date: 2026-05-28 tags: reading, sharing, focus ``` Shared books now have a proper reading surface. The sentence reader, X-ray overlay, and reading bookmark are active in the shared view; the chrome is redesigned to match. ### New - **Shared book reader.** A dedicated header with reading controls, a scroll-bound progress bar that eases through jumps, and an accent-colored footer. - **Reader tools in shared view.** The sentence reader, X-ray overlay, and reading bookmark are active when reading a shared book — no editor session required. - **Collapsible sections in shared view.** Section headings collapse and expand, matching the editor preview. ### Improved - **Share controls.** Sharing consolidates into a single inline panel, replacing a separate menu and modal. ### Fixed - **Collaboration.** Guest and owner cursors were invisible to each other in some sessions. - **REST block.** Can now fetch from external APIs in the browser. - **Code editor.** Font ligatures no longer activate inside editor lines. - **Toast notifications.** A stale transform caused the notification to appear off-screen in some conditions. ### Removed - **Waitlist.** Fleuron is open alpha. No invite required. ## 0.22.0: The Desk ```yaml version: 0.22.0 date: 2026-05-19 tags: organization, navigation, milestone ``` A new Desk overlay (++Cmd+E++) gives each book a working set of previews in a strip or grid. The bookcase became a three-state surface: hidden collapses it to nothing, shelf reveals a slim vertical strip of recent books and quick actions, and pinned keeps the full panel open. ++Cmd+K++ opens the bookcase in transient mode as the command palette, replacing the old separate component. ### Desk A working set of book previews pinned to the editor. Open with ++Cmd+E++ or the Desk button in the top bar. - **Strip mode.** Up to 2.5 scaled previews side by side, scrollable. Clicking a slot zooms into a hero transition that fills the workspace, then recedes back on close. - **Grid mode.** Letter-indexed cards in a compact grid. Drag to reorder. - **Slot navigator.** A floating row of dots below the strip shows slot count and position; a pill marks the in-view slots. - **Per-slot view memory.** Each slot remembers its scroll position and active slide index independently. - **Ghost slot.** The rightmost slot is an add affordance showing the three most recently opened books. - **Documentation slots.** Add documentation pages as desk slots alongside books. - **Independent zoom controls.** Strip size and grid size are adjusted separately with a stepper. ```bookref id: doc-desk title: The Desk desc: Working set overlay for comparing and navigating books without losing your place. share: /documentation/using-fleuron/desk ``` ### Shelf Three-state bookcase visibility replaces the older model: hidden collapses it entirely (hover the left edge to peek); shelf shows the slim strip; pinned keeps the full panel open. The pin button in the bookcase header splits into dock and collapse halves to switch between the last two without a menu. The shelf now shows the five most recently opened books and docs as initial avatars, the three most recent command palette actions with active-state indicators, and the account avatar at the bottom. Hovering any item reveals a tooltip label. ```bookref id: doc-bookcase title: The Bookcase desc: Left sidebar for books, folders, docs, and quick access to recent items and commands. share: /documentation/using-fleuron/bookcase ``` ### Command palette ++Cmd+K++ opens the bookcase in transient mode. The dedicated Command Palette component is removed. - **Scope chip exits scope.** Clicking the active scope chip returns to full search without pressing Esc. - **Keyword search in actions.** The actions scope matches against command labels and aliases. - **Recent items section.** A Recent group appears at the top of search results before the scope sections. - **Active state checkmarks.** Toggle commands show a checkmark when on. ```bookref id: doc-command-palette title: Command Palette desc: Navigate books, search docs, and run editor commands from the keyboard. share: /documentation/using-fleuron/command-palette ``` ### New - **Desk overlay.** ++Cmd+E++ or the top bar button opens a working set of scaled book previews in strip or grid mode. - **Open in workspace.** Clicking a desk slot opens the book in the full workspace; the other slots recede. Closing returns to the desk. - **Three-state bookcase visibility.** Hidden, shelf, and pinned replace the previous two-state model. - **Recent actions in the shelf.** The three most recently invoked command palette actions appear in the shelf with their icons and accent-colored active state. - **Recent docs in the shelf.** Documentation pages appear alongside books in the shelf recent list. - **Split pin button.** Dock and collapse halves in the bookcase header replace the visibility dropdown. - **Keyword search in the actions scope.** Searches against labels and registered aliases. - **Recent section in search results.** Surfaces the most recently opened items before the scope groups. ### Improved - **Bookcase row hover.** Cards use a warm tint; compact rows nudge their content inward. - **Search input focus.** A three-layer luminous glow on focus. - **Folder expand and collapse.** Animated with a grid-template-rows height transition instead of snapping. - **Active toggle indicators.** Toggle commands in the shelf use accent color with an outline ring; hover preserves the ring. ### Fixed - **Keyboard selection in search.** Result rows show the correct selection background when navigating by keyboard. - **Bookcase fade transition.** A background-color shorthand was silently blocking the panel fade-in animation. - **Hydration mismatch.** localStorage reads no longer produce server/client render mismatches. - **Shelf book navigation.** Opening a book from the shelf on a non-editor page now navigates to the editor instead of loading the book into the current view. - **Drag reorder artifacts.** Drop indicators on book and folder rows now clear reliably as the pointer moves between rows and when the drag ends. - **Changelog page.** YAML metadata blocks are now hidden on the public changelog page, not rendered as code blocks. ### Security - **API key.** Shown once at generation. Regenerating immediately revokes the previous key; copy it before navigating away. - **`javascript:` links.** Blocked from rendering in markdown, book embeds, and linked text. - **REST block.** Requests to private network addresses are blocked. ## 0.21.0: Human-readable URLs ```yaml version: 0.21.0 date: 2026-05-08 tags: sharing, presenting, reading ``` Share URLs now follow `/{username}/{type}/{id}/{slug}` for every public surface: read-only books, collab sessions, and slide audiences. Slugs are editable per link with a live URL preview, and mismatched slugs redirect to the canonical form. Slide presentation URLs stay valid across stop and start cycles. ### New - **Username-prefixed share URLs.** Public links read `/{username}/book/{id}/{slug}`, `/{username}/collab/{id}/{slug}`, and `/{username}/slides/{id}/{slug}`. - **Editable slugs.** Each share link carries its own slug, editable from the Share modal with a live URL preview. - **Footnote popovers.** Hovering a footnote reference opens a small popover with the footnote content rendered in the document's theme. Scoped to the active slide or feed entry so popovers don't leak across sections. - **Click to copy inline code.** Any inline `code` span copies its contents on click, with a brief toast confirmation. ### Improved - **Full URL in the Share modal.** Each link shows its complete URL in a read-only input that selects on click, instead of a truncated token. - **Persistent slide URLs.** The audience URL for a slide presentation stays valid across stop and start cycles. Previously each stop generated a new ID and broke earlier links. - **Vellum divider ornament.** A sideways fleuron replaces the diamond. ### Fixed - **Docs in Bookcase search.** The search input now filters the Docs section alongside books and folders. - **Cached books after forced sign-out.** Remote books are cleared from local storage when the auth session is invalidated externally, for example when an account is deleted or a token expires. Previously the next anonymous session showed the full prior library. ## 0.20.0: Per-link reader config ```yaml version: 0.20.0 date: 2026-05-05 tags: sharing, reading ``` Each share link now carries its own reader configuration. Two links to the same document can surface entirely different presentations: one as a prose document, another as a feed timeline. The Share dropdown becomes a compact status panel and the new Share modal handles link management and reader experience side by side. Editor mode now follows the user across books instead of resetting on switch. Reader experience configuration moves out of frontmatter (`view:` and `modes:`) and into the share link itself. ### New - **Per-link reader config.** Each share link independently controls its default view and the alternative modes a reader can switch between. - **Share modal.** Public link management and reader experience configuration in one place. Each link expands inline to a Config panel with a default-view radio and allowed-mode checkboxes. - **Compact share status panel.** The share dropdown now shows just link status and collab status with a Share button that opens the modal. - **Reader-side mode switcher.** When a share link allows alternatives, the reader view shows a tab strip to switch between the configured modes. ### Improved - **Editor mode follows the user.** Switching documents no longer resets the active mode. The mode pill drives state directly without writing to the document. ### Removed - **`view:` and `modes:` frontmatter.** Reader experience is now configured per share link, not per document. The `Configure modes/view` flow moves into the Share modal. - **Slides in share link config.** Presentation is a separate experience accessed via its dedicated `/present/` URL. Authors who want to share slides share that URL directly. ## 0.19.0: Feed navigation and authoring ```yaml version: 0.19.0 date: 2026-05-05 tags: reading, writing ``` Feed view becomes navigable: ++j++ / ++k++ or arrow keys move between entries, ++o++ or ++Enter++ expands and collapses, ++Esc++ clears focus. Filters and search sync to the URL so filtered views are shareable, and visiting an anchor scrolls directly to a deep-linked entry. A complete set of slash commands scaffolds new entries and section headings inside feed books, gated to authors with the Labs toggle on. ### New - **Keyboard navigation.** ++j++ / ++k++ or arrow keys move between entries. ++o++ or ++Enter++ expands and collapses the focused entry. ++Esc++ clears focus. Skipped when typing in an input. Focused entry marked with an accent left bar. - **URL state.** Active filters and search query sync to `?filter=` and `?q=` params. Filtered views are shareable and read back on mount. - **Deep links.** Visiting an anchor expands the visible range to include the target entry and scrolls to it after render. - **Entry count.** A muted centred line shows "N releases" or "N of M releases" when filtered. - **Animated filter transitions.** Filtering keeps all entries in the DOM. Filtered-out entries collapse and fade out; remaining entries slide naturally as the rows free up. - **Ghost search input.** Search starts transparent (icon and placeholder only) and fades in border and background on hover, focus, or content. Always-visible clear button. - **Highlights frontmatter completion.** Typing on the `highlights:` line suggests versions, ids, and announcement anchors derived from the current document. Handles comma-separated input and excludes already-used values. - **Feed slash commands.** A set of new commands inserts feed scaffolding: a full new-entry template (heading, YAML block with today's date, placeholder section), the five section headings (New, Improved, Fixed, Security, Removed), remove-entry, toggle-draft, and update-date. All gated behind the Labs toggle and predicate-aware (entry-scoped commands hide outside an entry). - **Feed shortcuts in the keyboard reference.** The shortcuts modal lists the feed navigation keys. - **Title at the top of the feed view.** The H1 is now rendered above the highlights and entries. ### Improved - **Filter active state cue.** Filter labels gain a dot shape cue, a weight shift (500 to 600), and an `aria-pressed` attribute. Active state no longer relies on colour alone, and hover doesn't override active colour. - **Filter layout.** Category filters now sit centred above the entries, separated from search. Uncategorized entries hide when any filter is deselected and reappear in the default all-active state. Active dot reserves space at all times to prevent layout shift. - **Search bar interaction.** Default to muted border, hover to accent muted, focus to full-opacity accent. Clear button fades in and out via `:has(:not(:placeholder-shown))` and respects the asymmetric timing. ### Fixed - **Read more visibility.** Moved outside the content wrapper so the glass overlay no longer covers it. - **Highlight card date alignment.** Right-aligned for clearer left-to-right reading. - **Feed keyboard navigation in the editor.** ++j++, ++k++, and arrow keys no longer trigger feed navigation when focus is in the CodeMirror editor. - **Since-last-visit banner.** Now wired through to shared books and the preview pane via the active book ID. - **Truncation clip on short entries.** Only applied when content actually overflows, measured after mount. ## 0.18.0: Feed entries and unread state ```yaml version: 0.18.0 date: 2026-05-04 tags: reading, blocks ``` Feed entries get a real metadata model: each entry carries its own YAML block with version, date, tags, and a draft flag. Entries seen since the last visit are marked with an animated New badge. Long entries truncate with a frosted glass fade to the canvas background and expand on Read more with a height transition. The highlights strip gets a typographic hierarchy pass and an eyebrow label. The feed layout widens to make room for the timeline. ### New - **YAML metadata blocks.** Each feed entry now carries a fenced `yaml` block with `version`, `date`, `tags` (comma-separated), and an optional `draft` flag. Tags appear as `#tag` in the left column and are searchable. - **Draft entries.** An explicit `draft: true` keeps an entry hidden from public views and dimmed in the editor. The new-entry template starts as a draft. - **Unread badge.** Entries seen since the last visit are marked with a shimmering New label in the title row. The shimmer reads the active accent at runtime. - **Read more expansion.** Long entries truncate at a measured height and reveal the rest with a height transition. Entries shorter than the truncation height skip the clip and hide the button. - **Frosted glass truncation fade.** A glass overlay fades into the canvas background, hiding text cleanly past the truncation point. Backdrop blur fades in via a mask gradient. - **Highlights strip eyebrow.** A small uppercase tracked label identifies the section without competing with the version anchors inside the cards. ### Improved - **Highlight cards.** Lead with the entry title (two-line clamp); version sits below in muted text. Version label promoted to the primary anchor; categories sit tight below it; date sits separately as independent metadata. Hover lifts the card with a hue-shifted shadow. Section label is now an `h3` for screen-reader outline. - **Copy link icon.** Moved to the far right of the entry title row, slightly larger, hover-reveal only. ## 0.17.0: Feed view, alpha groundwork ```yaml version: 0.17.0 date: 2026-04-29 tags: reading ``` A first take on Feed view: books composed of dated `##` sections render as a scrollable two-column timeline, with category badges and per-theme dividers. The view is gated behind a Labs toggle in the profile modal so authors opt in before it appears in their editor; readers of a shared feed book see the timeline regardless. A space-key fix in the editor lands alongside. ### New - **Feed view.** A new `view: feed` frontmatter option renders `##`-delimited sections as a dated, scrollable two-column timeline. Date anchors the left column; title, category stats, and content fill the right. - **Theme-aware entry dividers.** Vellum gets a gradient with an ornament, Manifold gets an accent tint, Folio a bold accent line, and the default theme a subtle line. - **Labs toggle.** A new Labs section in the profile modal gates feed mode in the editor. Read-only and shared books always render feed without the gate. ### Fixed - **Space key in the editor.** ++Space++ no longer triggers bookcase preview when the cursor is in the editor. The bookcase keydown handler ignores events from contenteditable surfaces. ## 0.16.0: MCP integration ```yaml version: 0.16.0 date: 2026-04-28 tags: integrations, milestone ``` A Claude tab in the profile modal generates a Fleuron API key and shows a ready-to-paste `claude mcp add` command. From Claude Code, Claude Desktop, or any MCP-compatible client, Claude can browse, read, create, and edit books in the workspace directly. Documentation is published at the MCP Integration page under Using Fleuron. ### New - **Claude tab in the profile modal.** Generates an API key on demand, displays a ready-to-paste `claude mcp add` command pointed at the user's Fleuron workspace, and supports regeneration that revokes the previous key. - **MCP Integration documentation.** New page under Using Fleuron covering connection setup for Claude Code, Claude Desktop, and other MCP clients, plus a reference for available tools, resources, and prompts. ### Fixed - **Hardcoded MCP URL in the connection command.** The generated `claude mcp add` command now points at the user's actual Fleuron domain instead of a localhost or backend URL. ## 0.15.0: Bookcase ```yaml version: 0.15.0 date: 2026-04-28 tags: organization, milestone ``` The left panel becomes the Bookcase. The folder hierarchy is now a flat tree at the root: unfiled books and folders live side by side, and folders expand inline to reveal their contents instead of opening a sub-panel. Holding ++Space++ while hovering a book row shows a preview popover anchored to the right of the bookcase, so a book's contents are visible without opening it. Books drag and drop between folders. The account row and feedback button move from the top bar and the floating corner button into the bookcase footer. A New Book button sits above Recently Opened. An accessibility, motion, and design-token audit lands alongside. ### New - **Flat-tree bookcase.** Unfiled books and folders sit at the same level. Folders expand and collapse inline with a chevron. No sub-panel navigation. - **Space and hover preview.** Holding ++Space++ while hovering a book row shows a floating popover anchored to the right of the bookcase. Slots reserved for tags, progress, and other future fields. - **Book drag and drop.** Drag a book to reorder within a folder, drop on a folder to move it in, drop on the Books header to make it Unfiled. - **Folder drag.** Drag to reorder at the same level; drop on a folder to nest it. - **Active folder highlight.** The folder containing the open book gets an accent-tinted pill background, identifiable in the tree without text-colour changes. - **New Book button in the bookcase.** Accent-coloured button above Recently Opened. Creates a book directly without needing a folder context menu. - **Account in the bookcase footer.** Avatar, email, and sign-out now live in the bookcase footer. Removed from the top bar. - **Feedback in the bookcase footer.** Replaces the floating corner button. Panel opens to the right of the bookcase. - **Inline folder delete confirmation.** "Delete folder" becomes "Confirm" on first click and executes on second. Closing the menu resets it. Opens the edit modal instead when the folder contains books. - **Toast.** Bottom-centre slide-and-fade notifications for actions like folder deletion ("X books moved to Unfiled"). ### Improved - **Folder deletion.** Deleting a folder now moves all books, including those in nested subfolders, to Unfiled. Confirmation copy reflects the recursive count. - **Accessibility.** Book and folder rows are keyboard navigable with Enter and Space activation. Edit Folder modal traps Tab and Shift+Tab focus. Global focus-visible ring on every button. Touch targets enlarged on coarse pointers. Accordion expansion uses CSS grid-template-rows with prefers-reduced-motion respected. ### Fixed - **Slide separator inside fenced code blocks.** `---` inside a triple-backtick or triple-tilde fence no longer splits the slide. The parser tracks fence open and close markers by character type and minimum length. - **Accordion section hydration mismatch.** Section open state syncs after mount instead of at module init, so server and client agree on the first render. - **Folder options menu toggle.** Repeated clicks now open and close the menu reliably. ## 0.14.0: Legal pages and self-service rights ```yaml version: 0.14.0 date: 2026-04-28 tags: compliance, sharing ``` Terms of Service and Privacy Policy land at `/terms` and `/privacy`. A new Data and Privacy tab in the profile modal lets users export all their data as a download or delete their account directly. Analytics no longer rely on cookies or local storage: they run in memory only. The Privacy Policy now states the lawful basis for each kind of processing, the retention period for each data type, and the cases where operators may review document content for moderation, abuse investigation, or technical support. ### New - **Terms of Service and Privacy Policy.** Published at `/terms` and `/privacy` as dedicated routes. Cross-linked from the landing page footer. - **Data and Privacy tab.** Profile modal section to export all user data as a download or delete the account. - **No cookies, no analytics storage.** Analytics run in memory only. No cookie consent prompt, no local storage writes. Identification on login no longer sends name or email. ### Improved - **Privacy Policy.** Lawful basis stated for each kind of processing. Retention periods listed per data type. The OAuth providers list now includes GitHub. Self-service export and account deletion are now reflected in the user rights section. A new right to correct display name was added. - **Privacy Policy: admin content review.** A new bullet under "How we use it" explicitly covers the case where operators review document content for abuse investigation, legal compliance, or technical support. - **Terms of Service.** Shared content responsibility clause and indemnification clause added. A 13+ age requirement and a HIPAA exclusion are now stated explicitly. ## 0.13.0: Keyboard, formatting, and security ```yaml version: 0.13.0 date: 2026-04-24 tags: writing, focus, collaboration ``` A keyboard shortcuts modal opens on ++F1++ with a four-column layout, mode-based sections, and hover tooltips. F-keys cover the most common actions: ++F1++ for the shortcuts reference, ++F2++ for cursor parking, ++F4++ for an X-ray quick glance held to peek. View modes cycle on ++Ctrl+.++ and ++Ctrl+,++ with a transition animation. Paragraph navigation lands on ++Ctrl+]++ and ++Ctrl+[++. Two new tools join the selection toolbar: clear formatting and a format painter that copies and applies marks across selections. The radial toolbar provides an opt-in alternative to the linear selection toolbar. Code blocks gain line annotations, and a server-side enforcement pass closes a guest write bypass. ### Line annotations Code line markers (`+`, `-`, `!`, `?`) now accept optional text between the kind char and the closing `*/`. The annotation appears as a speech bubble icon on the right edge of the line; hovering shows the full text in a tooltip. ```typescript function greet(name: string) { /*- O(n) string concat in a loop */ return "Hello, " + name /*+ Template literals are faster */ return `Hello, ${name}` } /*! Public API, do not rename */ export default greet /*? Throws if name is empty */ export function greetStrict(name: string) { ... } ``` All four marker types support annotations. Lines with a marker but no text still show the coloured band, just without the icon. Markers and annotations also work inside terminal blocks. ```bookref id: doc-code-blocks title: Code Blocks desc: Syntax highlighting, line markers, line annotations, and chrome options. share: /documentation/blocks/code-blocks ``` ### All keyboard shortcuts Every shortcut from the new ++F1++ modal, grouped the same way. **Editor: Formatting** | Action | Shortcut | | --- | --- | | Bold | ++Mod+B++ | | Italic | ++Mod+I++ | | Inline code | ++Mod+E++ | | Strikethrough | ++Mod+Shift+S++ | | Underline | ++Mod+U++ | **Editor: Editing** | Action | Shortcut | | --- | --- | | Undo / redo | ++Mod+Z++ / ++Mod+Shift+Z++ | | Find / select next occurrence | ++Mod+F++ / ++Mod+D++ | | Go to line | ++Mod+G++ | | Indent / dedent | ++Tab++ / ++Shift+Tab++ | | Semantic backspace | ++Shift+Backspace++ | **Editor: Navigation** | Action | Shortcut | | --- | --- | | Slash menu | ++/++ | | Snap preview to cursor | ++Mod+\++ | | Cursor marker | ++F2++ | | Next / previous paragraph | ++Ctrl+]++ / ++Ctrl+[++ | | Next / previous heading | ++Alt+PgDn++ / ++Alt+PgUp++ | | Next / previous table cell | ++Tab++ / ++Shift+Tab++ | **Preview** | Action | Shortcut | | --- | --- | | Sentence reader: next / previous | ++↓++ / ++↑++ | | Exit sentence reader | ++Esc++ | | X-ray quick glance | hold ++F4++ | | Feed entry: next / previous | ++j++ / ++k++ | | Feed entry: expand / clear focus | ++o++ / ++Esc++ | **General** | Action | Shortcut | | --- | --- | | Keyboard shortcuts modal | ++F1++ | | Cycle view modes (forward / back) | ++Ctrl+.++ / ++Ctrl+,++ | | Command palette | ++Mod+K++ | **Presentation** | Action | Shortcut | | --- | --- | | Next slide | ++→++ / ++↓++ / ++Space++ | | Previous slide | ++←++ / ++↑++ | | Reset timer / toggle fullscreen | ++T++ / ++F++ | **Presenter annotations** | Action | Shortcut | | --- | --- | | Laser / pen / highlight | ++L++ / ++P++ / ++H++ | | Area highlight / spotlight / blackout | ++Shift+H++ / ++S++ / ++B++ | | Disable annotation | ++Esc++ | ```bookref id: doc-editor title: The Editor desc: Inline toolbar, keyboard shortcuts, smart editing behaviours, and editor settings. share: /documentation/using-fleuron/editor ``` ### Clear formatting and format painter Two new tools in the inline toolbar that operate on a selection's marks. `Clear formatting` (eraser icon) strips all markers from the selected text. If the selection sits inside a wrapping marker (the `e` inside `**hello**`, for example), the cleanup expands outward to include both delimiters so nothing is left orphaned. `Format painter` (brush icon) is two clicks: select formatted text and click the brush to copy its marks, then select different text and click again to apply them. Existing marks on the target are replaced cleanly in a single dispatch. ```bookref id: doc-editor title: The Editor desc: Inline toolbar, formatting tools, smart editing behaviours, and keyboard shortcuts. share: /documentation/using-fleuron/editor ``` ### Radial formatting toolbar An opt-in alternative to the linear inline toolbar. When enabled, releasing a text selection brings up a circular ring of 10 formatting actions arranged around the cursor release point. The selected text stays visible through the transparent centre. The actions: bold, italic, inline code, strikethrough, underline, link, key badge, color highlight, brush, and clear formatting. The ring only appears for mouse selections (drag-to-select moves it as you drag, then locks on release; keyboard selections still use the linear toolbar). Applying a format does not move the ring, so you can pile on multiple formats without re-selecting. Enable in editor settings under Toolbar. ```bookref id: doc-editor title: The Editor desc: Inline toolbar, radial toolbar, keyboard shortcuts, and editor settings. share: /documentation/using-fleuron/editor ``` ### New - **Keyboard shortcuts modal.** Opens on ++F1++. Four-column layout with mode-based sections, hover tooltips on every entry, and a description for each shortcut. The modal is wider, focuses on open, and collapses responsively on narrow viewports. - **F-key shortcuts.** ++F1++ opens the shortcuts modal. ++F2++ parks the cursor (replaces ++Mod+.++). ++F4++ holds for an X-ray quick glance. - **Cycle view modes.** ++Ctrl+.++ and ++Ctrl+,++ cycle forward and backward through editor, split, and preview, with wrap-around and a transition animation. - **Paragraph navigation.** ++Ctrl+]++ moves to the next paragraph; ++Ctrl+[++ moves to the previous. - **Indent and dedent.** ++Tab++ and ++Shift+Tab++ indent and dedent (replaces ++Mod+]++ and ++Mod+[++). - **Clear formatting.** Strips all markers from a selection. Expands outward to include wrapping markers when only the inside content is selected. - **Format painter.** Copies marks from one selection and applies them to another in a single dispatch. Replaces existing marks cleanly. - **Radial formatting toolbar.** Opt-in donut ring with 10 formatting actions arranged around the cursor. Replaces the linear inline toolbar when enabled. Centres on mouse release position. Enable in editor settings under Toolbar. - **Line annotations.** Code line markers (`+`, `-`, `!`, `?`) accept optional annotation text between the kind char and the closing comment. A speech bubble icon appears on annotated lines; hovering shows the full text in a tooltip. ### Improved - **Excalidraw save and cancel buttons.** Now render inside the Excalidraw toolbar so they aren't covered by Excalidraw's own UI. ### Fixed - **Code line markers.** The marker overlay now uses pixel-accurate positioning measured from the rendered line height. Replaces a gradient-based approach that misaligned in some browsers. - **Multiline `` rendering.** Highlights that span multiple lines now render correctly. Remark was wrapping them as a single HTML block. - **Double-wrap on toggle.** Toggling bold or italic with the marker characters inside the selection now removes the markers instead of doubling them. Matches the existing behaviour on highlights and underlines. ### Security - **Guest edit enforcement.** Guests connect on page load with a read-only viewer token from the public book endpoint. The slot reservation and writer JWT are deferred until they click Join to Edit. Closes a server-side bypass where a guest could write without joining. ## 0.12.0: Onboarding ```yaml version: 0.12.0 date: 2026-04-24 tags: writing, milestone ``` A welcome book greets new users on first load with expectations around alpha stability and a path into the product. Two new Start Here documents (Markdown Basics and Block Reference) cover the basics and the block catalogue. The new bookref block links to other books as a card with a title, an excerpt, and a click-through. ### New - **Welcome book.** Shown on first load. Sets expectations around alpha stability and points to key features. Skipped on subsequent visits. - **Markdown Basics.** Beginner guide in the Start Here section. Covers headings, lists, links, images, and inline formatting. - **Block Reference.** Curated showcase of KPI, Terminal, REST, Mermaid, Excalidraw, and Book Embeds blocks. - **Bookref block.** Fenced `bookref` blocks render as a card with a title, an auto-extracted excerpt, and an arrow that opens the book in a new tab. Adapts to owner, viewer-with-share, and private states. Insert with `/book link` and pick from the book list. Deep links via `?open=`. ### Improved - **Onboarding document.** Now covers the command palette, callouts, Excalidraw, the formatting toolbar, X-ray with ++F4++, sharing and collaboration, and a keyboard shortcuts reference. - **View and mode persistence.** Now global per user instead of per book. ## 0.11.0: Theme styling ```yaml version: 0.11.0 date: 2026-04-22 tags: writing, blocks ``` Per-theme styling for KPI blocks, callouts, and blockquotes brings the three themes into a coherent design language. Vellum reads as editorial: frameless KPIs with hairline accents, blockquotes with absolute quote marks. Manifold reads as technical: bold accent borders, monospace labels, a unified frame across callouts and KPIs. Folio reads as presentational: slide-scale cards, ghost icons behind sparklines, larger labels. ### Improved - **Vellum KPI block.** Frameless editorial stat. An accent hairline cuts through the italic serif label, with a faded gradient terminator below. - **Manifold KPI block.** Technical readout with a thick accent left border, a monospace label, and an icon-and-label row that matches the callout pattern. - **Folio KPI block.** Slide-scale card with an accent top bar, a ghost icon behind the sparkline column, and larger value and label sizes. - **Vellum blockquote.** Absolute quote marks with a hairline gradient bottom rule, right-to-left. - **Manifold blockquote and callout unification.** Both use the same accent left border, subtle borders, and tinted background as a coherent frame. - **Folio blockquote and callout unification.** Matching subtle borders and an accent-tinted background. ## 0.10.0: Polish pass ```yaml version: 0.10.0 date: 2026-04-21 tags: sharing, focus ``` A polish pass on the share dropdown, the feedback widget, the landing sign-in button, and the auth layer. The share dropdown gains menu semantics, Escape-to-close, and consequence-tinted hovers on destructive actions. The feedback widget gets a borderless tab pattern, dynamic placeholders per type, and a textarea promoted to the dominant element. Auth sessions now refresh silently on expiry, sign-out purges remote-backed books from the device, and sign-in errors during link creation open the sign-in modal instead of throwing. ### New - **Sign-in button affordance.** The landing sign-in button gains a LogIn icon, a hover background fill, a focus ring, and an aria-label. Sits in a shared top-right container with the theme toggle. - **Feedback widget redesign.** Borderless text tabs replace bordered buttons. Placeholders change per type ("Describe what happened.", "Describe what you'd like to see.", "What's on your mind?"). Textarea is the dominant element at 5 rows; email is the secondary field. Trigger uses surface and accent colours instead of opacity to communicate state. ### Improved - **Share dropdown semantics.** Menu semantics, role attributes, and aria labels throughout. Escape closes the dropdown. Destructive actions (revoke, stop) get a rust hover tint to signal consequence. Copy actions use the Copy icon instead of Link. Spacing aligns to the design token scale. - **Auth session expiry.** Expired tokens refresh silently and retry the request. Sign-in errors during link creation open the sign-in modal instead of surfacing as an unhandled error. ### Fixed - **Sign-out privacy.** Sign-out purges remote-backed books from local storage so they aren't visible to the next user of the device. Redirects to the landing page instead of the editor. - **Drifted markdown plugins in slide and presenter renderers.** Both renderers now use the same plugin set as the preview pane. Callouts, REST blocks, line markers, and other plugins that were silently missing now apply consistently. - **Empty content on shared book pages.** Read-only and collab-static pages now populate the content store on load so the prose renders. Live collab paths sync the editor and preview together. - **Kicks and session-end on shared pages.** Both signals now expel the guest reliably. Kicks were previously ignored. - **Feedback widget on shared books.** No longer appears on `/book/*` pages. ## 0.9.0: REST block and landing hero ```yaml version: 0.9.0 date: 2026-04-20 tags: blocks, integrations ``` The REST block runs HTTP requests directly in a document. Method, URL, query parameters, headers, and body live in a structured form; the response renders inline with JSON, CSV, and plain text variants formatted automatically. Copy as cURL and Paste from cURL round-trip both ways. The landing hero gets a frosted glass CTA panel and a Threads animation that cycles through the six accent colours. ### REST block A REST block defines an HTTP request inside a document and runs it on click. Method, URL, query parameters, headers, and request body live in a structured form; the response renders inline below the request. ```rest title="Get post" GET https://jsonplaceholder.typicode.com/posts/1 Accept: application/json ``` The body uses a small subset of the HTTP file format: first line is `METHOD URL`, following lines are `Key: Value` headers (or `?key=value` / `&key=value` for query params), and anything after a blank line becomes the request body. JSON responses render as the interactive JSON tree, CSV as a sortable table, and everything else falls through preformatted. The header has Copy as cURL and Paste from cURL buttons that round-trip both directions. In a shared read-only link, the request form is disabled and Send is hidden, but a cached response stays visible. ```bookref id: doc-rest-blocks title: REST Blocks desc: Interactive HTTP request and response inline, with cURL round-trip and read-only sharing. share: /documentation/blocks/rest-blocks ``` ### New - **REST block.** Fenced `http` blocks render an interactive request form. Method dropdown, URL, params, headers, and body. Send button runs the request from the browser; response renders inline with headers in a dense key-value layout. - **Response formatting.** JSON responses use the JSON block, CSV uses the CSV block, plain text falls through to a preformatted view. - **Copy as cURL and Paste from cURL.** Round-trip the request to and from a cURL command. - **Read-only REST in shared links.** The Send button is absent in shared and reader views. Forms still display the request structure. - **Landing hero glass panel.** The New Book button, recents list, and supporting copy now sit inside a frosted glass panel that animates in as one unit. - **Threads colour cycling.** The Threads animation in the hero cycles through all six accent colours on an 8-second smooth-step interpolation. ### Improved - **Block collapse internals.** All blocks now share a single collapse mechanism through BlockShell context. Nine block components were simplified. ## 0.8.0: Auth, accents, and reader view ```yaml version: 0.8.0 date: 2026-04-18 tags: sharing, reading, integrations ``` Google sign-in alongside GitHub. A new profile modal handles name editing, tier display, and appearance settings, including six accent colour presets that retheme the entire app. The top bar gets a structural redesign: wordmark on the left, editable book title in the centre, and a reordered right region. Read-only share links decouple from collaboration: a dedicated reader view at `/book/[token]` renders shared books as full-width prose with minimal chrome and print-friendly styling. ### New - **Google OAuth.** Sign in with Google alongside the existing GitHub option. Provider selection lives in a unified sign-in modal. - **Profile modal.** Replaces the inline user menu. Account tab edits name and shows tier. Appearance tab toggles light and dark and picks an accent colour. - **Six accent colour presets.** Forest, Ocean, Plum, Rust, Ink, and the default. Setting an accent retheme the entire app and persists across sessions. - **Animated lightbulb theme toggle.** Replaces the Sun and Moon icons. Rays and coil fade out in dark mode and fade in on return. Hover previews the opposite state. - **Top bar redesign.** Wordmark on the left, replacing the Books label. Editable book title centred with a pencil affordance. Right region orders Share, presence avatars, theme toggle, and auth. - **Reader view.** Shared books open at `/book/[token]` in a full-width prose layout with minimal header, no editor chrome, and print styling. - **Read-only share links.** Independent from collaboration sessions. Create and revoke links from the share dropdown; collab sessions start and stop separately. - **Inactive view switcher cue.** View switcher icons now use stroke width 2.5 when active and 1.5 when inactive, providing a non-colour cue. ### Improved - **Per-sentence rhythm classification.** Sentence rhythm highlight now classifies each sentence relative to the paragraph mean rather than colouring all sentences by the paragraph score. ### Fixed - **Frontmatter showing in shared reader view.** Frontmatter is now stripped before rendering at `/book/[token]`. ## 0.7.0: Editor settings and X-ray modal ```yaml version: 0.7.0 date: 2026-04-17 tags: writing, focus, blocks ``` Editor settings move out of a small floating palette into a grouped modal with categories, descriptions, and looping inline previews for every animation. X-ray gets the same treatment: a modal with six categories, configurable thresholds, and a fixed example pane that previews changes live. Three new focus settings hide the gutter, idle icons, and the top bar after a few seconds without input. Four new typing animations join Letter Pop. ### Sentence rhythm highlight and X-ray config X-ray gets a config modal and a new annotation. The config moves from a tooltip menu into a modal with sidebar navigation across six sections (Rhythm, Readability, Weight, Style, Highlights, Thresholds), each with toggle descriptions and a fixed example pane that runs a second X-ray instance so every change previews live. Sentence rhythm highlight is a new annotation in the Rhythm category. It tints each sentence with its paragraph's rhythm score colour, and the dominant sentence (the one disproportionately longer than its neighbours) gets a stronger orange tint. Classification is per sentence, so adding or editing one sentence no longer recolours the others. The Thresholds section makes the preset's numeric defaults editable: reading speed, light and heavy paragraph word counts, and readability grade bands. Overrides persist alongside the active preset (General, Technical, Slides). ```bookref id: doc-xray title: X-ray Overlay desc: Live readability, rhythm, weight, and style annotations on the preview prose. share: /documentation/using-fleuron/xray ``` ### Letter typing animations Four new typing animations join Letter Pop. Each animates only single-character insertions (paste and multi-character completions stay static), and each is independently toggleable. - **Letter Fade.** Each typed character starts transparent and fades in. - **Letter Slide.** Each character drops in from a few pixels above as it fades to opaque, with a smooth ease-out. - **Letter Blur.** Each character starts blurred and transparent, sharpening to focus. - **Letter Flash.** Each character appears in the accent color at a slightly larger scale, settling to its normal color and size. ```bookref id: doc-editor title: The Editor desc: Typing animations, smart editing behaviours, and editor settings. share: /documentation/using-fleuron/editor ``` ### Content Backspace and Semantic Backspace Two backspace behaviours that work together when the cursor sits right after a closing span delimiter (`**`, `*`, `~~`, `` ` ``, ``). `Content Backspace` keeps the formatting and deletes content inside the span. ++Backspace++ from `**hello**|` goes to `**hell**|`, then `**hel**|`, leaving the markers intact. Default on. | Format | Before | After | | --- | --- | --- | | Bold | `**hello**` | `**hell**` | | Italic | `*hello*` | `*hell*` | | Strikethrough | `~~hello~~` | `~~hell~~` | | Inline code | `` `hello` `` | `` `hell` `` | `Semantic Backspace` strips the formatting and keeps the content. ++Shift+Backspace++ from `**hello**|` goes to `*hello*|`, then `hello|` on a second press. Single-character delimiters (italic, inline code, underline) clear in one press. ```bookref id: doc-editor title: The Editor desc: Smart editing behaviours, formatting shortcuts, and editor settings. share: /documentation/using-fleuron/editor ``` ### New - **Editor settings modal.** Grouped under Display, Focus, Animations, and Editing. Every setting has a description; every animation and behaviour has a looping inline preview. - **X-ray config modal.** Sidebar navigation across Rhythm, Readability, Weight, Style, Highlights, and Thresholds. A fixed example section at the bottom runs a second X-ray instance so every change previews live. - **X-ray thresholds.** Per-preset numeric defaults for reading speed, light and heavy word counts, and readability grade bands are now editable. Overrides persist alongside preset selection. - **Sentence rhythm highlight.** Tints every sentence in the prose with the paragraph's rhythm score colour. The dominant sentence receives a stronger orange tint to stand out. Per-sentence classification means adding an unrelated sentence no longer changes the colour of others. - **Hide line numbers.** Collapses the editor gutter with a max-width slide animation. Available from the settings modal and command palette. - **Hide idle icons.** Preview icon buttons, the editor config button, and the prose/slides switcher fade out after 2.5 seconds of inactivity. - **Hide idle header.** The top bar slides up after 2.5 seconds of inactivity. It restores when the cursor moves within 64px of the top. - **Letter Fade, Slide, Blur, and Flash.** Four new typing animations alongside Letter Pop. Toggleable per setting. - **Content Backspace and Semantic Backspace.** Backspace now deletes content inside span markers; ++Shift+Backspace++ strips marker layers. Previously a single feature. ### Fixed - **Selection toolbar.** Now appears reliably on double-click, ++Shift+Arrow++, and ++Shift+Click++. The toolbar previously opened in state but never became visible. - **Blank documentation pages in production.** Direct hits to documentation URLs no longer load with the editor surface hidden. - **Guest connection on shared books.** Guests now see a static snapshot on page load and only open a WebSocket when they click Join to Edit. Prevents a blank screen during the connection handshake. ## 0.6.0: Motion polish and contextual commands ```yaml version: 0.6.0 date: 2026-04-17 tags: writing, blocks, focus ``` A motion polish pass on top of 0.5.0: hero animations on the landing page, scale-and-fade on the selection toolbar, directional slide animation in the carousel, count-up on KPIs, and a crossfade when switching books. Slash commands now distinguish between fence opener and fence body, so chrome commands appear on the opener line and content commands appear inside. Save failures surface to the UI for the first time. ### New - **Hero entry animation.** The landing page wordmark, tagline, CTA, and recent books rise into place in a staggered sequence. A warm radial glow sits behind the wordmark. - **Rotating tagline.** Two pills cycle through word pools at different intervals to vary the headline. - **Landing dark mode toggle.** Theme toggle button in the top right of the landing page, available without signing in. - **New Book button lift.** Subtle shadow and lift on hover. - **Scroll-revealed sections.** Below-the-fold landing sections fade in as they enter the viewport. - **Selection toolbar animation.** Scale-and-fade in on appear; fade out on dismiss instead of cutting. - **Mermaid SVG fade-in.** Diagrams fade in after render instead of appearing instantly. - **Slide carousel direction.** Advancing and retreating slides animate in the matching direction. - **KPI count-up.** Numeric values count up when the card scrolls into view. - **Book switch crossfade.** Switching books crossfades instead of sliding. - **Hover preloader.** Hovering a book in the left panel or the landing page recents prefetches the editor route and warms cloud data so the editor is ready instantly on click. ### Improved - **Contextual slash commands.** Slash commands now distinguish opener lines from fence body lines. Chrome commands (collapse, width, align, caption, title, line numbers, hide chrome) appear on the opener; content commands (KPI fields, book id and mode, terminal `$ ` and `# ` lines) appear inside the body. KaTeX is in every applicable chrome menu. Books, KPI, and Terminal commands list before fence and language commands. ### Fixed - **Save failures surfaced.** Local storage quota errors and cloud sync failures now show the error icon on the save indicator instead of falsely reporting saved. ## 0.5.0: Inline Formatting, Left Panel, and Motion ```yaml version: 0.5.0 date: 2026-04-14 tags: writing, blocks, organization ``` A big release on three beats. New inline formatting (color highlights, accent underlines, attributed blockquotes, video embeds, theme-aware horizontal rules), a left panel rebuilt as a rich sidebar with folders, and a motion pass across the editor: blocks reveal on scroll, tables stagger row by row, prose fades in, view switches slide, and theme toggles crossfade. Callouts, math, find and replace, and a fixed-corner save indicator all land in the same build. ### Video embeds The same `![alt](url)` image syntax embeds a video when the URL points to YouTube, Vimeo, or a direct video file. The video renders inline at the document width, and the title slot becomes a caption. ![Launch demo](https://www.youtube.com/watch?v=dQw4w9WgXcQ "Sprint walkthrough, April 2026") YouTube and Vimeo render as a responsive iframe player; direct files use the native player. In conceal mode, YouTube links display the thumbnail with a play overlay and Vimeo links show a ▶ Vimeo badge. ```bookref id: doc-editor title: The Editor desc: Inline formatting, blockquote attribution, video embeds, and the inline toolbar. share: /documentation/using-fleuron/editor ``` ### LaTeX block KaTeX fences typeset LaTeX as full display-mode equations: centered, larger operators, no fallback to images. The whole fence body is treated as a single expression. ```katex \sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6} ``` Properties on the fence line set a `caption`, `collapsed` start state, `hide-chrome`, or `width=` for side-by-side blocks. Invalid LaTeX is replaced with the parser's error message in place of the equation; the raw source stays in the fence so it can be corrected. ```bookref id: doc-katex-blocks title: KaTeX Blocks desc: LaTeX math typeset in display mode with caption, collapse, and width options. share: /documentation/blocks/katex-blocks ``` ### Blockquote attribution and callouts Two extensions on top of standard markdown blockquotes. A nested `>>` line at the end of a quote becomes an attribution, styled per theme. The GitHub alert syntax (`> [!TYPE]`) renders as one of seven typed callouts: note, info, tip, warning, caution, danger, important. > The most dangerous phrase in the language is "we've always done it this way." > >> Grace Hopper > [!WARNING] > This action deletes all existing records and cannot be undone. Make sure you have a backup before continuing. Each callout has its own slash command, and typing `/` inside an existing callout opens a switcher that swaps the type without touching the content. Vellum treats blockquotes as pull-quotes with a decorative opening mark; Folio uses a thick accent left bar with editorial type; Manifold stays technical and restrained. ```bookref id: doc-callout-blocks title: Callout Blocks desc: Seven typed callouts (note, info, tip, warning, caution, danger, important) with theme-specific styling. share: /documentation/blocks/callout-blocks ``` ### Color highlights and accent underline Two inline formats beyond standard markdown. Highlighted text uses `` with four colors: yellow, green, blue, and pink. Accent-colored underlines use `...` and pick up the document's active accent. The inline toolbar has a color circle for highlights (clicking applies yellow immediately and opens a picker for the others) and an underline button. Underline also responds to ++Mod+U++. Both survive conceal mode: highlights show their color without the surrounding markup, and underlines remain styled as inline elements. ```bookref id: doc-editor title: The Editor desc: Inline formatting, highlights, underlines, video embeds, and the inline toolbar. share: /documentation/using-fleuron/editor ``` ### Hide chrome and block collapse `hide-chrome` hides a block's header and border by default; both reveal on hover. Use it when the block content should stand on its own. ```json hide-chrome { "status": "ok", "region": "eu-west-1" } ``` `collapsed` renders the block with only the header visible. Clicking the chevron expands it. Heading sections collapse too: click the gutter next to a heading to fold everything below it. All collapse and expand transitions animate height smoothly instead of snapping. ```javascript collapsed=true function greet(name) { return `Hello, ${name}` } ``` `hide-chrome` applies to code, JSON, CSV, XML, Mermaid, KaTeX, Excalidraw, and book blocks. `collapsed` applies to every block type plus heading sections. ```bookref id: doc-block-properties title: Block Properties desc: title, caption, collapsed, width, align, max-lines, line-numbers, and hide-chrome. share: /documentation/blocks/block-properties ``` ### New - **Color highlights.** Yellow, green, blue, and pink via `` syntax. Swatch in the inline toolbar; conceal mode shows the color without the markup. - **Accent underline.** `...` renders as accent-colored underlined text. ++Mod+U++ shortcut, selection-toolbar button, and conceal-mode preview. - **Blockquote attribution.** A nested `>>` blockquote at the end of a quote becomes an attribution line styled per theme. - **Callout blocks.** Seven types: note, info, tip, warning, caution, danger, important. Each theme renders them differently. Slash commands insert all seven; typing `/` inside an existing callout switches the type. - **KaTeX block.** Fenced `katex` blocks render LaTeX in display mode. Supports collapse, hide-chrome, caption, and width. - **Find and replace.** ++Ctrl+F++ to find, ++Ctrl+H++ to replace. ++Ctrl+D++ selects the next occurrence of the selected text for multi-cursor editing. All occurrences of the current selection are highlighted as a guide. - **Video embeds.** `![alt](url)` embeds YouTube, Vimeo, and direct video files. Captions work via the title slot. Conceal mode shows a thumbnail with a play overlay. - **Image preview in conceal mode.** Images render inline (up to 512×512) when the cursor is off the line. Raw markdown returns when the cursor enters the line. - **Left panel redesign.** Rich rows with title, two-line preview, and relative date. Hover context menu for rename, duplicate, move, and delete. Inline search. - **Folders.** Create folders, drag books between them, collapse and expand, and see the count when collapsed. Folders sync to the cloud. - **Docs accordion.** Documentation sections with icons and active state, persisted open/closed across sessions. - **Theme-specific horizontal rules.** Vellum gets a gradient line with a centered ✦ ornament. Manifold gets a thin accent line at low opacity. Folio gets a bold solid accent line. - **Hide chrome.** A block property that hides the header and border by default; both reveal on hover. Available on code, JSON, CSV, XML, Mermaid, Excalidraw, KaTeX, and book blocks. - **Save indicator.** Fixed bottom-right icon. Spinner while saving, checkmark on success, fade out. Replaces the inline text in the top bar. - **Block scroll reveal.** Blocks slide in from the left when 10% of the block enters the viewport. Once per block. - **Image and terminal scroll reveal.** Images, figures, and terminal blocks use the same reveal pattern. - **Staggered table rows.** Each row slides in from the left when the table scrolls into view. Rows cascade with the header first, up to 15 body rows. - **Prose fade-in.** Paragraphs, headings, and lists fade in when the preview pane mounts. - **View transition.** Switching between editor, split, and preview slides in the new view. Crossfades on book switch. - **Theme crossfade.** Toggling light and dark mode fades background, text, and borders smoothly instead of cutting. - **Block collapse animation.** All blocks animate height smoothly when collapsing and expanding. Heading sections too. - **Command palette and image lightbox open animations.** Backdrop fades in; panel scales up with a slight overshoot. - **Terminal collapse animation.** Smooth height transition. ### Improved - **Dark mode editor colors.** Syntax tokens now read correctly in both light and dark mode. - **Heading inline formatting.** Bold, italic, marks, and underlines all apply inside headings. - **Landing page.** Live block carousel replaces static mockups; surfaces triptych shows the three themes side by side. - **Sign-out reliability.** Signing out reloads the local book list immediately instead of waiting for the next sync. - **Book title in left panel.** Title and preview strip inline markup. Edits in the top bar reflect in the panel immediately, including for documents without an H1. ### Fixed - **Plain and nested fenced code blocks.** Plain fences (no language) now render as blocks. Nested fences in conceal mode track their opening marker correctly. Use 4-backtick outer fences to nest. - **Captioned and video image hydration.** Single-image paragraphs unwrap their `

` reliably, including for captioned and video variants. - **Conceal mode image titles.** Image src no longer captures the title portion of the markdown. - **DELETE proxy requests.** No longer send a body, which was producing spurious 503 errors. - **Book resurrection.** Deleting a book while the cloud was unreachable no longer brings it back on the next sync. A tombstone list flushes the delete when the cloud returns. - **Folder deletion.** Moves contained books to Unfiled instead of the bin. - **View and mode lost on refresh.** The active view (editor, split, preview) and document mode now persist correctly across refreshes, even when a sync is in flight or a book predates the field. - **No layout flash on slow loads.** The editor renders no layout at all until the saved view and mode are read. On fast loads this is invisible; on slow loads the canvas is blank instead of showing the wrong layout briefly. - **Stale local content overwriting remote.** After a refresh, local and remote content reconcile by timestamp: remote wins if newer, local pushes back to the cloud if a previous save was interrupted. - **Invisible text in slides.** Prose, callouts, highlights, and underlines now render correctly in slide and presenter views. Blocks no longer stay invisible inside scaled slide containers. - **Hydration mismatch on first paint.** Books, folders, and active book ID no longer cause a hydration mismatch between server and client render. ## 0.4.0: Live Collaboration ```yaml version: 0.4.0 date: 2026-04-13 tags: collaboration, sharing ``` Real-time co-editing with per-user cursors and presence. GitHub OAuth and cloud-backed books shipped alongside. Guests arrive read-only and can request edit access; on refresh, their slot is reclaimed automatically. ### New - **Real-time co-editing.** Multiple users can edit simultaneously with per-user cursors and presence. - **GitHub OAuth.** Sign in and books sync to the cloud. - **Guest join flow.** Read-only on arrival. Join to Edit reserves a slot and connects as a writer. - **Presence avatars.** Top bar shows who is currently viewing or editing. - **Share dropdown.** Choose read-only or collaborative when sharing. An active-mode badge and stop button surface alongside. - **Mermaid lightbox.** Expand any Mermaid diagram to full screen. ### Improved - **Reconnecting after a refresh.** Guest slot tokens persist across page reloads. No re-join required. ### Fixed - **Save indicator.** No longer gets stuck when a book is not found or switched mid-save. - **Ephemeral books on auth.** Books created before the first cloud sync are no longer wiped when the sync resolves. - **Anonymous book persistence.** Anonymous books now persist to local storage instead of memory. - **Sign-out with active session.** Signing out from a book page closes the collaboration session cleanly. - **Awareness avatars for guests.** Guests now see who else is in the document. - **Owner content seeding.** Starting a collaboration session no longer blanks the document for the owner. - **Join banner overlay.** Loading overlay clears reliably for collaborative books with empty initial content. ### Security - **API proxy.** All API traffic now routes through the application's own proxy. The backend service is never exposed directly to the browser. ## 0.3.0: Advanced Blocks and Presenter ```yaml version: 0.3.0 date: 2026-04-08 tags: blocks, presenting ``` Six new block types and a full-screen presenter console with notation markers, hidden slides, and per-slide notes. Block captions, width, and alignment are configurable. The X-ray readability overlay scores prose for word frequency, sentence rhythm, and grade level. ### Terminal block Shell sessions render as a styled terminal window with colored prompts and distinct output formatting. Use them in runbooks, deploy guides, and setup instructions. ```terminal title="Deploy" $ git pull origin main Already up to date. $ npm run build ✓ Compiled successfully in 4.2s $ pm2 restart app [PM2] Restarting process... [PM2] Done ``` Three line prefixes drive the rendering: `$ ` marks a command (bright text, accent-colored prompt), `# ` marks a comment (dimmed and italic), and unprefixed lines render as output (muted grey). Properties on the fence line set a `title`, `caption`, `cursor=off` for completed sessions, `theme=alternate` for a blue scheme, or `collapsed` to start folded. ```bookref id: doc-terminal-blocks title: Terminal Blocks desc: Shell sessions rendered with prompts, comments, and output styling. share: /documentation/blocks/terminal-blocks ``` ### CSV and XML viewers Both fences render as interactive viewers instead of plain text. CSV becomes a sortable, searchable table; XML becomes a navigable tree with collapsible nodes. Both copy as styled images for sharing in chat or slides. ```csv title="Q1 results" Region,Revenue,Growth North,1.2M,+8% South,0.9M,+3% East,1.5M,+12% West,1.1M,+5% ``` ```xml title="config.xml" ``` Click a CSV column header to sort (numeric columns sort by value; click again to reverse, a third time to clear). Click any XML row to collapse its children. The search box in either block filters in place: rows in CSV, nodes in XML. Paste-from-clipboard shows replacement content as a temporary preview without modifying the source. Both accept `title`, `caption`, `collapsed`, and `max-lines`; XML also accepts `line-numbers`. ```bookref id: doc-csv-blocks title: CSV Blocks desc: Sortable, searchable, paste-aware tables rendered from a CSV fence. share: /documentation/blocks/csv-blocks ``` ```bookref id: doc-xml-blocks title: XML Blocks desc: Tree viewer with collapsible nodes, attribute search, and paste preview. share: /documentation/blocks/xml-blocks ``` ### Book block Embed another book's content inline, or render it as an interactive slide carousel. Compose runbooks from reusable parts: reference a system overview from an incident response doc, or pull a shared procedure into multiple books. ```book id: doc-editor ``` Two modes: `prose` (default) flows the embedded content as inline text; `mode: slide` renders it as a 16:9 carousel with prev/next navigation. The header has buttons to open the source book in a new tab or copy its raw markdown. Embeds are limited to two levels deep, and circular references are blocked. ```bookref id: doc-book-blocks title: Book Embeds desc: Embed another book inline as prose or as a slide carousel. share: /documentation/blocks/book-blocks ``` ### Block captions Optional text below the block that adds context, source attribution, or a one-line description without crowding the body. ```javascript title="debounce.js" caption="Delays invoking fn until after delay ms have elapsed since the last call." function debounce(fn, delay) { let timer return function (...args) { clearTimeout(timer) timer = setTimeout(() => fn.apply(this, args), delay) } } ``` The caption renders in small italic text, centered under the block. It applies to every block type, including images: standard markdown title syntax (the quoted text after the URL) becomes the image's caption. ```bookref id: doc-block-properties title: Block Properties desc: title, caption, collapsed, width, align, max-lines, line-numbers, and hide-chrome. share: /documentation/blocks/block-properties ``` ### Block width and alignment Place blocks side by side in a flex row, or shift a single block left, right, or center. ```json width=1/2 title="Request" { "method": "POST", "path": "/api/deploy" } ``` ```json width=1/2 title="Response" { "status": 200, "message": "Deployed." } ``` Set `width` to `1/2`, `1/3`, or `1/4` and consecutive fractional blocks group automatically into a row. Mixed fractions work: a `1/2` next to a `1/4` and another `1/4` fills the row exactly. The `align` property (`left`, `center`, `right`) controls the row's horizontal placement and inherits from the first block in the row. ```bookref id: doc-block-properties title: Block Properties desc: title, caption, collapsed, width, align, max-lines, line-numbers, and hide-chrome. share: /documentation/blocks/block-properties ``` ### New - **X-ray overlay.** Readability scoring, word frequency, sentence rhythm, and grade level per paragraph. - **Terminal block.** Read-only output display with line markers and hover annotations. - **CSV block.** Sortable, column-filterable table from a CSV fence. - **XML block.** Syntax-colored XML tree. - **Book block.** Embed a reference to another book inline. - **Footnotes.** Inline footnote syntax with reference-style anchors. - **Color rendering.** Hex and named colors render as inline swatches. - **Block captions.** Optional caption below any block. - **Block width and alignment.** Configurable per block. - **Copy as image.** Export any block as a PNG. - **Presenter console.** Full-screen view with notation markers, hidden speaker notes, and slide reordering. - **Hidden slides.** Mark a slide as hidden. Notes persist across reopens. - **Notation markers.** Author markers visible only in presenter mode. - **Split slide view.** Edit the source and see slides side by side. - **Slide reordering.** Drag slides to reorder them in the editor. - **Reopen presentation window.** Button to rejoin the audience window after closing it. - **Font size, word wrap, and jump to line.** Editor preferences for long documents. ### Improved - **Slash commands for language blocks.** Simpler entry points for code, JSON, CSV, XML, and similar blocks. - **KPI block.** Counts up when scrolled into view. ### Fixed - **Table of contents.** A nesting bug that misordered headings. ## 0.2.0: Writing Modes ```yaml version: 0.2.0 date: 2026-04-03 tags: writing, focus ``` Four ways to write without distraction landed in one build. A command palette and a KPI block shipped alongside. ### KPI block A compact card for a number that needs to stand out: value, optional sparkline, delta badge, and a period label. Stack several side by side for a dashboard row. ```kpi - label: Revenue | value: $1.2M | accent: forest | icon: TrendingUp | trend: 980000, 1050000, 1120000, 1200000 | trend-good: up | period: Q1 2026 - label: Active users | value: 14.3K | accent: ocean | icon: Users | trend: 12000, 12800, 13500, 14300 | trend-good: up | period: This week - label: Avg response | value: 42ms | accent: ink | icon: Zap | trend: 68, 55, 49, 42 | trend-good: down | period: 7-day avg ``` The block has seven optional fields: `label`, `value`, `accent`, `icon`, `trend`, `trend-good`, and `period`. Two formats: a single card uses one field per line; the multi-KPI form (shown above) puts each card on a `-` line with `|` separators. Pass two or more numbers to `trend` and the delta is computed automatically. `trend-good: down` flips the color logic for metrics where lower is better, like response time, error rate, or cost. ```bookref id: doc-kpi-blocks title: KPI Blocks desc: Compact metric cards with value, sparkline, delta badge, and accent color. share: /documentation/blocks/kpi-blocks ``` ### New - **Conceal mode.** Collapses markdown syntax to clean prose while editing. - **Typewriter mode.** Keeps the active line vertically centered as you type. - **Sentence reader.** Dims everything except the sentence the cursor is in. - **Cursor parking.** Press ++F2++ to plant a return marker; press again to teleport back. - **Command palette.** ++Cmd+K++ / ++Ctrl+K++ global search and command overlay. - **Letter pop.** Subtle character animation as you type. - **KPI block.** Large number with label, delta direction, and optional sparkline. - **Reading bookmark.** Marks where you left off in long documents. ### Improved - **Table formatting.** Better editor-side alignment handling. ### Fixed - **Snap to preview.** Preview pane no longer jumps unexpectedly when scrolling. ## 0.1.0: Core Editor ```yaml version: 0.1.0 date: 2026-04-01 tags: writing, milestone ``` Initial release. Live preview, three document themes, slide presentation, drawings, and persistence. No account required. ### Excalidraw drawings Drawings live inside the document, not in a separate tool. Click **Edit** to open a full-screen canvas, then save back to the source. ```excalidraw id=initial-release {} ``` Fence properties set a `title`, `caption`, `theme`, initial `zoom`, or `zen=true` for a Excalidraw chrome-free preview. ```bookref id: doc-excalidraw-blocks title: Excalidraw Drawings desc: Interactive drawings stored inline as JSON, edited in a full-screen modal. share: /documentation/blocks/excalidraw-blocks ``` ### JSON viewer JSON fences render as a navigable tree, not a flat code block. Click any object or array row to collapse it; type in the search box to filter by key or value. ```json { "name": "runbook", "version": "1.0.0", "dependencies": { "next": "^15.0.0", "react": "^19.0.0" }, "scripts": { "dev": "next dev", "build": "next build" } } ``` The header buttons collapse or expand the whole tree, paste JSON from the clipboard for a preview without modifying the source, and copy the content as a styled image. ```bookref id: doc-json-blocks title: JSON Blocks desc: Interactive tree viewer with collapse, search, paste preview, and image copy. share: /documentation/blocks/json-blocks ``` ### Smart editing Five small behaviours that activate as you type. Three are toggleable from the editor settings panel. - **Ghost Delete.** Deleted text lingers as a faded strikethrough for a moment before clearing, giving you a chance to catch a mis-aimed backspace. - **Park Cursor.** ++F2++ drops a marker at the cursor's position; press it again from anywhere in the document to jump back. Lets you check another section without losing your spot. - **Semantic Backspace.** ++Shift+Backspace++ right after a closing span delimiter strips one marker layer. `**hello**` becomes `*hello*`, then `hello` on a second press. Single-character delimiters (italic, inline code, underline) clear in one. - **Sentence Pulse.** Typing a space or newline after `.`, `?`, or `!` briefly highlights the completed sentence and fades. - **Smart Paste.** Pasted URLs become embedded links; pasted images drop in ready to use. ```bookref id: doc-editor title: The Editor desc: Smart editing behaviours, formatting shortcuts, and editor settings. share: /documentation/using-fleuron/editor ``` ### New - **Markdown editor.** Live split preview with a draggable divider between editor and preview. - **Three document themes.** Vellum, Manifold, and Folio. Set via `theme:` frontmatter or the Config palette. - **Slide presentation.** `---` separators split the document into slides. - **Excalidraw block.** Drawings stored inline as JSON. - **JSON block.** Syntax-highlighted tree. - **Collapsible heading sections.** Click the heading gutter to collapse any section. - **Table of contents.** On-demand floating panel with section navigation. - **Local persistence.** Books saved to the browser. No account required. - **Editor QoL pack.** Ghost Delete, Park Cursor, Semantic Backspace, Sentence Pulse, Smart Paste.