What's Change

• Configurable hue-rotate speed — Introduced --rtm-hue-rotate-duration to control how fast the hue-rotate animation cycles. The hue-rotate toggle and its new duration setting are now grouped under a dedicated collapsible heading in Style Manager. #43

• Smarter embed heights — Note, Bases, PDF, and query embeds now default to auto height, sizing to their content rather than a fixed value. Embed title display controls have been moved under the embed block container section for better organization. #42

• Draw-in-Canvas palette styling — The Draw-in-Canvas plugin color disc/palette now has full Retroma styling. Its buttons are excluded from theme input rules, and the embed content shadow is cleared in simple-embed mode.

🐛 Bug Fixes

• Bases table active cell — Active cells in Bases tables now correctly use the paper background color.
• Canvas: Bases embeds & search bar — Bases embeds inside Canvas are now excluded from the height rule, and the Canvas search bar is properly offset. #42
• Workspace-leaf corner shape — Corner shape is now correctly applied to workspace leaves; search match radius is also softened for consistency.
• Code block borders — Border width and color are now set alongside the outline style so code blocks render correctly regardless of the chosen outline setting.
• Footnote size variable — Added the missing --rtm-footnote-size variable so footnote text size is actually controllable.
• Slider fill background — Slider tracks now display their fill background correctly; the cp_format button is excluded from input styling to prevent visual conflicts.

🔧 Internal

• Dropped unnecessary !important flags from embed/overlay hide rules, keeping specificity clean.

Note: Retroma callouts and alternative checkboxes require the Style Manager plugin to be installed and active.

Full Changelog: 3.1.0...3.1.1

What's Changed

Corner Shape System

A global corner-shape design token is now available across nearly every UI surface in the theme. You can choose from round, bevel, notch, squircle, and the new scoop option to apply a consistent geometric language throughout your workspace.

• Corner-shape options added for buttons, tabs, panes, view headers, nav folders, metadata containers, and search result containers
• Corner-shape extended to menus, blockquotes, callouts, code blocks, inline code, embeds, and PDF containers
• Corner-shape support added to prompt and modal popups
• Scoop corner shape option added and button corner now applies to text inputs as well

Active Tab Styles & Outlines #41

Tabs received a significant visual overhaul with several new customizable states.

• Selectable active tab styles introduced with corner-shape support
• 3D tab styling added with a refined active tab outline
• Active tab outline style setting added with unified focus outlines across the UI
• Per-state tab text colors (active, inactive, focused) now configurable
• Active and inactive tab font-family options added

Embed Settings

Embeds now have a dedicated set of style settings covering sizing, visibility, and layout.

• Embed width, max-height, and alignment style settings added
• Configurable bases embed width and height settings added
• Embed title, simple embed, and PDF/query sizing settings added
• Show, show-on-hover, and hide class-select options added for embed titles and links
• Embed/menu/popover borders decomposed into individual style variables

Alternative Checkboxes #39

• Pull-request checkbox types added: [D] Draft, [P] Open, and [M] Merged
• Alternative-checkbox (ACB) colors now derived from LCH lightness and chroma theme variables for better palette integration

Simple Menu

A new Simple Menu toggle strips away the bordered, 3D-styled look from context menu items, replacing it with a flat, minimal appearance.

• Simple menu toggle added that removes borders, box-shadows, and background from tappable menu items
• Menu border variables decomposed into individual border-width, border-style, and border-color tokens
• Menu border settings separated from the shared workspace secondary-outline group into their own controls

Workspace & Pane Settings

• Workspace style settings reorganized into dedicated Pane, Pane Header, and Pane Outline sections
• Editor overlay pattern refined and add a new crosshatch option #40

Per-Note Accent Colors & Color Schemes

Notes can now carry their own accent color and color scheme via Obsidian's cssclasses property, overriding the global theme accent on the active leaf without touching any settings.

Accent color classes — add one of these to a note's cssclasses to pin its accent:

• rtm-accent-red, rtm-accent-orange, rtm-accent-yellow, rtm-accent-green
• rtm-accent-blue, rtm-accent-indigo, rtm-accent-violet, rtm-accent-purple
• rtm-accent-vermillion, rtm-accent-amber, rtm-accent-lime, rtm-accent-teal
• rtm-accent-magenta, rtm-accent-rose, rtm-accent-cyan, rtm-accent-gray

Color scheme classes — override the primary/secondary accent rotation for a note:

• rtm-analogous / rtm-analogous-flipped
• rtm-split-complementary / rtm-split-complementary-flipped
• rtm-triadic / rtm-triadic-flipped
• rtm-monochromatic / rtm-monochromatic-flipped

Style Manager Integration

• Style Manager CSS editor view now supported
• CSS source formatting cleaned up

Style Settings Changes

The following style settings were added, reorganized, or removed in this release.

Added Settings

• Corner Shape — Global corner-shape selector (round / bevel / notch / squircle / scoop) applied per component group: buttons, tabs, panes, menus, callouts, blockquotes, code, embeds, modals
• Tab Fonts — Separate font-family pickers for active and inactive tabs
• Tab Text Colors — Per-state (active / inactive / focused) text color controls
• Active Tab Outline — Outline style, width, and color for the active tab indicator
• 3D Tab Offset Factors — Extracted as individual variables for fine-grained 3D depth control
• Button Corner on Inputs — Button corner-shape now applies to text inputs
• Embed Width & Alignment — Width, max-height, and horizontal alignment for note and query embeds
• Bases Embed Width & Height — Separate width and height controls for Bases embeds
• Embed Title Visibility — Class-select (show / show-on-hover / hide) for note embed titles and embed links
• Embed/Menu/Popover Borders — Individual border style variables (border-width, border-style, border-color) for each surface type, separated from the shared workspace outline group
• Simple Menu — Toggle to flatten mobile context menu items; removes borders, shadows, and backgrounds from tappable items
• Menu Outline Style / Thickness / Color — Dedicated controls for menu border, split from the workspace secondary-outline settings
• Editor Overlay Pattern — Pattern style selector including the new crosshatch option
• Background Color Overrides — New background-color variables for pane and header surfaces
• Per-Note Accent Colors — 16 rtm-accent-* cssclasses to override the active note's accent color (red, orange, yellow, green, blue, indigo, violet, purple, vermillion, amber, lime, teal, magenta, rose, cyan, gray)
• Per-Note Color Schemes — 8 rtm-* cssclasses to set a note's color scheme rotation (analogous, split-complementary, triadic, monochromatic — each with a flipped variant)

Reorganized Settings

• Workspace settings restructured into Pane, Pane Header, and Pane Outline sub-sections
• Code and embed settings split into dedicated, clearly named sections
• Button 3D offset factors extracted from a single value into individual per-axis variables

Removed Settings

• Markdown Editor Font Size — Removed as it conflicted with native Obsidian font-size shortcut (Ctrl + middle scroll) #35

Bug Fixes

• 72460d9 — Corrected the bases-embed-height CSS variable reference and added missing setting descriptions
• 5ba0cc0 — Kept icons colored on the mobile navbar longpress menu
• b4cfd0b — Set footnote border-radius variable to zero to prevent unintended rounding
• 9dea77c — Tuned dark-mode accent color, default radii, and embed/popover sizing defaults
• 357558d — Reduced pane inner spacing and moved button outline width to the :root scope
• 1abdc0a — Unset PDF container min-width and excluded embedded PDFs from phone layout rules
• fee65a0 — Reworked mobile spacing, view gaps, and PDF sidebar styling
• d9e3ee3 — Rounded footnote items correctly while in editing mode
• 052f545 — Allowed horizontal overflow in callout content to prevent clipping
• 70f1264 — Scoped input styling to metadata properties and unified pill padding
• a4253b3 — Used tab outline color for the active button-tab border
• 4e0ad76 — Preserved sidebar tab spacing when lower icon group is hidden
• 8f02cd0 — Made the canvas floating UI fade-out delay accept free number input
• 71db86c — Scoped mobile navbar visibility to the active canvas leaf only
• 74666f0 — Raised specificity of style-setting classes by prefixing with body
• 40e1dfe — Scoped mobile sidebar width rule to phones to avoid affecting tablets #36

Refactors & Internal Changes

• Button 3D offset factors extracted into dedicated CSS variables
• Tag selectors grouped with :is() and redundant hover rule removed
• Redundant markdown editor font size style setting removed #35

New Contributors

• @RuleOfSix made their first contribution in #37 : Fixed Bases card view not being centered on desktop by accounting for scrollbar gutter width on both sides

Full Changelog: 3.0.0...3.1.0

v3.0.0 is the largest and most significant update to Retroma since its first release. The theme has been completely reconstructed - not just visually, but architecturally. The CSS token system, the customization schema, the 3D button engine, the workspace layout model, and virtually every component have been rewritten from scratch to be more robust, more flexible, and significantly easier to maintain and extend going forward. This update fixes style and color inconsistencies, and the theme now fully adapts to whichever color accents you are using.

🔴 Why This Update Breaks Things

The previous architecture had a fundamental problem: Obsidian's own CSS variables were being overridden directly in :root, .theme-light, and .theme-dark, making it impossible to cleanly separate the theme's logic from Obsidian's internals. This led to cascading conflicts, unpredictable specificity issues, and increasingly messy patches to keep things working.

v3.0.0 introduces a dedicated rtm- token namespace. All of Retroma's internal design tokens are now prefixed with --rtm-, completely decoupled from Obsidian's own variables. Obsidian's variables are then mapped onto rtm- tokens once, in a single controlled location. This makes the theme far more stable across Obsidian updates and opens the door for proper per-component overrides.

Removed Variables (V2.7 to v3.0)

The following CSS variables have been removed or renamed. If you use any of these in custom snippets, you must update them.

Removed Style Settings Keys (V2.7 to v3.0)

The following Style Settings IDs have been removed. Any saved settings using these keys will be silently ignored. You must re-configure your preferences after updating.

✨ What's New

🏗️ Rebuilt Architecture and Token System

The entire CSS foundation has been rewritten. All theme internals now live under the --rtm-* namespace. The body-level token map centralises all Obsidian variable overrides in one place, making the theme far more predictable and easier to customise via snippets.

🚫 Goodbye !important - Proper CSS Cascade

Every single !important declaration has been removed from the theme. In v2.7, !important was used extensively as a patch to force overrides - a symptom of the old architecture where Obsidian's variables and Retroma's own tokens were tangled together.

The rewritten --rtm-* token system means the theme now relies entirely on CSS specificity and the natural cascade to apply styles. Selectors are deliberately ordered and scoped so that each rule wins by virtue of its selector weight and source order, not brute force.

The practical benefit for you: custom snippets no longer need !important to win. A simple, correctly scoped selector in your snippet file will override Retroma's styles as intended, without a fight.

📖 Built-in README and Terminology Guide

A new README section is now embedded directly inside the Style Manager / Style Settings panel. It explains why Retroma uses OKLCH over HSL or RGB, and provides a plain-English glossary covering: Tuner, L (Lightness), C (Chroma), H (Hue), Desktop-only settings, Global settings, Normal/Hover/Active states, Padding vs. Margin, and Vertical vs. Horizontal spacing.

🎛️ Redesigned 3D Button Engine

The 3D button effect has been completely rewritten using trigonometric CSS functions (cos(), sin()). Instead of hardcoded shadow/highlight directions, the engine now takes a light angle parameter and mathematically derives the correct highlight and shadow positions for any direction.

New controls:

• Light angle - sets the direction the virtual light comes from, affecting all buttons, toggles, sliders, and inputs simultaneously
• Shadow and highlight thickness - normal and active states controlled independently
• Shadow and highlight lightness, opacity, and blur - fine-tune the 3D depth for each state
• Separate dark mode 3D tuner with its own shadow/highlight properties for normal and active states
• Color overrides - override the default, hover, and active button backgrounds, icon color, and border color independently

🖌️ Redesigned Workspace and Pane System

The workspace layout system has been completely rearchitected.

New controls:

• Border-radius - global interface corner radius
• Simple pane header - removes borders and backgrounds from pane headers (does not affect the Markdown editor, file navigation, or PDF viewer panes)
• Simple workspace panes - removes extra borders and backgrounds around individual panes
• Hide vault profile container (desktop) - hides the vault name, settings, and help icons at the bottom left
• Pane outer-spacing (desktop / tablet) - controls the gap between panes
• Pane inner-spacing (desktop / tablet) - controls padding inside each pane
• Workspace primary-outline style and thickness - for the outer workspace frame and pane headers
• Workspace secondary-outline style and thickness - for inner panes, menus, modals, and popups
• Background and foreground color overrides - manually override workspace background, pane background, pane content background, pane header background, pane header title color, and outline colors for both primary and secondary outlines

🎨 LCH Color Tuners

The LCH tuner is now split into two dedicated sections:

• LCH tuner (backgrounds) - adjust light mode chroma, dark mode chroma, and dark mode lightness for background colors
• LCH tuner (texts) - adjust chroma and lightness for text colors independently in light and dark mode

🗂️ Redesigned Folder and File Section

The Folder and files section has been rebuilt. Individual folder color slots (rtm-folder-color-1 through rtm-folder-color-15) are still present and configurable. New folder styling controls include:

• Type - choose between different folder layout styles
• Icon - choose the folder icon style
• Outline style, outline thickness, left outline thickness, and opened folder outline thickness
• Indentation line style and indentation line thickness
• Vertical spacing between folders
• Remove rainbow colors toggle
• Background color and collapsed background color
• Text color and collapsed text color

A dedicated File subsection has also been added with its own styling controls.

📝 Redesigned Markdown Editor Section

The Markdown editor section is now its own top-level category with the following controls:

• Markdown editor font
• Markdown editor background color
• Markdown editor font size
• Simple markdown editor header toggle
• Simple markdown editor container toggle (desktop)
• Readable line length override

Editor pattern subsection:

• Toggle pattern on/off
• Pattern type (Dot or Grid)
• Zoom (scale)
• Thickness

📐 Expanded Typography Controls

Headings:

• Per-heading color (H1–H6)
• Per-heading size (H1–H6)
• Per-heading weight (H1–H6)
• Per-heading line height (H1–H6)
• Per-heading font (H1–H6)
• Heading underline subsection per heading level: show/hide toggle, style, thickness, offset, and color
• Hashtag rendering toggle, op...

📝 Full Changelog

This update introduces more granular control over workspace organization and deeper customization for color and typography within the Style Settings.

✨ New Features

• Folder Settings: Added new customization options for folder colors and border styles. #25 (7aeec5c)
• Dark Mode Customization: Added a new slider to modify dark mode lightness, allowing for better contrast control. (d1abe2f)

🎨 Style Settings & UI Refinements

• Typography & Color: Reordered the typography chroma/saturation sliders. (bc73878)
• Title Updates: Updated the titles for Style Settings items to improve clarity and organization. (17d4331)

🛠 Maintenance

• Code Quality: Formatted the codebase with Prettier. (55b94d6)

📝 Full Changelog

This update introduces significant refinements to the mobile experience, improves the visual consistency of internal settings, and cleans up redundant interface elements.

📱 Mobile Improvements

• Mobile Tab Switcher: Updated the tab switcher (d2f1daf) and fixed the menu bar position (1cddd51).
• UI Polish: Enhanced the mobile toolbar appearance (703efa5) and empty state buttons (51e46ca).
• Layout: Adjusted nav header padding for mobile screens (11faca8).

🎨 UI & Style Refinements

• Canvas Enhancements: Improved Canvas UI and navigation (7202727) and updated the default background color (7824678).
• Color Picker: Updated the reset button appearance (aa73c8e) and excluded color picker buttons from certain styling to prevent conflicts (fcffa4d).
• Component Tuning: * Updated default colors for checkboxes (cd7dad6) and collapse icons (d3f25c0).
• Adjusted settings item height (e1de466) including small screen specific heights (c92c81c).
• Updated the fade mask (93c8c7f) and embedded backlink pane (843aaf7).
• Refined the "Bases" appearance to better match the core theme (500a0cd).

🛠 Plugin Support & Maintenance

• TaskNotes Plugin: Fixed interactive accents (cad6383) and refined the kanban column inline margins (d0cd3fa).
• Cleanup: Removed redundant properties (3e5bdf1) and the top border of the vault profile switcher (197aa20).
• Legal: Updated the LICENSE year (dc5a112).

📝 Full Changelog

This release focuses on deepening plugin integrations, expanding Canvas customization, and fine-tuning UI component spacing.

✨ New Features

• Canvas Settings: Added new Canvas-specific settings in Style Settings: card border width; canvas background color and opacity; canvas font. (cc33786)
• Plugin Integrations: Added a toggle in Style Settings for plugin integrations and introduced support for the TaskNotes plugin. (ca33a50)

🎨 Style & UI Updates

• Style Settings: Refined heading spacings within the Style Settings menu. (ab943c3)
• Metadata Properties: Updated the property color when selected for better visual feedback. #27 (986362d)
• Checkbox Container: Updated the checkbox container styling. (49fa229)
• Plugin UI: Adjusted container colors for Style Settings to improve readability. (b207cd9)
• Button States: Updated the "active" button state to match the overall theme palette. (efea297)
• Layout Padding: Adjusted base view padding. (7ebd7fd)

📝 Full Changelog

• Hotfix for #27 . (60ce91b)

📝 Full Changelog

This update focuses on UI consistency and theme alignment, specifically targeting interactive components like buttons, graphs, and layout spacing for mobile devices.

Component & UI Enhancements

• Button Theme Alignment: Synchronized the button icon appearance and active states to fully match the theme. (03eff38)
• Canvas & Graph Styling: Updated the visual appearance of graphs and canvas control item buttons for better clarity. (844b31e)
• Pill Component Refinement: Adjusted the outline of "Pill" UI elements. (6647660)
• Settings UI Update: Update the settings item buttons active state to ensure thematic consistency. (08b2707)

Visual Refinements

• Shadow & Depth: Fine-tuned the inset values for box shadows to improve depth perception. (33b3658)
• Mobile Optimization: Adjusted PDF toolbar spacing specifically for improved phone display. (4f76c8c)

Maintenance & Code Quality

• Code Formatting (56c7135)
• Commit Fixups (4585805)

📝 Full Changelog

This update focuses on refining the mobile experience, polishing theme consistency, and resolving layout issues within the Canvas and external plugins.

📱 Mobile & UI Improvements

• Enhanced Mobile Navigation: Updated the navigation flow for a smoother mobile experience. (671081d)
• Canvas: Resolved an issue where certain menus within the Canvas were not displaying correctly on phone screens. (07a003a)
• Theme Consistency: Updated checkboxes and sliders to better align with the overall workspace theme. (3d6230f)

🛠 Bug Fixes & Reverts

• Plugin Compatibility: Fixed a bug where Retroma interfered with Excalidraw plugin embeddables. (306f5d1)

🔄 Style Rollbacks:

• Reverted the Notebook Navigator plugin style to default to resolve theme and style conflicts within the plugin's own settings.. (92df56e)
• Reverted changes to the Canvas node container. (322f188)

📝 Full Changelog

This release focuses on refining the user interface across both desktop and mobile platforms, with a significant emphasis on spacing, navigation elements, and visual consistency across devices.

🪛 UI & Layout Refinements

• Updated spacing and layout for File margins, Workspace leaf, and Metadata containers. (4934e66, 1bd0173, 63a9a19)
• Improved navigation visuals, including indentation guides and menu item styling. (817149e, ae36769)
• Enhanced component aesthetics for popups, scrollbars, base embeds, and canvas buttons. (5f2def3, e10e123, 34d3d02, 0e068e1)
• Refined prompt instructions color scheme. (c46edfe)

🪛 Mobile Enhancements

• Optimized mobile navigation and toolbar appearance and touch targets. (5a2f1a9, f23078d, 67d6e9b)
• Updated mobile tab previews and sidebar width for better screen utilization. (9a275cf, e3b30c3, 8f6900c)
• Adjusted table drag handle size for improved mobile interaction. (e90f30c)