Changelog
What is new.
Every update, in plain language. What changed and what you can do with it now.
April 18, 2026
```
Unused tokens now surface in a dedicated Quality view ``` The Quality section in the tokens sidebar now lists every token that no component or alias references. You can review and delete unused tokens from one place, without scanning token sets manually. ---
April 18, 2026
**Interaction state selector in component preview**
Component previews now include a state selector bar when interaction states are defined. Switch between Default, Hover, Focus, Active, Disabled (or any states your design system defines) to see exactly how token overrides apply at each state, alongside any active mode.
April 18, 2026
**Release notes added to the publish flow**
When publishing a design system update, you can now write release notes to explain what changed and what consumers need to do. Notes appear in the changelog across your studio and any consumer docs. Leave the field blank and the system generates a summary from the diff automatically. ---
April 18, 2026
Keyboard navigation now skips straight to the content
The consumer docs portal now includes a skip navigation link as the first focusable element on the page. Keyboard and screen reader users can press Tab once to skip the header and jump directly to the main content area, without tabbing through every nav item first.
April 18, 2026
**Mode overrides now stand out in the token table**
When you switch to a non-default mode, the token table now shows at a glance which tokens have explicit overrides and which are inheriting from base. Overridden tokens get a left-border accent highlight; inherited tokens are subdued. Use the new "Overrides only" filter to focus the list on tokens that differ in this mode. ---
April 18, 2026
**Token rename now shows alias impact upfront**
When you rename a token that other tokens reference, the drawer now tells you how many are affected before you commit the change. The confirm button shows the exact count, so you know what will update before clicking.
April 15, 2026
**Token paths on component pages now link to the token**
On any component's documentation page, each token in the "Tokens used" table is now a link. Click it to jump directly to that token's row on the tokens page.
April 15, 2026
**Title:** Docs now cover React, Vue, Figma, and 6 more platforms
The docs platform switcher now covers 10 platforms across three groups: web frameworks (HTML/JS, React, Vue, Svelte, Angular), mobile (React Native, iOS, Android, Flutter), and Figma. Each platform has its own install and usage instructions on Getting Started, and switching platforms updates the code examples throughout the docs. The Figma track walks through installing the plugin, pairing your design system, and keeping tokens in sync. ---
April 14, 2026
**Docs overview now shows which counts are published or in preview**
The token and component counts on docs pages now tell you what they represent. Published docs show "Tokens published" and "Components published" so it's clear the numbers reflect the last publish, not any work in progress. Branch preview docs show "Tokens in preview" and "Components in preview" for the same reason.
April 14, 2026
**Deleting a token set now requires confirmation**
Before a token set is removed, you see exactly what gets deleted: the token count, any components that will lose their bindings, published versions that include those tokens, and connected repos that may be affected. You must type the set name to confirm. The set is not deleted until you complete both steps. ---
April 14, 2026
Branch previews now show who created the branch
When reviewing a branch preview link, you now see the branch name and its creator at the top of every page. A direct link to the published docs is always one click away.
April 13, 2026
**Figma Variables as token layers: new Spotlight post**
A new Figma Spotlight post walks through how to structure Variable collections as token tiers. It covers the difference between raw values and aliases, why modes belong at the semantic layer, and how to catch aliasing mistakes before a rebrand exposes them.
April 13, 2026
```
Accessibility gate for the publish flow ``` Workspace owners can now configure an accessibility gate that runs when publishing. In warn mode, accessibility issues appear in the publish flow so you can act on them before they reach consumers. In block mode, any accessibility errors prevent publishing until resolved. ---
April 13, 2026
Accessibility warnings now appear inline in the token editor
When a token value falls outside safe accessibility ranges, a warning appears next to the editor as you type. Font size, line height, font weight, and duration tokens all check against known thresholds. Warnings are informational and do not block publishing.
April 13, 2026
**Keyboard bindings for nodes**
The node inspector now has a Keyboard section. Assign key-to-action bindings to any node — Enter to activate a button, Escape to dismiss a dialog, arrow keys for tabs or menus. Defaults are filled in based on the node's role and part, so most nodes are already set up correctly. Bindings preview in interactive mode and export with the component. ---
April 13, 2026
Test component states live on the canvas
Interactive mode turns the canvas into a live preview. Move your cursor over nodes to trigger hover, pressed, and focus state overrides, with any transitions you have defined playing automatically. Select the toggle in the toolbar to return to editing. ---
April 13, 2026
**Token creation now available inside the component editor**
When binding a token slot in the component editor, you can now create a new token without switching to the tokens tool. Open any token picker, choose "Create new token," pick or name a token set, and the new token is selected immediately. ---
April 13, 2026
**Title:** Insert atoms and components into any component
You can now pick any atom or component from your project and insert it as a reference inside another component. Select a container in the structure tree, choose "Insert atom..." from the context menu, and pick what to insert. The inspector for an atom reference shows "Open atom" to jump to its editor, or "Detach" to inline a copy that lives independently. Components that would create a circular reference are excluded from the picker automatically. ---
April 13, 2026
**"Convert to atom" now works on any node, with a keyboard shortcut**
Right-clicking any non-root node in the Structure Tree now shows "Convert to atom", including Text, Input, and Asset nodes, not only containers. You can also trigger the same action with Cmd+Shift+A (Ctrl+Shift+A on Windows). Token bindings, role annotations, and per-state overrides carry over to the extracted atom automatically. ---
April 13, 2026
```
Archived design systems now warn owners before deletion ``` If a design system has been archived for 5 months, workspace owners now receive an email 30 days before it is permanently deleted. The email includes the deletion date and a direct link to unarchive. Owners with billing alerts turned off will not receive the email. ---
April 13, 2026
Onboarding now walks you through each setup step
Previously, creating a workspace and choosing an import source happened in a single form. Now onboarding guides you through three distinct steps: workspace setup, naming your design system, and choosing how to start (from scratch, Figma, or your codebase). Import happens within the same flow, so you land on your new design system ready to work. ---
April 13, 2026
**Title:**
``` Project settings now accessible from the Studio ``` The Project Settings modal is now available directly inside the Studio from the settings button in the top bar. From there you can rename your design system, view workspace members, and control branch review requirements without leaving your work. Workspace owners can also delete a design system from the Danger Zone tab.
April 13, 2026
`Org audit log shows plain-language event history`
The org-level audit log now describes what happened in plain language: who invited a member, published a release, or changed workspace settings. Filter by event type, member, action, or workspace. Expand any entry to see exactly what changed before and after, or export the full filtered history to CSV. ---
April 13, 2026
**Token health no longer says "healthy" on empty design systems**
The token health card now shows a distinct message when a design system has no tokens, instead of reporting "All tokens are healthy." The badge count also now matches the number of issues listed, so a badge reading "1 issue" always means exactly one row appears below it. ---
April 13, 2026
**Activity feed now shows readable action text**
The project overview activity feed previously showed raw internal strings like `settings_change` or `cherry_pick` as action verbs. All activity entries now render as natural sentences, including "updated settings for", "rolled back", and "cherry-picked". Project renames show the old and new name side by side. ---
April 12, 2026
**Audit log now shows who actually took each action**
Org audit log entries were always showing "Unknown" as the actor, even when a real user made the change. That is fixed. Actions by current members now show their name or email. Actions by users whose accounts have been deleted show "Deleted user." System-originated actions show "System." ---
April 9, 2026
This change is a terminology correction, not a new feature. It does not warrant a changelog entry — users already know whether they are on Pro or Free. Skip the changelog for this task.
---
April 9, 2026
**Import preview shows unchanged tokens**
The import diff now includes a summary bar with counts for added, updated, and unchanged tokens, giving you the full picture before you confirm. Tokens with identical values are listed in a collapsible section so they stay out of the way but are always one click from view. ---
April 9, 2026
**Broken aliases now trigger a confirmation step before publishing**
When a design system has tokens pointing to aliases that don't exist, clicking Publish now opens a confirmation modal listing every affected token. You can review what's broken and decide whether to publish or go back and fix it first. The old checkbox in the Token Health panel has been removed. ---
April 8, 2026
**Title:** Library updates now show a token-level diff before you upgrade
When a library dependency has an update available, you can now preview exactly what changed before pinning to the new version. A diff view opens inline, showing added, modified, and removed tokens with their old and new values. Breaking changes are flagged clearly so you can assess impact without leaving the settings page. ---
April 8, 2026
**Token edit shows which tokens will change before you save**
When you edit a primitive value, a preview now appears showing every token that aliases it, and what the color will look like before and after. Nothing is blocked. You can still cancel or save as normal. ---
April 8, 2026
**A new version banner appears when docs are updated**
When a newer version of a design system is published while you have the docs open, a banner now appears at the top of the page. Reload to see the latest tokens and components, or dismiss the banner to keep reading the current version. ---
April 8, 2026
Token category templates at project creation
When creating a new design system or completing onboarding, you can now pick a starter template that seeds your token categories automatically. Choose from Minimal baseline, Material Design 3, or Apple HIG, or start blank and add categories yourself. The same template picker is available from an empty tokens workspace, so you can apply a starting point any time before you have added your first token. ---
April 8, 2026
**Token drawer now shows platform-specific output**
Open any token and expand "Platform output" to see how that token's resolved value translates across CSS, Swift, Android, and React Native. Each row is ready to copy. No export step needed to check what a single value looks like in your target platform. ---
April 8, 2026
Token names are now configurable per export format
Choose a naming convention for each format you export: camelCase for JS, snake_case for Android, PascalCase for Swift, or any other standard. You can also set a custom prefix and segment separator per format. Settings are saved per workspace and applied automatically on each download. ---
April 8, 2026
**Mode coverage now visible in the Modes panel**
Each mode in your design system now shows how many tokens have a value set for that mode, with a progress bar and a breakdown of which tokens are missing. Open the Modes panel and expand any non-default mode to see what still needs a value before you publish. ---
April 8, 2026
**Fill empty mode slots from the base value in one click**
In the token editor, a new button in the base value row fills every mode that has no override yet with the base reference. Existing overrides are untouched. Submit the modal as usual to save. ---
April 8, 2026
**Breaking changes now listed in release emails**
When a major version is published, the update email now lists each breaking change individually. You can see exactly what was removed or changed before updating your consumers. ---
April 8, 2026
**Orphaned tokens are now easy to find**
A new "Unused" filter in the token editor shows only tokens with no aliases, component bindings, or mode overrides. Scan any design system for dead weight, section by section, without leaving the editor. ---
April 8, 2026
**Token conflicts between libraries are now visible in the token list**
When two of your library dependencies define the same token, both rows now appear in the token list with a clear label. The library added most recently takes priority at publish time and is marked "Takes priority". The overridden library is marked "Overridden" and dimmed. Hover either row to see which values are in conflict and which one will be used. ---
April 8, 2026
**Title:** Library dependencies can now be pinned to a specific version
When you add a library to your design system, you can now choose which published version to use instead of always pulling the latest. Pinned dependencies stay locked until you decide to update. If a newer version is published, your settings page shows a badge on the affected library so you can review and update on your own schedule. ---
April 7, 2026
Org owners can now require 2FA for all members
Workspace owners on the Pro plan can turn on a 2FA requirement from security settings. Members who haven't enrolled are redirected to a setup page after login, with a configurable grace period before access is blocked. ---
April 7, 2026
Library overview now shows which projects depend on it
When you open a library project's overview, you can now see every project that lists it as a dependency, along with the project owner and when they last published. Library projects with no dependents show a message explaining what the section will display once teams connect. ---
April 7, 2026
**Component property changes now visible in version diffs**
When comparing two published versions, the diff viewer now shows exactly what changed inside each component: which props were added, removed, or modified, along with slot and variant changes. If a prop's type or required status changed, you can see the before and after values side by side. Added and removed components still appear as before. ---
April 7, 2026
**Unpublished changes now visible on the project overview**
Your project overview now shows how many token and component changes are waiting to be published. Click the count to see a full diff of what has changed since the last release, with no setup required. ---
April 7, 2026
**Billing notifications for paused subscriptions and refunds**
When a subscription is paused, workspace owners with billing notifications enabled now receive an email. Refund confirmations are also sent automatically when a refund is processed on your account. ---
April 7, 2026
**Latest release now shown on the docs overview**
The consumer docs overview now shows the most recent published version at a glance: version number, publish date, and a preview of the release notes. If you're pinned to an older version, a warning card tells you a newer version is available and links back to the latest. ---
April 7, 2026
Component history pages now show a breadcrumb
When browsing a component's change history, you now see a breadcrumb showing where you are: the component section, the specific component, and the current view. "Components" and the component name are clickable links so you can navigate back without using the browser back button.
April 7, 2026
**Docs portals can now be set to private**
You can restrict who sees your published docs portal by switching visibility to private in settings. Visitors without a personal access link see a locked state instead of your content. Invite people directly from settings and revoke access at any time. ---
April 7, 2026
**Import no longer silently drops unresolved tokens**
When importing a file with ambiguous tokens, any row left without a section assignment now blocks the import and shows a count of what needs attention. The skipped total in the import summary now includes all tokens that were excluded, whether by choice or by an empty section. ---
April 7, 2026
**Two new email notifications for org and library events**
When someone accepts an invitation to your organization, owners now receive an email alongside the in-app notification. Members of projects that depend on a library also receive an email when that library publishes a new version. Both notifications respect your existing alert preferences in Settings. ---
April 7, 2026
**Library update notifications for dependent workspaces**
When a shared library publishes a new version, every workspace that depends on it now gets an in-app notification. The Libraries section in your settings also shows a badge when your workspace is behind, so you know to update before your next publish. ---
April 7, 2026
**Flutter and Dart export now available**
Export your tokens as a Dart file for use in Flutter apps. Fetch `tokens.dart` from your registry URL and import it directly into your Dart package. Available on Pro. ---
April 7, 2026
**Publish dialog now breaks down changes by category**
The Changes section in the Publish dialog now shows token and component counts separately: how many were added, and how many were modified. Breaking changes still appear in the orange callout below. You get a clearer picture of what is in a release before you publish it. ---
April 7, 2026
**Release notes now appear in the changelog**
When you write release notes during publish, they now show up clearly labeled in the changelog, separate from the auto-generated diff summary. Consumers reading your public docs see exactly what you wrote, in the same place they review what changed. ---
April 7, 2026
**Changelog pages now filter by release type**
You can filter a changelog by breaking, major, minor, or patch releases using the new pill row at the top of the page. The active filter is saved to the URL, so filtered views can be shared or bookmarked directly. ---
April 7, 2026
Token aliasing strategy guide now in the blog
The blog has a new post covering the semantic layer: why aliasing decisions encode organizational intent rather than visual values, and how a three-tier aliasing structure keeps your design system stable across dark mode, rebrands, and platform expansion. Read it at the blog index.
April 7, 2026
**Component changes now visible in the version diff view**
The diff view in your team's docs now shows which components were added or removed between any two published versions, alongside the existing token change table. Select any two versions to see the full picture of what changed before updating your consumers. ---
April 6, 2026
**Component list now filters by lifecycle status**
The components page now shows filter pills for any lifecycle statuses present in your design system, including Beta, Experimental, and Deprecated. Click a pill to narrow the list, and combine it with the search box to find exactly what you need. The active filter is saved in the URL so you can share a filtered view directly. ---
April 6, 2026
**Unsubscribe links now open a confirmation page**
Clicking an unsubscribe link in a changelog email now brings you to a proper confirmation page inside the portal, instead of a plain HTML message. From there, you can navigate back to the changelog at any time. ---
April 6, 2026
**Diff page now explains when fewer than two versions exist**
The diff page gives you a clear next step when only one version has been published, instead of showing a generic comparison prompt. If no versions exist yet, the page now tells you exactly that rather than showing a generic empty state.
April 6, 2026
**Diff view now links back to the changelog entry**
When comparing two versions, a link to the matching changelog entry appears in the version picker. Click it to jump straight to the release notes for that version without navigating manually.
April 6, 2026
iOS, Android, and Flutter setup now on the getting-started page
The getting-started page now shows install and usage instructions for iOS (Swift Package Manager), Android (Gradle), and Flutter alongside the existing npm and CDN tabs. Switch between platforms to get the right snippet for your stack without leaving the page. ---
April 6, 2026
Set your platform once, see the right code everywhere
The platform selector now lives in the docs header rather than inside each token snippet. Pick Web, iOS, Android, or Flutter once and every snippet on the page shows the correct code. Your choice is also saved locally, so returning to the docs without a platform in the URL picks up where you left off.
April 6, 2026
**Section errors no longer knock out the full page**
When a section of your docs portal fails to load, the header and navigation stay intact. You can retry the failed section or move to another page without a full reload. --- > **Note on "This section failed to load."**: The placeholder copy is grammatically fine but generic across all three sections. The above alternatives are slightly better because they name what actually failed (the change summary, tokens, or components), which sets accurate expectations before the user clicks "Try again."
April 6, 2026
Not needed. This is a consistency fix in the consumer docs UI — styled empty states replacing unstyled paragraphs. No new capability is added and the user experience change is cosmetic. Not worth surfacing in the product changelog.
---
April 6, 2026
Test your Slack connection from the settings page
When your Slack integration is connected, you can now send a test message directly from the Slack settings tab. The message posts to your channel immediately and confirms the connection is active. Only workspace owners see the button.
April 6, 2026
**"Compare" page now linked from Getting Started**
The Getting Started page now includes a direct link to the Compare view in the Next Steps section. Use it to see exactly what changed between any two published versions or active branches before syncing.
April 6, 2026
**Token reference snippets for iOS, Android, and Flutter**
The token detail panel in docs now shows how to reference each token in Swift, Kotlin/XML, and Dart, alongside the existing web snippets. Switch between platforms using the tab bar above the code block. Your last selection is remembered. ---
April 6, 2026
**Breaking changes now highlighted in the diff view**
When comparing across a major version boundary, the diff view now shows an alert listing any breaking changes in the range. If the release notes include specific changes, each one appears as a line item. If not, a summary message flags the major version gap so nothing goes unnoticed. ---
April 6, 2026
**Title:** Component pages now available in branch preview
The branch preview now includes a components page alongside tokens. Open any branch preview URL and navigate to `/components` to see the full component list as it stands in your workspace. The amber banner makes clear these components are not yet published. ---
April 6, 2026
**Back navigation added to all docs sub-pages**
Every docs sub-page now has a back link at the top so you can return to the docs home (or component list) without using the browser button. The links match the navigation pattern already in place on settings pages.
April 6, 2026
**Token enforcement settings now documented**
Naming rules, format constraints, and semver bump policy now have a dedicated docs page. You can find configuration instructions, a full list of change kinds, and a breakdown of where violations surface during your workflow. ---
April 6, 2026
```
Library tokens now show their source in the token table ``` Tokens inherited from a library dependency now display a badge showing which library they come from. Hover the badge to confirm the source, and click it to open that library's token table directly. Editing these tokens happens in the source library, and your design system picks up changes on the next publish. ---
April 6, 2026
Filter changelog by namespace or component
The changelog page now lets you narrow releases to a specific token namespace or component. Select a namespace pill or a component pill above the version list to see only the releases that touched your area of interest. Select both to apply them together. ---
April 6, 2026
Open branches now visible on dashboard cards
Project cards now show how many branches are open, so you can see where active work is happening without opening each project. Cards with no open branches show nothing.
April 6, 2026
**Title:** Personal notification preferences now documented
ReframeUI has always supported account-level notification toggles and per-workspace overrides, but these were not documented. The Notifications page now covers both channels (in-app bell and email), the four global account toggles, and how per-workspace settings inherit from or override your account defaults. ---
April 6, 2026
Select and move tokens across groups
You can now select multiple tokens in the token table using Ctrl/Cmd+Click to toggle, Shift+Click for a range, or Ctrl/Cmd+A for all visible tokens in a category. When the selected tokens share a group prefix, you can move them to a new group in one step. Alias references to those tokens update to the new paths automatically. ---
April 6, 2026
**Docs now warn when you're reading an older version**
When you pin the docs to an older published version, a callout tells you a newer one exists and links back to the current view. This prevents teams from accidentally circulating stale documentation links.
April 6, 2026
**Title:** Release notes now appear on the consumer changelog
When you publish, you can write release notes describing what changed and why. They appear at the top of each version entry on the consumer changelog page, above the auto-generated diff summary. If you leave the field blank, nothing changes for existing consumers. ---
April 6, 2026
**Title:**
``` Studio AI assistant now available on Pro ``` **Body:** ``` Pro workspaces now have access to a conversational assistant panel in the Studio. Open it with Command-/ on Mac or Ctrl+/ on Windows. The assistant can answer questions about your design system, propose token changes, manage branches, and rename settings. Every proposed change shows a confirmation card before anything updates. The daily limit is 50 messages per workspace, resetting at midnight UTC. ``` ---
April 3, 2026
**Inherited tokens now show their source library**
Tokens pulled from a library dependency are now labeled in the token table with the name of the source library. The edit button is hidden for these tokens. To change an inherited token, open the source library directly. ---
April 3, 2026
**Title:** Mode switching now documented for React, Vue, Svelte, and Angular
The modes documentation now includes framework-specific setup examples, a migration guide for teams coming from hardcoded theme switching, and a troubleshooting section covering the most common integration failures. Known limitations around mode renaming and nested attributes are also documented. ---
April 3, 2026
**AI assistant reference page added to docs portal**
The docs portal now includes a dedicated reference page for the built-in AI assistant. It covers what data the assistant has access to, which questions it handles reliably, its rate limit, and when to use it instead of the token or component tables. Open it via the "Assistant" link in the docs header. ---
April 3, 2026
```
Slack alerts for publish and branch review events ``` ReframeUI now sends Slack messages when a design system is published or a branch review is requested. Connect a channel once in Settings and the whole team sees updates as they happen. Each team member can also tune which projects send them personal notifications. ---
April 3, 2026
**Component composition rules are now documented**
The docs now include a full reference for how Studio enforces atom nesting on the canvas. For each of the three violation types, you can look up the exact error message, what triggered it, and the steps to fix it. ---
April 3, 2026
**Title:** Quality and accessibility checks now documented
Studio's token quality checks and accessibility score are now fully documented in the docs portal. The Quality and Accessibility page covers what each of the five token quality categories flags, how the 0-100 accessibility score is calculated, which checks run automatically on save or in CI, and concrete steps to improve your score. ---
April 3, 2026
**CLI upgrade migration guide now available**
When a design system update includes breaking changes, you now have a step-by-step guide for getting your app through the upgrade safely. It covers creating a staging branch, resolving token removals the automated wizard cannot handle, and validating everything before it reaches production. Find it at `docs/UPGRADE-GUIDE.md` or follow the link from the `reframe upgrade` command docs. ---
April 3, 2026
**Version diff page now shows an instructional empty state**
When you open the diff page without selecting versions, the content area now shows a clear prompt and a description of what will appear once you choose two versions. Previously, the area was blank. ---
April 3, 2026
**Docs: Security and access reference added**
The docs now include a dedicated security reference page covering authentication methods, the permission model, data isolation, API keys, and private portal access controls. Engineering and security teams evaluating the platform can find everything they need at `/security`. ---
April 3, 2026
**Title**: Changelog notifications now documented
Consumers of any published design system can now find a dedicated guide explaining how to subscribe to release notifications, what the double opt-in flow looks like, and how to unsubscribe. The guide lives in the docs portal navigation under Publishing. ---
April 3, 2026
**Title:** `CLI Configuration docs now available`
The CLI has a dedicated configuration reference page. It documents all keys in reframe.config.json, both environment variables, and the order in which settings are resolved. The correct config filename (reframe.config.json) is now reflected throughout the CLI docs. ---
April 3, 2026
**Docs portal empty states now guide you to next steps**
The tokens and components pages in the consumer docs portal now show a clear explanation when a design system hasn't published a release yet, or when a section has no content. Both states include a direct link to the getting started guide so you're never left on a blank page.
April 3, 2026
**CLI reference now covers all 15 commands**
The CLI reference page has been updated to document every command the reframe CLI supports, including pull, diff, lint, upgrade, branches, status, init, and tokens export. Two stale sections (link and build) have been removed as those commands do not exist. Each command now lists all flags, defaults, and a realistic example output. ---
April 3, 2026
**Token diff page now reachable from every docs nav**
The "Compare versions" page is now linked in the docs header and the Getting Started guide. Pick any two published releases to see which tokens were added, removed, changed, or renamed, without leaving the docs.
April 3, 2026
**New guide: token naming conventions and namespace strategy**
A new article covers how to structure token names before you start building. It walks through the three-tier hierarchy (category, group, role), the difference between base and semantic tokens, and how naming choices become the CSS variable names every consumer app references. Published at /blog/posts/token-naming-conventions. ---
April 3, 2026
**Audit Log reference page added to the docs**
The audit log has been recording every change in your workspace for a while. There is now a full reference page in the docs covering what each entry contains, every action type and entity type with plain-English descriptions, retention details, and how to export a filtered CSV. ---
April 3, 2026
```
Publishing reference docs are now available ``` The Publishing page in the docs covers the full publish lifecycle: version bump rules, breaking change detection, consumer repo pull requests, version pinning, and rollback. If you have been using `reframe publish` without a full picture of what happens downstream, this is the reference to bookmark. ---
April 3, 2026
**Title:** Token Types reference added to docs
All 19 token types are now documented in one place. For each type you can find the type identifier, valid formats or units, and an example value. Compound types (border and typography) include a breakdown of their required sub-fields. ---
April 3, 2026
**Title:** Token import flow now has a step-by-step guide
ReframeUI now has a dedicated guide for importing tokens in Studio, covering every step from file upload through conflict resolution and alias breakage warnings. If you are migrating an existing token library, the guide explains what each step shows and what your choices mean before anything is written to your project. ---
April 3, 2026
**Branch review and approval workflow is now documented**
The docs now cover the full review workflow: enabling required approvals in project settings, requesting a review from a teammate, approving or rejecting with a comment, and how the merge gate behaves. A new section explains how breaking changes surface after publish, including the migration manifest format. ---
April 3, 2026
Component Builder workflow is now documented
The docs now cover the full component building workflow. Learn how to navigate the canvas, place atoms, bind tokens to visual properties, define variants and states, and configure slot documentation before publishing. ---
April 3, 2026
**Shared Libraries now documented in the docs portal**
The Shared Libraries page is now available in the docs portal. It covers how to create a library project, add it as a dependency, understand token resolution order, and handle publishing constraints. If you build shared token libraries for multiple teams, this is the reference page. ---
April 3, 2026
**Share a link to any version of your token docs**
The consumer docs portal now shows a version selector on the tokens page. Switch between published versions to review what changed, or copy the URL and share it with your team. Links with a specific version always load that snapshot. ---
April 3, 2026
Publishing now requires acknowledging broken aliases
When your token health check shows broken aliases, a confirmation is now required before you can publish. This prevents silent failures from reaching your consumers before the aliases are fixed or intentionally accepted. ---
April 3, 2026
**Branch token state now previewable in your docs site**
Before merging a branch, you can now open a live preview of its token state directly in your consumer docs. From the branch menu in Studio, select "Preview in docs" to see exactly what your team will get after the merge. The preview URL can be shared with anyone who has docs access. ---
April 3, 2026
**Broken aliases are now visible in the token list**
Tokens with a broken or circular alias now show a warning icon directly on the row, without having to open the token drawer. Use the "alias issues" filter chip in the toolbar to show only affected tokens across all categories. ---
April 3, 2026
**Broken aliases are now visible in the token list**
Tokens with a broken or circular alias now show a warning icon directly on the row, without having to open the token drawer. Use the "alias issues" filter chip in the toolbar to show only affected tokens across all categories.
April 3, 2026
Token delete now warns when other tokens reference it
When you delete a token that other tokens point to, a warning lists every affected token before anything changes. You can cancel and fix the references first, or confirm to delete and clean up later.
April 3, 2026
**Token path rename with alias cascade**
You can now rename any token directly from the drawer. Type a new path, confirm, and every alias that pointed to the old name updates in the same operation. Nothing breaks silently. ---
April 3, 2026
Tab completion now available for bash and zsh
Run `reframe completion --shell zsh >> ~/.zshrc` (or `--shell bash`) to add shell completions. After reloading your shell, pressing Tab after `reframe` completes subcommands and flags. A setup hint appears after `reframe login` so you see it when you first connect.
April 3, 2026
Consumer repos now notify your team when a PR merges
When a consumer app merges the PR that adopted your latest publish, every owner and editor on your workspace gets a notification. You can see which repo picked up the change and link directly to the merged PR. ---
April 3, 2026
**Private portal: invite-only access**
Your private docs portal now supports per-person access. Invite collaborators or clients by email from project settings, each gets a personal link. Revoke any invite at any time and access ends immediately. ---
April 3, 2026
Token descriptions now appear in your docs
When a token has a description, it shows beneath the token path in the table and in a labeled section inside the snippet panel. The CSS block also includes the description as a comment above the variable. Descriptions are authored in Studio and appear exactly as written. ---
April 3, 2026
**Upgrade command stops before touching files when breaking changes are found**
Running `reframe upgrade` now exits with a clear count of breaking changes if the release contains removed, renamed, or type-changed tokens. Pass `--yes` to confirm you have reviewed the changes and proceed. Type changes, where a token's category shifts between releases, are now classified as breaking and shown in the change summary alongside removed and renamed tokens. ---
April 3, 2026
**Consumer repo connection health is now tracked and visible**
When a GitHub App is uninstalled, a sync fails, or a token expires, the affected repos now show their connection state directly in the settings table. Each repo shows "Connected", "Degraded", "Broken", or "Unknown" with a tooltip explaining what went wrong. The project overview also reflects broken connections in the summary health indicator. ---
April 3, 2026
**Branch merge history is now visible in the studio**
Every merged branch is now listed under "Past merges" in the branch menu. Open any entry to see exactly which tokens were added, removed, or modified in that merge, along with who merged it and when. ---
April 3, 2026
Branch comparison added to the diff view
The Compare page now has two modes: Versions and Branches. Switch to Branches mode, select any two active branches, and get a full token diff with the same summary, change list, and migration guide you get from version comparisons. Catch token conflicts before you merge. ---
April 3, 2026
**Title:** `Subscribe to changelog updates by email`
Visitors to a public changelog page can now enter their email address to get notified when a new version is published. After confirming their address, they receive a release email with the changelog and a direct link. Every email includes a one-click unsubscribe link. ---
April 3, 2026
**Compare two modes side by side in the canvas**
You can now split the component canvas into two panels and apply a different mode to each. Pick any two mode configurations from the toolbar and see your component render with both at once. Both panels share the same component tree, so selections and edits stay in sync. ---
April 3, 2026
Breaking changes now visible before you publish
When a publish would remove or rename tokens, the Publish dialog now shows a count of breaking changes and lists each one before you confirm. Consumers are flagged so nothing catches your team off guard after an upgrade. ---
April 3, 2026
Control notification alerts per project
You can now choose which projects send you publish and branch review alerts. Find the new "Project notifications" section on the notifications settings page, with a toggle for each project in your workspace.
April 3, 2026
**Email address changes now available in security settings**
You can now change the email address on your account from the security settings page. Enter a new address, confirm it via a link sent to the new address, and your old address receives a notification. The link expires after one hour.
April 3, 2026
**Deprecated tokens now flagged in the docs portal**
Tokens marked as deprecated in your design system now show a "Deprecated" badge in the token table. Expanding a deprecated token shows a warning with the reason and a direct pointer to its replacement, so consumers know exactly what to migrate to. ---
April 3, 2026
**Component slot descriptions now editable in Studio**
You can now write a description for each slot directly in the component detail panel. Descriptions appear in the consumer docs Slots table, giving your team the context they need to use each slot correctly. ---
April 3, 2026
Color tokens now have a swatch grid view
Browse your color tokens as a visual grid of color swatches, grouped by namespace. Switch between list and grid in the token category header. Your preference is saved between sessions.
April 3, 2026
```
Variant matrix view on component detail pages ``` Component detail pages now show a variant matrix view alongside the single preview. When a component has two or more variants, a toggle appears in the preview header. Switch to "Variant matrix" to see every variant and interaction state side by side in a single grid. ---
April 3, 2026
**Token search and type filter in the token panel**
You can now search tokens by name or value inside any open token set. Results update as you type, and a clear button restores the full list. A type filter in the sidebar lets you narrow the set list by token type (color, spacing, etc.) without leaving your current view. ---
April 3, 2026
**Shared libraries for cross-project token reuse**
You can now create a shared library project to hold primitive tokens that multiple design systems in your workspace reference. Add a library as a dependency in project settings, and its tokens resolve into your aliases automatically at publish time. Change a library value once and every dependent design system picks it up on its next publish. ---
April 3, 2026
**Accessibility report on every component page**
The component reference page now includes an Accessibility section for each component. After publishing, you see which WCAG 2.1 AA checks pass, which violations were found, and links to remediation guidance for each rule. Reports are generated automatically as part of publish. ---
April 2, 2026
**Pending review requests now visible on the overview**
When someone requests your review on a branch, it now appears in a "Pending reviews" section at the top of the overview page. Requests are grouped by project and show the branch name, how long they have been waiting, and a direct link to that project's tokens. Branches that have already been merged or responded to do not appear. ---
April 2, 2026
Docs search gaps now visible in workspace settings
The settings page now shows which search queries your docs visitors typed and which ones returned nothing. Use the "Searches with no results" panel to find gaps in your token names or docs coverage and close them before they become friction. ---
April 2, 2026
**Title:** Consumer PRs open too long now show a warning
When a consumer repo has a PR that has been open for 7 days or more without merging, the settings page and project dashboard both flag it. The settings page shows how many days the PR has been open, with a direct link to the PR. The dashboard health indicator changes from green to a warning state. Close or merge the PR and the warning clears automatically. ---
April 2, 2026
**Token removals and renames can now require a minimum version bump**
You can define semver rules in Project Settings that block a release when the version bump is too low for the type of change detected. If a rule is triggered, the publish dialog shows exactly which rule failed and which token caused it. Rules are enforced server-side as well, so no release can bypass them. ---
April 2, 2026
**PR status updates now show after publish**
After you publish, each consumer repo now shows its current pull request status — open, draft, merged, or checks failing — pulled fresh from the source. If any checks are failing, you'll see it immediately without leaving the dialog. Wait — em dash crept in. Corrected: After you publish, each consumer repo shows its current pull request status: open, draft, merged, or checks failing. The status refreshes automatically once all PRs are created. If any checks are failing, you see it before leaving the dialog. ---
April 2, 2026
**Token history now shows in the detail drawer**
Open any token and expand the History section to see every change made to its value, who made it, and when. The oldest version of a value shows a hyphen to mark where the token was first created. ---
April 2, 2026
```
PR status for each connected repo now shows on publish ``` After you publish a release, the dialog stays open and shows each connected consumer repo as a row. Rows update from "Queued" to "PR created" as pull requests are opened. If a repo fails, the error message appears inline so you can act on it without hunting elsewhere. ---
April 2, 2026
**Title**: Duplicate a branch from the branch menu
You can now duplicate any branch directly from the branch menu. The duplicate starts with all token changes from the source branch and a fresh snapshot of main, so merge previews are accurate from the start. Look for the Duplicate button on each branch row, or use "Duplicate this branch" in the footer when you are on a non-main branch. ---
April 2, 2026
**Slack notifications now include branch review requests**
When someone requests your review on a branch, you now get a Slack message with the branch name, who asked, and a direct link to the branch. The notification goes to the reviewer as soon as the request is made. ---
April 2, 2026
**Assign reviewers when requesting a branch review**
You can now select one or more workspace members to review a branch before it merges. Open the branch menu, click "Request review", pick the people you want, and send. Each person gets notified and can respond directly from their notification. Members with a pending request on that branch are shown as already assigned. ---
April 2, 2026
**Token formats now available as direct URLs**
Every time you publish, ReframeUI generates all token formats and stores them at stable, versioned URLs. Paste a CSS or JS URL directly into your project, run `reframe pull` to write files to disk, or download everything as a ZIP. Older published versions continue to work at their existing URLs. ---
April 1, 2026
Write and organize your design system docs in Studio
The docs section is now editable. Add headings, text, code samples, callouts, token previews, and component previews to any docs page directly in Studio. Drag pages to reorder them, hide pages your team is not ready to share, and add custom pages for any content your design system needs. Token and component descriptions are editable inline on their respective pages. ---
April 1, 2026
**Portal description field added to docs branding**
You can now add a short description to your docs portal. It appears as an intro blurb on the portal landing page, giving teams context on what your design system covers before they start browsing tokens and components. Set it in workspace settings under Branding. ---
April 1, 2026
**Upgrade prompts now appear when plan limits are reached**
Trial workspaces now see a contextual prompt when they hit a plan limit: creating a second design system, inviting a team member, or connecting a repo. Each prompt explains exactly what is gated and what upgrading unlocks. Previously, these actions failed silently or showed a bare error string. ---
April 1, 2026
**Each workspace now has an overview page**
The overview page shows your current published version, open branches, unpublished changes, and connected consumer repos in one view. The activity feed lists the last 10 changes with attribution, so you can see who changed what without leaving the overview. ---
April 1, 2026
**Per-repo PR title, branch, labels, and reviewers**
You can now configure how update PRs are opened for each connected repo. Set a custom PR title template, request specific reviewers, apply labels automatically, and override the target branch. Changes take effect the next time a PR is opened for that repo. ---
April 1, 2026
**Font family tokens now use a structured font picker**
Font family tokens now have a dedicated editor with an ordered list of font sources. For each entry, choose from uploaded project fonts, Google Fonts, common system fonts, or type a name manually. Reorder entries with the arrow buttons, and see the resolved CSS value update in real time. Existing tokens with a plain-text value load automatically as a single manual entry. ---
March 31, 2026
**Switch between workspaces from the top bar**
If your account belongs to more than one workspace, you can now switch between them directly from the top navigation. Your active workspace is remembered, so the right context loads every time you sign in. Single-workspace accounts see no change. ---
March 31, 2026
**AI assistant added to consumer docs portal**
Each published design system now includes a built-in Q&A assistant. Open it from the docs header to ask questions about tokens, components, and version history. Answers are scoped to the published data for that specific design system. ---
March 31, 2026
**CI workflow generation added to `reframe init`**
Running `reframe init` now offers to write a GitHub Actions workflow that runs token linting on pull requests and publishes updates on merge. Pass `--ci` to generate it without a prompt. The workflow install step matches the package manager you chose during setup. ---
March 30, 2026
Switch Figma variable modes directly from the plugin
After syncing your design system, a mode picker appears in the plugin. Select any mode, such as Light or Dark, and the current Figma page updates immediately. Your selection is saved and restored the next time you open the plugin.
March 30, 2026
**AI name suggestions in the token editor**
When adding a token, a "Suggest names" button now appears next to the name input. Click it and the editor proposes 3 to 5 names based on your existing token conventions and the category you're working in. Clicking a suggestion fills the name field instantly. ---
March 30, 2026
Token descriptions now sync back to Studio from Figma
When you edit a variable description in Figma and click "Push descriptions to Studio," those descriptions are written back to the matching tokens in your workspace. Token descriptions you set in Studio also appear automatically on Figma variables the next time you sync.
March 30, 2026
Slack notifications for publish events
Connect a Slack workspace in org settings and every publish sends a message to your chosen channel with the version, bump type, and a summary of what changed. Only org owners can connect or disconnect the integration. ---
March 30, 2026
**See which tokens each connected repo actually uses**
The Connected Repos page now shows an adoption percentage for each repo — how many of your defined tokens are referenced in that repo's source files. Tokens that no connected repo references are listed as deprecation candidates, so you can clean up your design system before publishing a new release. ---
March 25, 2026
Component pages now show which tokens each component uses
Each component's documentation page now includes a Design Tokens section listing every token the component binds to, its resolved value, and a visual swatch. You can see at a glance which color, spacing, or radius tokens are wired to each component, and trace the connection back to your token definitions.
March 25, 2026
**Formulas in token values**
Numeric tokens now accept arithmetic expressions. Write `{spacing.base} * 1.5` directly in the token editor and the result previews instantly. Formulas update automatically when referenced tokens change, and circular references are caught before you save. ---
March 25, 2026
Custom domains for your public docs portal
You can now point any domain you own to your project's public docs. Add a TXT record to verify ownership, and your docs become available at that address automatically. SSL is provisioned without any extra steps. ---
March 24, 2026
**Cherry-pick token changes between branches**
You can now apply individual token changes from any branch to your current branch, without merging everything. Select the changes you want, review flagged conflicts before committing, and apply. Each cherry-pick is recorded in the audit log. ---
March 24, 2026
**Cherry-pick token changes between branches**
You can now apply individual token changes from any branch to your current branch, without merging everything. Select the changes you want, review flagged conflicts before committing, and apply. Each cherry-pick is recorded in the audit log. ---
March 24, 2026
**Components now show lifecycle status in Studio and docs**
You can now mark any component as Stable, Beta, Experimental, or Deprecated. The status appears as a badge in the Studio sidebar and the docs component list, and as a prominent banner on each component's reference page. When you pull the package with the CLI, deprecated components are listed in a warning so nothing lands quietly. ---
March 24, 2026
Published versions can now be rolled back from the changelog
The changelog page now includes a rollback action on any non-latest version. Triggering it publishes a new patch version using the older tokens and opens pull requests on all connected consumer repos. Your workspace draft reverts to match. ---
March 24, 2026
**Token migration wizard guides you through breaking changes**
When a published release removes or renames tokens, `reframe upgrade --to [version]` scans your codebase, shows you exactly where each breaking token is used, and updates the references for you. Run it with `--auto-apply` to accept all suggested renames without prompts. ---
March 24, 2026
**`reframe lint` catches hardcoded values in source files**
A new `reframe lint` command scans your source files for hardcoded colors, spacing, and font sizes that already have a matching token in your project. Each violation shows the file, line, raw value, and the token name to use instead. Run it in CI to keep hardcoded values from accumulating. ---
March 24, 2026
Component preview now reflects your token modes
Select any published mode directly in the component reference to see how your tokens affect the preview. A "Base" option always returns the preview to its unmodified state. ---
March 24, 2026
**Preview viewport controls for component pages**
The component preview now includes a toolbar with Mobile, Tablet, and Desktop width presets. You can also type any pixel value to preview your component at an exact width. Your last selection is remembered across component pages in the same session. ---
March 24, 2026
**AI drafts your changelog from token changes**
When you open the publish dialog, you can now generate a changelog draft based on what actually changed since your last publish. The draft writes to the text field so you can edit or discard it before the release goes out. The text your team sees in the changelog timeline comes from what you publish here. ---
March 24, 2026
**Title:** Interactive prop controls in component docs
The Usage section on component pages now includes a row of controls, one per prop. Change a value and every framework tab updates immediately to show the correct snippet. The copy button copies whatever is currently shown. ---
March 23, 2026
**Token diff view: compare any two published versions**
Pick any two versions on the changelog page and see a full breakdown of what changed, which tokens were added or removed, and which were renamed. Filters let you focus on a specific change type or token category. ---
March 23, 2026
**Token rows now show framework usage snippets**
Each token in the docs portal now has an expand button. Open it to see the CSS variable, JavaScript import, and Tailwind class ready to copy into your project. ---
March 23, 2026
**Keyboard shortcut reference added to the Studio**
Press `?` anywhere in the Studio to open a full shortcut reference. The overlay lists every active shortcut across navigation, token editing, and canvas, grouped so you can scan it at a glance. `Cmd+Shift+?` opens it even when a text field is focused. ---
March 23, 2026
**Figma plugin now syncs when you publish**
When auto-sync is on, the plugin applies the latest Studio tokens automatically after a library publish. If any Figma variables were edited locally since the last sync, a banner shows the conflict count so you can choose to accept the Studio values or keep your local ones. No manual sync needed for routine releases. ---
March 23, 2026
**Token value format constraints**
Project settings now include a format constraints section where you can define a regex pattern and error message for any token type. Tokens whose values don't match the pattern are flagged inline as you edit, and publishing is blocked until all violations are resolved. Alias values are never flagged — only literal values are checked against constraints. ---
March 23, 2026
Renaming a group now updates every token and alias that references it
Right-click any group header in the token table and choose "Rename group." Every token path under that group is updated, and every alias pointing to those tokens is rewritten to match. The change is recorded in undo history, so Cmd+Z restores the previous state in full. ---
March 23, 2026
**OpenAPI spec now available for the v1 API**
The v1 REST API now has a machine-readable OpenAPI 3.1 spec at `https://app.reframeui.com/api/openapi.json`. Import it into Swagger UI, Postman, Speakeasy, or any compatible toolchain to generate clients or explore the API interactively. All 13 v1 endpoints are covered, including authentication schemes, request bodies, and response shapes. ---
March 23, 2026
**Title:** Configure SSO for your workspace in org settings
Enterprise workspaces can now connect a SAML 2.0 or OpenID Connect identity provider directly from workspace settings. Upload your IdP metadata file to auto-populate the configuration, test the connection, then enable SSO when your team is ready. Workspace owners control the setup and can disable it at any time without removing member accounts. ---
March 22, 2026
Token descriptions now appear in the docs portal
When you add a description to a token, it shows up in the public docs portal alongside the token's name, value, and type. Descriptions are also searchable, so teams browsing the docs can find tokens by how they're meant to be used, not just by name. ---
March 22, 2026
**Revert a merged branch from the audit log**
Merge entries in the project audit log now show a "Revert merge" button. Click it to create a new branch pre-loaded with the exact inverse of the original changes, ready to review and publish. ---
March 22, 2026
**GitHub connections can now be repaired without removing the repo**
If a consumer repo loses its GitHub connection, you can now reconnect it without deleting the record or losing sync history. Click "Reconnect repo" in the Consumers tab, run the CLI command in your consumer repository, and reinstall the GitHub App. All previous sync data, notification settings, and pending PR state are preserved. ---
March 22, 2026
Org-level webhooks for cross-project events
You can now create webhooks at the workspace level that receive events from all your projects in one place. Each delivery shows which project triggered it, so your integrations have full context without registering a webhook per project. Available to workspace owners in Settings.
March 22, 2026
Project filter added to the org audit log
The audit log now shows which workspace each event belongs to. Filter by project to see only the activity that matters to you, and combine it with the existing type, member, and action filters to narrow down exactly what you're looking for.
March 22, 2026
**Token edits are protected when you navigate away**
Your drafts save automatically as you edit tokens. If you navigate to another section with unsaved edits, a confirmation appears before you leave. You can leave with your draft intact or discard it to start fresh.
March 22, 2026
**Branch descriptions give reviewers context before merging**
You can now add a description when creating a branch. It shows in the branch header, the merge confirmation, and the merged notification so reviewers understand the intent before they look at a single token diff. Descriptions can be edited at any time from the branch header. ---
March 22, 2026
**Alias warnings added to the import flow**
When an import would leave tokens with no value, the import modal now shows which tokens are affected before anything is saved. You can remap all of them to a different token in one step, or import anyway and resolve them manually. ---
March 22, 2026
**Title:** Enforce token naming rules before publish
Set naming rules on any workspace to keep token paths consistent across your design system. Rules run automatically: violations appear inline on each token row and block publish until they are resolved. Add rules by token type or across all tokens using required prefixes, required patterns, or prohibited patterns. ---
March 22, 2026
**Title:** Pre-publish token health check added
Before publishing, the publish dialog now shows a snapshot of three quality signals: tokens without descriptions, deprecated tokens still referenced by active aliases, and aliases pointing to tokens that no longer exist. Each issue links directly to the token editor. Publishing is not blocked — the panel is there to help you spot drift before it reaches your consumers. ---
March 21, 2026
**Added a Getting Started page to every project's docs**
Consumer docs now include a Getting Started page for each project. It shows the install command, a CDN snippet, and a basic usage example, pulled from the published package. If a project hasn't been published yet, the page tells you what to expect once it is. ---
March 21, 2026
**Project dashboard now supports sorting and filtering**
The project grid on the dashboard can now be sorted by last modified date, last published date, or name. A filter lets you narrow the view to published or unpublished projects. Both controls work together with search. ---
March 21, 2026
**Token search added to the consumer docs portal**
The published token table now has a live filter. Type any part of a token name, value, or type and the table narrows immediately. Teams sharing their design system docs no longer need to scroll through hundreds of tokens to find what they're looking for. ---
March 21, 2026
**Token reference now shows any published snapshot**
When viewing the consumer docs portal, you can now pick any published version from the sidebar and see the exact token values from that snapshot. A banner at the top of the Token Reference page confirms which version you are viewing, with a link back to the current state. ---
March 21, 2026
**Token reference now shows any published snapshot**
When viewing the consumer docs portal, you can now pick any published version from the sidebar and see the exact token values from that snapshot. A banner at the top of the Token Reference page confirms which version you are viewing, with a link back to the current state. ---
March 21, 2026
**Set notification preferences per workspace**
You can now override notification settings for individual workspaces in your account. Each workspace has independent controls for publish alerts and branch notifications, with a Default option that inherits from your global settings. Find these in Account Settings under Notifications. ---
March 21, 2026
**Your workspace now explains what changed after a plan drop**
When your workspace moves from Pro to the trial plan, a banner on the billing page lists exactly which capabilities are now limited, including token count, seat access, and consumer connections. Dismiss it once you've reviewed the changes, and it won't appear again. ---
March 21, 2026
**Conflict status now visible in the branch list**
Each branch in the branch menu now shows whether it can merge cleanly. A green checkmark means no conflicts. A conflict count tells you exactly what needs resolving before you merge. ---
March 21, 2026
**Invite anyone with a shareable link**
You can now generate a join link from the Members tab and share it with anyone who has a ReframeUI account. No email address required. The link stays active until it expires or you revoke it, and you can set the role before generating. Revoke any link from the pending invites list at any time. ---
March 21, 2026
**Branch docs previews are now shareable**
Every branch now has a preview URL for its docs portal. Share it with stakeholders before merging and they see the updated token state without needing access to the workspace. Component definitions show the current workspace state, since components are not tracked per branch. ---
March 21, 2026
**Custom branding for your docs portal**
You can now set a display name, accent color, and logo for each project's consumer docs portal. Go to your project settings, find the Branding section, and the changes show up immediately for anyone visiting the portal. ---
March 21, 2026
**Token descriptions in the editor and docs portal**
You can now document the intent and usage constraints for any token directly in the editor. Descriptions appear in the docs portal alongside each token's path and value, so consumers know not just what a token is but when to use it. Bulk editing lets you write one description across all selected tokens at once. ---
March 21, 2026
Admin can now reset a user's two-factor authentication
When a user is locked out or has lost access to their authenticator, admins can clear their 2FA enrollment from the user detail page. The user receives a notification email with a link to re-enroll, and the action is recorded in the audit log. ---
March 20, 2026
**Added a PR description field to the publish flow**
When you publish, there is now a dedicated field for the message that appears in each consumer repository's pull request. Fill it in with the reason for the change — for example, which brand decision or product update drove it. Previously, consumer PRs showed the raw token diff. Now your team sees the context they need to review and merge confidently. ---
March 20, 2026
**Self-serve account deletion and data export**
You can now download a copy of all your token definitions, project history, and account data from the Security settings page. If you need to close your account, you can do that from the same page without contacting support. ---
March 20, 2026
**Alias cycles are caught before they're saved**
The alias input now warns you when an assignment would loop back to the current token, and blocks saving until you choose a different target. Tokens already caught in a cycle show a warning badge in the token table. Both checks run automatically as you work.
March 20, 2026
Two-factor authentication is now available
Secure your account with a time-based one-time code from any authenticator app. Once enabled, you'll be asked for a code each time you sign in. Ten single-use backup codes are provided at setup so you can still access your account if you lose your device. ---
March 20, 2026
**Active sessions now show device and location**
Your Security settings now list each active session with the device, browser, and location it came from. Remove sessions you no longer need directly from the list. Your plan sets a limit on active sessions, and if you reach it, you will need to remove one before signing in on a new device.
March 20, 2026
**Workspace audit log now tracks member and key changes**
The workspace audit log captures every admin action taken outside of individual projects: member role changes, invitations sent or cancelled, and API keys created or revoked. Find it under workspace settings. Existing project-level audit logs are unchanged. ---
March 20, 2026
**Title:** Theme inheritance is now available in the editor
You can now set a parent theme directly from the Inheritance tab inside any theme's mode editor. Tokens you don't override in the child theme are inherited from the parent. Circular references are flagged before you can select them. ---
March 19, 2026
**Figma connection status now visible in Studio**
The Export panel and Connections tab now show whether your Figma Plugin is connected. If the connection is lost, a prompt appears so you can restore it without digging through settings.
March 19, 2026
**Alias conflicts surface before you delete tokens**
When you delete a token that other tokens reference as an alias, a warning now appears before anything is removed. You can point those dependents to a different token, or delete and address the broken references later. ---
March 19, 2026
**Billing page now shows your current usage**
The billing page shows how many Studio seats, consumer seats, and tokens your workspace is using against your plan. Usage bars highlight when you're approaching or at a limit, so you can plan upgrades before hitting a wall.
March 19, 2026
**See exactly what an import will change before it lands**
The import flow now shows a full diff before anything is saved. Added tokens, modified tokens, and conflicts each appear in their own section, with current and incoming values side by side. Nothing is written until you review and apply. ---
March 19, 2026
Changelog now available in consumer docs portals
Published design systems now include a changelog page. Open any consumer docs portal, go to Changelog, and see every release with its version number, bump type, date, and breaking changes called out separately. ---
March 19, 2026
**PR status now visible in Consumer Repos settings**
The Consumer Repos settings table now shows the current state of any open pull request: Open, Draft, Merged, Closed, or Checks failed. When a PR merges, the link clears automatically and a Merged badge appears in its place. No manual tracking needed.
March 18, 2026
**Color palette tools added to the token editor**
When editing a color token, you can now generate a full palette scale from a base color, check WCAG contrast ratios across your token set, and map scale steps to semantic slots. The minimal color picker stays as the default view. Expand into the palette tools when you need them.
March 18, 2026
**Webhook signing secrets can now be rotated**
Webhook owners can now rotate a signing secret from the webhook settings without deleting and recreating the webhook. The new secret appears once after rotation — copy it before dismissing. The old secret stops working immediately, so rotate only when your integration is ready to update.
March 18, 2026
**API keys now support read-only permissions**
You can now set permissions when creating an API key: read-only or read & write. Read-only keys can fetch org and project data but cannot publish or make changes. Existing keys keep their current access. Set the right permission level from the API Keys settings page. ---
March 18, 2026
**AI agent is now gated to Team plan**
Free workspaces no longer show the AI agent button. The pricing page now includes a full feature comparison so you can see exactly what each plan includes before upgrading. If your workspace is on Team plan, nothing changes.
March 18, 2026
**AI agent is now gated to Team plan**
Free workspaces no longer show the AI agent button. The pricing page now includes a full feature comparison so you can see exactly what each plan includes before upgrading. If your workspace is on Team plan, nothing changes.
March 17, 2026
**GitHub App disconnections now notify workspace owners**
When the GitHub App is removed from an installation or a repository is disconnected, owners in the affected workspace now receive an in-app notification. The notification links directly to the affected repository so you know exactly what needs to be reconnected.
March 17, 2026
**Tokens now have their own docs page**
The consumer docs portal now includes a dedicated Tokens section alongside Components. Browse every published design token grouped by category, with its full path, type, and value visible at a glance. Reach it from the project overview or directly at `/{org}/{project}/tokens`.
March 17, 2026
**Webhook failures now trigger an email alert**
When a webhook delivery fails after all retries, owners and editors on the project now receive an email. The email includes the event type, delivery ID, and a link to your webhook settings. Turn off these emails any time from the unsubscribe link in the footer. ---
March 17, 2026
**Title:** Docs portal now has a project overview page
When you visit a project's docs URL, you land on an overview page instead of a 404. It shows the package name, version, and component count when available, and links directly to the component reference. The overview renders even before any components are published.
March 17, 2026
**Title:** Export Formats reference page added to docs
ReframeUI now has a dedicated reference page for all seven token export formats. For each format, you get a description of when to use it and a representative output example. Find it under Export Formats in the docs navigation.
March 17, 2026
Send a test event to any webhook from the settings page
When you need to verify a webhook is wired up correctly, you can now send a test event directly from the webhook row. The delivery appears in the log immediately, with the HTTP status from your server so you know exactly what happened.
March 17, 2026
**Import format reference added to docs**
The docs now include a dedicated reference for all nine token formats ReframeUI accepts. Each section shows a minimal valid input example and notes any known limitations. Find it under Import Formats in the docs navigation.
March 17, 2026
**Title:** Webhooks reference docs corrected and expanded
The Webhooks reference page now shows accurate payload examples for all four event types, with the correct flat structure. The request headers section documents `X-Delivery-Id` for deduplication, and a new managing webhooks section covers all five REST endpoints. The retry count wording has been corrected to reflect the actual behavior: 1 initial attempt plus up to 3 retries.
March 16, 2026
**Title:**
``` Webhook signing header renamed to X-ReframeUI-Signature ``` **Body:** ``` The header carrying the HMAC-SHA256 signature on outgoing webhook requests is now X-ReframeUI-Signature instead of X-Signature-256. Update your verification code to read the new header name. The signature format (sha256=<hex>) and the verification method are unchanged. A new docs page at /webhooks covers the full verification flow with a code example. ``` --- > **Note to developer:** The header rename is a breaking change for any existing webhook consumer. The changelog entry flags this directly. Consider whether existing webhook subscribers need a migration notice in the app (for example, a banner in the webhook settings panel). That copy is not in scope of this spec but worth raising with PM.
March 16, 2026
**Published version history is now visible in Studio**
The Version history panel in the toolbar lists every published release, newest first. Expand any version to see which tokens were added, modified, or removed, and restore a previous snapshot if a release introduced values you want to roll back. Component bindings and mode configuration are not affected by a restore.
March 16, 2026
**Title:** Search added to the docs
The docs now have full-text search. Press `Cmd+K` (or `Ctrl+K` on Windows and Linux) from any page to open the search panel. Results show the matching section and a text excerpt so you land in the right place without scanning the full page. ---
March 16, 2026
**Visual before/after diffs now appear in change summaries**
When you publish, ReframeUI now captures screenshots of your components and compares them to the previous release. Any variant where the rendering changed appears in the pull request as a before/after image pair, grouped by component. Your consumers see exactly what shifted before they merge. ---
March 16, 2026
Connected repos settings now on a dedicated page
Managing connected repos has moved to its own settings page at Settings, then Connected Repos. The main settings page now shows a summary with a direct link. Nothing about how repos sync or receive updates has changed.
March 16, 2026
Webhook management now has its own page
Webhooks are now managed on a dedicated page in your workspace settings, separate from general settings. Owners can also edit an existing webhook's URL and event subscriptions directly from the list, without deleting and recreating it. ---
March 15, 2026
**Prop descriptions now editable in the component drawer**
The component drawer in Studio v2 now includes a Prop Documentation section. For each prop in a component, you can write a description and set a default value directly in Studio. Descriptions appear automatically in the docs portal prop table on the next publish. ---
March 15, 2026
**Consumers tab added to project settings**
You can now see every repo connected to your design system from the project settings page. Each row shows sync status at a glance, lets you open any pending PR, and gives you a one-time command to connect a new repo directly from the CLI. Owners can remove a consumer from the same view.
March 15, 2026
**Title:** Public docs portal for your design system
Share a read-only view of your published tokens, components, and changelog with anyone — no login required. Turn it on in project settings and send the link to your consumers, stakeholders, or open-source community. ---
March 14, 2026
**REST API Reference now in docs**
The full v1 REST API is now documented under API Reference in the sidebar. All ten endpoints are covered: authentication schemes, request parameters, response shapes, and curl examples. If you are building an integration or want to understand what the CLI does under the hood, start here.
March 14, 2026
**Solid.js integration docs are now available**
The docs now include a full Solid.js integration guide covering installation, token setup, typed component usage, and reactive theme switching. If you're building with SolidStart or a Vite/Solid project, the integration page has everything you need to get started.
March 13, 2026
**Svelte integration guide added to docs**
The Integrations section now includes a full Svelte setup guide. It covers installation, CSS token injection, component imports, TypeScript support, mode-switching patterns, and staying up to date with new releases. Works with SvelteKit and plain Vite/Svelte projects.
March 13, 2026
**Title:** Consumer repos now receive publish notifications
When you publish a new version, registered consumer repos with a notify email get a message with the changelog and a link to the diff. You control this per repo from the project settings page. Repos can be paused individually without removing them. ---
March 13, 2026
**Published component reference docs from your design system**
Reference pages for every component in your design system are now generated automatically from your published design system. Each page includes a props table, event and slot references, and ready-to-paste code for React, Vue, Angular, Svelte, and Web Components. Access them at your project's docs URL whenever you publish. ---
March 13, 2026
**Token integrity checked before every publish**
When you publish a release, ReframeUI now verifies the output before it reaches the CDN. If a token is missing from the generated output or contains an unresolved reference, the publish is blocked and you get a specific error pointing to the exact token. Nothing lands until every token resolves cleanly. ---
March 13, 2026
**Web components now work in server-rendered apps**
Your component package now includes a server rendering path. Import from the server entry and components render with styles inlined — compatible with Next.js App Router, Remix, and any SSR framework. A polyfill for older browsers ships alongside and takes under 1 KB. ---
March 13, 2026
**Edit multiple tokens at once from the token list**
You can now select two or more tokens and act on all of them in one step. The action bar appears at the bottom of the token list whenever multiple tokens are selected, with options to delete, move to a group, reassign an alias, or set a mode override across the whole selection. Changes apply immediately and roll back automatically if anything fails.
March 13, 2026
API key revocation now requires confirmation
Revoking an API key is irreversible, so the action now requires an explicit confirmation step. A dialog shows the key's name before anything is deleted, giving you a clear moment to verify before access is cut off.
March 13, 2026
**Trial workspaces now show a clear collab upgrade prompt**
Previously, opening the Studio on a trial workspace would silently skip the real-time connection with no explanation. Now a modal appears that explains what's missing, confirms your work is safe, and gives you a direct path to upgrade. Solo editing continues to work without interruption whether you upgrade or dismiss. ---
March 13, 2026
AI can now rename your project, themes, and modes
Ask the AI to rename anything in your project settings and it will show you exactly what changes before anything is applied. Review the before-and-after, then approve or dismiss. Nothing changes until you say so.
March 13, 2026
**AI can guide you to the right docs section**
Ask the AI a how-to question and it can point you directly to the relevant documentation. A card appears in the chat log showing which section it found, with a button to open it. The docs overlay opens at that section and highlights it so you land exactly where you need to be.
March 13, 2026
**AI can now propose branch actions in the chat panel**
Ask the AI to create, merge, or delete a branch and it will show you a proposal card before anything changes. Each action requires your approval, so nothing runs until you confirm it. Conflict resolution still happens in the Branch menu when needed.
March 12, 2026
**Token changes suggested by AI, approved in one click**
The AI assistant now proposes concrete token changes inline, showing exactly what will update before anything is applied. Review the before and after values, read the explanation, and approve or decline. Nothing changes in your design system until you say so. ---
March 12, 2026
**AI assistant moves into the studio panel**
The floating chat icon is replaced by an AI panel inside the studio. Open it from the toolbar or press ⌘/ (Mac) or Ctrl+/ (Windows) to ask questions about your design system without leaving your work. Suggested prompts appear when the panel is empty so you can get answers faster. ---
March 12, 2026
**Title:** Motion tokens are now editable in Studio v2
Design your animation timing and easing values directly in the studio. Set durations for fast, base, slow, and slower interactions, pick from standard easing presets or write a custom curve, and preview the animation inline before publishing. All motion values are included in CSS, Swift, and Android output automatically, with a reduced-motion override generated for you. ---
March 12, 2026
**Real-time notifications in the Studio**
You now get notified directly in the Studio when a version is published, a branch is merged, a team member joins, or a webhook delivery fails. A bell icon in the top bar shows your unread count. Open it to review recent activity and dismiss what you've seen.
March 12, 2026
**Token release webhooks**
You can now register webhooks on any project to receive a signed HTTP POST when tokens are published, branches are merged, or members are invited. A delivery log in your project settings shows the status of every call, including failures and retry attempts. ---
March 12, 2026
**Title:** Activity log added to project settings
Every change to tokens, components, modes, branches, and project settings is now recorded in one place. Open the audit log from your project's settings page to see who changed what and when, with before-and-after detail for each edit. ---
March 11, 2026
**Child themes now inherit from a parent theme**
You can now set one theme as the parent of another. The child theme stores only the tokens it overrides, and everything else falls back to the parent. To set a parent, open any theme and use the 'Inherits from' selector. You can override individual tokens at any time without affecting the parent.
March 11, 2026
**Title:** Branch tokens now sync directly to Figma
Open the plugin and pick any active branch from the new branch dropdown. Figma variables update immediately to reflect that branch's token state, with branch overrides layered on top of production. Turn on Live sync and changes made in Studio appear in your Figma file within seconds. ---
March 11, 2026
**Browse and switch components from a sidebar**
The components canvas now includes a collapsible sidebar listing every saved component in your workspace, grouped by type: Atoms, Primitives, and Components. Click any entry to load it onto the canvas. If you have unsaved changes, you'll be asked to save or discard before switching. Use the search input to filter by name, or create and duplicate components directly from the sidebar toolbar. ---
March 11, 2026
Agency accounts now available without contacting sales
Team accounts can now upgrade to an agency account directly from the billing settings page. Your existing design system converts to your first client workspace, and you can add more from the dashboard. Each client workspace is billed at $35/month, added to your subscription at upgrade. ---
March 11, 2026
**Pending invitations now visible and revocable**
Open invitations now appear in your workspace's Members settings before they're accepted. You can see who was invited, their role, and when the invite expires. Revoke any pending invite from the same view. ---
March 11, 2026
**Your design system is now an npm package**
Your published design system is now available as a private npm package. Add a one-line registry config to any project, install the package, and your tokens are live — no file copying, no manual updates. Future publishes update the package version automatically. ---
March 11, 2026
**Live component previews on the canvas**
Layers on the component canvas now show a live preview of your published components instead of placeholder boxes. Each layer loads your design system bundle and renders the actual custom element, with token bindings applied as styles. If you haven't published yet, each layer shows a 'Publish to preview' prompt so you know exactly what to do next. ---
March 10, 2026
**Preview publish changes before going live**
You can now run `reframe publish --dry-run` to see exactly what would change before it reaches your team. The preview shows added, modified, and removed tokens and components, flags any breaking changes, and reports the estimated bundle size delta. If breaking changes are found, the command exits with a non-zero status so CI pipelines can catch them automatically. ---
March 10, 2026
**Title**
``` First blog post: when tokens lie ``` **Description** ``` The ReframeUI blog is live. The first post explores why design systems break when components read raw values directly, and what a semantic alias layer actually prevents. Find it at reframeui.app/blog. ``` ---
March 10, 2026
First blog post: when tokens lie
The ReframeUI blog is live. The first post explores why design systems break when components read raw values directly, and what a semantic alias layer actually prevents. Find it at reframeui.app/blog.
March 10, 2026
**Project settings and account details, now in one place**
The settings modal in Studio has been rebuilt. You can now rename your project, update your display name, and delete a project directly from the gear icon in the top bar. Destructive actions require you to confirm by typing the project identifier, so there are no accidental deletions. ---
March 10, 2026
**Docs panel now opens from the top bar**
Clicking Docs in the studio top bar now opens a dedicated side panel instead of placing content in the floating drawer. The docs panel sits above the rest of the UI and can be closed with the button or the Escape key, leaving your work exactly where you left it.
March 10, 2026
**Title:** Token modes: override values per theme
Modes are now available in the Studio. Add a light mode, a dark mode, or any custom theme, then override individual token values for each one. The delta view shows exactly which tokens differ from your base values, so nothing gets lost in the noise. ---
March 10, 2026
Token modes: override values per theme
Modes are now available in the Studio. Add a light mode, a dark mode, or any custom theme, then override individual token values for each one. The delta view shows exactly which tokens differ from your base values, so nothing gets lost in the noise.