1 April 2023
Download v1.14.1
Unlock the releases by purchasing a license

1.14.1 patch improvements

  • Fixed the Tailwind CSS import path when imported from the root package folder

There were a lot of questions about if it's possible and if it's a good idea to use Tailwind CSS together with Reshaped. We've always thought that it's a great idea and lets our users use css utilities when they need to get outside the Reshaped scope and build something custom.

Today, we're making it much easier to do this. Starting with v1.14, you can import a theme config for Tailwind CSS right from our package and get access to the same design tokens you had access in your CSS.

const { getTheme } = require("reshaped/tailwind");
module.exports = {
theme: getTheme(),

What makes it special is that you won't need the dark: variant to implement the dark mode. All colors resolve automatically, same as when you're using our components.

If you purchase multiple seats for your license, you can now let others create individual accounts with their own credentials attached to your Reshaped license. As an admin, you can choose when invites are enabled for the license, see everyone using the license and remove their access if needed.

We're getting closer to the v2.0 alpha build with Figma library moving to the test phase. All the components have been reviewed and updated from the ground up to work better with auto layout edge cases, support better composition and use the most out of the component properties.

We now start to work on the React implementation of the same change and you can expect a beta version ship for both design and code in May. At that point we'll be waiting for the Figma Config announcements before we release a stable 2.0 release.


  • Fixed empty space in bordered tabs, when scrollbars are enabled in the system
  • Fixed an edge cases with scrolling added to the tabs with equal width items
16 February 2023
Download v1.13.2
Unlock the releases by purchasing a license

1.13.2 patch improvements

  • Fixed access to the theming CLI

1.13.1 patch improvements


  • Fixed insetBottom styles applied incorrectly
  • Added support for the divided property used together with the column layout



  • Moved away from the exports field in package.json to keep support for all bundlers and frameworks

1.13.0 release

We've added a new hook that supports the same responsive syntax as other components do for layout styles. It uses the matchMedia browser API to resolve the value of the currently used viewport size.

Since we browser viewport size is available only on the client-side, we're also providing a way to pick a default fallback value during the server-side rendering. It can be used either for the most used viewport size or together with user-agent detection.

function Example() {
const backgroundColor = useResponsiveClientValue({
s: "neutral",
l: "primary",
return (

To reduce the amount of nested components and solve edge cases of using AspectRatio``, we've exposed the aspectRatioprop directly onView. Alongside with that, we're deprecating the AspectRatio` utility. It's staying in the package for now and will be removed in the next major release.

aspectRatio={16 / 9}


  • Fixed and improved its internal handler storage logic for cases when multiple hotkeys are used on the same page


  • Added support for switching between themes with a useTheme hook when Reshaped provider is using defaultTheme property

Framework and bundlers integrations

  • Fixed type definitions for the cases when Reshaped is imported as a pre-build webpack bundle
  • Added postcss support to the Remix starter
  • Fixed errors when using Reshaped components from Next 13 app directory server components
29 January 2023
Download v1.12.0
Unlock the releases by purchasing a license

We've added a new useHotkeys hook for handling application shortcuts and general keyboard interaction. Since we already have Reshaped provider for working with the global application state, we use it to optimize event handling.

We handle a lot of small edge cases regarding how keyboard events work and how pressed keys combination are handled natively, so we recommend using this hook every time you want to add keyboard navigation to your components or product features.

With the new direction property you can now decide to stack tab items vertically. It works great when you want to switch page content and display menu items in a sidebar.


  • Added elevated property for action bars rendered above the page content
  • [Figma] Updated auto layout for all variants to use fixed width


  • Added displayStyle property to change the display css value that is applied to the component when it's visible


  • Added a new headless variant that removes most of the styles from the Popover.Content


  • Added support for adding non-interactive elements inside the Tabs.List


  • Updated to use relative position by default


  • Added base reverse and elevated reverse shadow tokens to support shadow display on the top side of the elements
  • Added slot utilities for easier layout composition. Check more about it in our new Figma core concepts documentation page
  • Updated variants layout for the most of the components using the PropStar plugin


  • Added documentation for the recently released CSS modules support in Remix, which now allows you to use our ESM build
  • Added documentation about a few Figma core concepts we use when building Reshaped components
  • Updated Dismissible utility documentation with an interactive example
13 January 2023
Download v1.11.0
Unlock the releases by purchasing a license

We've shipped a new Timeline component for displaying lists of data in chronological order. It's built using compound components in code and consists of composable items in Figma, to let you easily build and maintain them in your product.

We've added dynamic resolving for different types of properties setting width and height of the elements. Before this release, you could see that some of the component properties, like padding or gap were using values as unit design tokens. For example, padding={4} would resolve to 16px in the default theme. width and height properties were outliers working with literal values, in order to support values like 100% or 50vh.

In this release we're adding number support for the properties defining the size of an element. It means that you can use still use it as before, but you can also pass a number value to automatically resolve it to a unit design token. This is especially helpful for smaller elements, where you wouldn't want to hardcode a specific px value.

This approach still works with the responsive syntax and it lets you use unit values for one viewport and literal values for another.

width={{ s: "100%", l: 25 }}

View received support for working with its positioning without writing custom CSS. We've added new position and zIndex properties to handle how components are rendered relatively to each other, as well as a set of inset properties to control their coordinates.

Inset is the name of the vanilla CSS property when working with logical CSS properties, that helps you work with positioning for both LTR and RTL languages

<View position="absolute" insetTop={2} insetEnd={2}>
<Button icon={IconHeart} />


  • Optimised styles by removing custom responsive size implementation
  • [Figma] Auto layout fixed when used with instance swapping


  • Added number values support for width


  • Added literal values support for size
  • Added support for using icons directly inside AspectRatio
  • [Figma] Auto layout fixed when used with instance swapping


  • Added number values support for width and height


  • Added number values support for width and height


  • Added responsive syntax support for borderRadius
  • Added number values support for height, width, maxHeight and maxWidth


  • Split View properties documentation into separate groups
  • Added an interactive playground for the flex properties

Source code

  • Added a test setup for the newly added internal style utilities
  • Updated the package structure to use exports field in package.json and reduce the noise in the repository after building the project
23 December 2022
Download v1.10.0
Unlock the releases by purchasing a license

We've shipped a new Skeleton component for displaying animated content placeholder while data is still loading. It's built to be easily composed with other components and achieve layouts of any complexity. Additionally, its documentation comes with multiple examples of how skeletons can be used in the products.

Reshaped semantic tokens are aiming to provide a limited number of tokens that should cover most of the use cases for building interfaces. However, there will always be edge cases where semantic tokens might feel limiting. For example, imagine you're building a chart component. You need a few custom colors for it but you also want to make sure they support dark mode the same way all Reshaped components do.

To address this, we've added support for adding custom design tokens to the theme definitions:

const config = {
themes: {
productTheme: {
color: {
foregroundNeutral: { hex: "#1a1a1a", hexDark: "#fff" },
chartTomato: { hex: "#ff6347", hexDark: "#b8412c" }


  • Fixed active accordion seeting height on mount


  • Fixed responsive padding property not applying correctly
  • Added circular radius support
  • Added disabled and disabled faded background color support
6 December 2022
Download v1.9.0
Unlock the releases by purchasing a license

TextField, TextArea and Select components now support large and xlarge sizes and Button component has also received supported for xlarge size. With these additional values, you're now more flexible when building landing pages or other marketing material without overriding any of the components styles.

All these properties support responsive syntax, which means you can change these components sizes based on the device viewport.

  • Started reusing more internal styles across the components, which has reduced the overall bundle size of the library


  • Figma: Moved elevated variant to a boolean property


  • Added large size support to use together with the new form fields sizes


  • Updated error state to match the field border width
  • Updated focus state to take less space inside the field
  • Figma: Moved show label variant to a boolean property


  • Updated error state to match the field border width
  • Updated focus state to take less space inside the field
  • Figma: Moved show label variant to a boolean property


  • Updated error state to match the field border width
  • Updated focus state to take less space inside the field
  • Aligned start and end slots horizontal and vertical padding
  • Figma: Moved show label variant to a boolean property


  • Aligned icon position across all color variants


  • Updated bleed property to correctly restore border radius when disabled based on the viewport
15 November 2022
Download v1.8.0
Unlock the releases by purchasing a license

We've shipped a new Accordion utility for toggling visibility of the content areas with automatic support of its height animation. It supports any type as content as well as it lets you use any component as a trigger.

Components documentation have received an update with updated demo sections. Instead of showing static examples of how components look like, documentation now includes interactive knobs for trying out different combination of component properties values. That should help you see how component behaves without reading the whole article.

Check out the components documentation to see it in action. For example, you can start with a Button component as an example of component with many different visual properties.

With the v13 being released now, Next.js supports a new way to build routes with the app directory. One of the changes relevant for UI development that happened there was introduction of global css imports support inside node_modules folder. That means that Reshaped now works with Next without any webpack config customisations or additional plugins.

In this release, we've added a few improvements to align with the changes introduced in the latest Next.js major and have published a new starter example for Next.js 13, as well as we have updated its integration docs.

  • Backdrop: Added a new transparent flag to hide the background and make the content behind it interactable
  • Badge: Fixed z-index of the badge when used with Badge.Container content that already has its own z-index defined
  • Breadcrumbs: Limited minimum amount of defaultVisibleItems to 2 items
  • MenuItem: Fixed the combination of disabled and selected state hover effects
  • Modal: Added a new transparentOverlay property
  • Popover: Updated position calculations for the cases when it's rendered in a fixed position element on the page
  • Popover: Added ref to the attributes to automatically inherit the trigger element styles
  • Tabs: Fixed tabs container width for the cases when it was not taking full size of the parent
  • Tabs: Fixed icon gap when using Tab.Item without any text content
  • TextField: Added small vertical padding for start and end slots
  • Toast: Updated z-index to be displayed on top of the Backdrop and its content
  • View: Added support for individual padding properties, including responsive syntax support: paddingTop, paddingStart, paddingEnd and paddingBottom
  • Focus trapping: When releasing the focus, we now prevent the page from scrolling for mouse users if the focus target is outside the viewport
7 October 2022
Download v1.7.0
Unlock the releases by purchasing a license

Looking at the different ways of how Stack and Frame utilities can be used, we have noticed that in many cases both of them are used together. Stack is solving the layout challenges, while Frame allows us to easily access design tokens for typical styles. Additionaly, they both have overlaps in terms of what they provide from the flex api.

To avoid producing more markup than needed and simplify the structure of the codebases using Reshaped, we are introducing a new utility, called View. It supports functionality from both Stack and Frame, and provides more flexibility for how its properties can be combined, including full responsive syntax support for its layout properties. Additionally, we've madded some improvements to the View API:

  • View.Item supports a gapBefore property, which is called gap in Stack.Item
  • View.Item supports a columns property, which is called size in Stack.Item
  • gapBefore now respects View.Item columns property, keeping multi-column layout predictable
  • backgroundColor now supports black value, that stays black in light and dark mode

Being the most low-level utility component, View is probaly going to be the most used component in your interfaces when using Reshaped. You can find information about the View API on its documentation page.

Stack and Frame utilities are still available in the library and are now using View under the hood. They're going to be dropped in the next major release.

We are on a path to make our documentation even more interactive and contextual. With this release, we have revamped structure of all our component pages:

  • We've split content into two tabs, providing a quick access to the properties table for every component
  • For ActionBar we've created another tab called Examples, showcasing different composition approaches for the component. We plan to do the same for all other components once we see how well ActionBar examples work for our users.
  • Each component now has a card with meta information, that previously was a part of the content and a link to its Storybook files, providing access to even more advanced examples and edge cases.
  • All Storybook files now have decorators for components, explaining the expected behaviour of every example
  • Button: Added new inherit color support for ghost variant to dynamically switch button color based on the context
  • TextArea: Updated disabled value color to align it with TextField
  • Toast: Improved focus trapping to return focus back to the trigger element only if focus is still inside the toast
  • Toast: Updated actions to use new inherit button color when possible
  • Rewritten keyboard mode to vanilla javascript to avoid additional rerenders
19 September 2022
Download v1.6.0
Unlock the releases by purchasing a license

We've shipped a new Toast component for displaying notification messages or other pieces of information above the page content. As always, we're focusing on the quality of the component and how flexible it is when comes to building custom layouts. Try out the following preview to see how it works or check its documentation to see all the supported features.

We've gone through all components and added support for responsive properties for the layout properties that were not supported before. With the new properties, you can now make every single piece of layout responsive without writing any additional wrapper components.

For example, you can make a responsive action bar with buttons changing their direction and size for mobile screens. Try resizing your browser to see how it changes its layout as you switch to movile viewport size:

<View direction={{ s: "column", m: "row" }} justify="end" gap={2}>
size={{ s: "large", m: "medium" }}
fullWidth={{ s: true, m: false }}
<Button size={{ s: "large", m: "medium" }} fullWidth={{ s: true, m: false }}>

The full list of newly added responsives properties includes:

  • AspectRatio: Added responsive ratio support
  • Avatar: Added responsive size support
  • Button: Added responsive size and fullWidth support
  • Icon: Added responsive size support
  • Loader: Added responsive size support
  • MenuItem: Added responsive size and roundedCorners support
  • Modal: Added responsive position and size support

We want to make our pricing more accessible for small and medium-sized companies, as well as to cause less confusion when it comes to deciding on the purchase of Reshaped. Therefore, we've decided to simplify our Pro license pricing and make it a one-time payment, similar to the regular license.

Purchasing a Pro license will give you lifetime access to the source code, testing, and Storybook setup, as well as unlimited seats for the library. All companies, who've purchased the Pro license using the previous pricing model, get automatically migrated to the new lifetime access with this release.

  • ActionBar: Updated large size padding to change starting with l viewport
  • Button: Relaxed props types and replaced them with runtime checks instead
  • Button: Fixed outline button styles when used with white color
  • Frame: Added shadow tokens support
  • Frame: Added transparent border support
  • Frame: Added transitions support
  • Modal: Updated focus ring to work with scoped theming
  • Modal: Optimized markup to use less elements when rendering a modal
  • Modal: Fixed scrolling inside the bottom position modal when content overflows the height of the screen
  • Aligned the name of the keyboard mode attribute with other global data attributes
31 August 2022
Download v1.5.0
Unlock the releases by purchasing a license

We've shipped a new Breadcrumbs component for displaying top-level product navigation. Components like breadcrumbs have a specific product purpose, so to still keep it white-label and not make any product decisions, it supports rendering any component as a child and lets you control how its collapsing should work.

We've launched a new umbrella website for our design system studio called Formaat. Our website is a place that connects all of our products together and we also want to use it as a platform to help teams working on design system grow. We start with a series of design system interviews with the industry experts to help you learn about how design systems are built and maintained at scale.

To help you work with Reshaped React components, we've added a new Core concepts article, explaining ideas that apply to the whole system. We cover topics like, responsive component properties, accessibility, utility components and other concepts that turn a component library into the design system.

  • Improved className property across all components with an array syntax, where you can pass multiple classes, as well working with conditionals.
// Pass conditional as a className without handling it outside
<View className={foo && 'foo'} />
// Pass arrays of classNames and we will resolve them for you
<View className={['foo', bar && 'bar']} />
  • Updated Reshaped components demo with overview of all components we have in the library
  • ActionBar: Added Figma examples
  • Button: Improved handling of icon colors when switching between variants in Figma
  • Link: Added disabled property support even when component is used as an <a> tag
  • Text: Added support for passing neutral color explicitly without having to pass undefined
10 August 2022
Download v1.4.0
Unlock the releases by purchasing a license

We've shipped a new Carousel component for displaying scollable areas with grouped content. It works with any type of content, properly handles RTL and supports responsive layouts.

  • Actionable: Added a way to set focus ring border radius value based on the child element radius
  • Card: Added support for the style attribute
  • Image: Added imageAttributes property to pass attributes only to the original image element
  • Image: Enabled cover displayMode by default
  • Stack: Added baseline items alignment
  • Frame: Added white background color support
  • Improved typings for attributes property in all components, including cases when using as property
23 July 2022
Download v1.3.0
Unlock the releases by purchasing a license

☝️ In case you have custom themes built with Reshaped, you'll have to run their build script once to make sure the typography fixes are applied.

We've built a Figma plugin that can add themes & switch to dark mode. It works locally and does it blazingly fast. It supports theming for color, text, and effects.

Our internal Storybook is finally public for everyone and is now featured in Storybook Encyclopedia. It might give you a better understanding of our internal development setup in case you're looking to purchase our Pro license.

Other improvements

  • Alert: Added bleed support for assigning negative margins
  • Button: Fixed endIcon display when both icons are passed simultaneously
  • Button: Fixed minimum size values when used in themes with smaller font sizes
  • DropdownMenu, Popover: Fixed page scrolling to the top when rendering component as active by default
  • DropdownMenu, Popover, Tooltip: Fixed animation direction when calculating content position
  • DropdownMenu, Popover: Fixed an issue with active state getting locked after switching a scoped theme
  • Frame: Added maxHeight and maxWidth responsive syntax support
  • Stack: Fixed edge cases when dividers were rendered with incorrect index
  • Tabs: Fixed selected state property in Figma in the elevated variant
  • Text: Added responsive align support
  • TextField, TextArea, Select: Updated font-size to increase 16px only for touch devices
  • Theming engine: Fixed a bug where changing font-family in a theme was not always applying correctly
  • Added missing documentation links in Figma libraries
15 June 2022
Download v1.2.0
Unlock the releases by purchasing a license

We've shipped a new Image utility for displaying images and controlling their behavior. It supports rendering image assets based on the screen pixel density and provides multiple fallback options when image asset is not available or was not loaded correctly.

Displaying a title for a menu section is such a common case and we don't want anyone to count the pixels they need for the negative margins. Because of that, we've implemented a utility that is similar to Button.Aligner. It aligns the contents of the MenuItem with the content used around it, no matter which size you use them with.

One of the core documentation parts missing before was a place to have all available components at glance. People had to literally go through every single page in the docs to see what we have in the library. In 1.2 we're finally addressing this with a revamped overview page that has previews of every single component in the library and structured access to utilities and hooks from the same page.

Other improvements


  • Button:
    • ☝️ merged regular and rounded buttons into a single component
    • ☝️reduced variants by 50% by supporting icon-start and icon-end properties
    • changed “icon” toggle to “show icon”
    • aligned icon size for several large button instances
  • Checkbox: fixed conflicting property names: value - “show value”, helper “show helper”
  • Radio: fixed conflicting property names: value - “show value”, helper “show helper”


  • Actionable: added support for non-interactive Actionable cases to avoid displaying unnecessary focus ring
  • Alert: optimized rendered markup for cases where not all Alert properties are used
  • AspectRatio: switched to using aspect-ratio CSS feature and removed unnecessary wrappers used for custom ratio implementation
  • Button: updated outline variant to use neutral-faded border color token
  • Button: added startIcon and endIcon properties instead of now deprecated icon and iconPosition to support displaying both icons simultaneously. This is not a breaking change and old behavior still works as expected.
  • Button.Aligner: added string type support for its position property
  • MenuItem: added startIcon property instead of now deprecated icon to align with other component's API. This is not a breaking change and old behavior still works as expected.
  • Popover: fixed edge cases when content was blinking for Popovers used with active by default
  • Stack: optimized rendered markup when using multiple stacks nested in each other
  • Text: added maxLines property to truncate the text based on the passed number of lines
  • TextField: added startIcon and endIcon properties instead of now deprecated icon and iconPosition to support displaying both icons simultaneously. This is not a breaking change and old behavior still works as expected.
  • Theme: fixed an issue with height inheritance that caused scope themes to take extra space on the page
  • Tooltip: added active property to support manually controlling the tooltip display


  • Prioritised two new components that now have Coming soon pages: Breadcrumbs and Toast
  • Added documentation search for the Coming soon components
  • Added integration guide for Remix and a Remix starter example in our community repoository
24 May 2022
Download v1.1.0
Unlock the releases by purchasing a license

We've shipped a new Alert component that can be used for displaying prominent messages related to the whole page or a specific area. It comes in 4 different colors, supports horizontal layout direction and works with any type of content.

☝️ In case you have custom themes built with Reshaped, don't forget to run the generation script for them to get these new tokens available in your theme.

We have added three new color tokens for faded borders. They work perfectly for decorative elements that don't need to meet 4.5 to 1 contrast ratio requirements. For example, we use these tokens ourselves in the newly released Alert component.

We've adopted the latest features that Figma announced during Config 2022: individual strokes, instance swap for icons, slot selection, text properties, boolean properties and more. This brings more control for library users as well as better alignment with code. In some cases though connection to the master component may be lost: please read through the bullet points marked with ☝️ before updating your mockups.

Action bar

  • Added slot selection in the properties panel
  • Adopted Figma's individual strokes, simplified nesting structure


  • Added a new component 🎉


  • Added instance swap for icons in the properties panel
  • Added text property in the properties panel


  • Added slot selection in the properties panel
  • Adopted Figma's individual strokes, simplified nesting structure


  • Added text property in the properties panel


  • Added instance swap for icons in the properties panel
  • Added text property in the properties panel


  • Added text property for values and helper in the properties panel
  • ☝️ Attention: detached value and helper to enable the props in the control panel


  • Added text property for values and helper in the properties panel
  • ☝️ Attention: detached value and helper to enable the text property


  • Added text property in the properties panel


  • Added slot selection in the properties panel


  • Positioned text absolutedly for “Fill” variant, simplified nesting structure


  • Added slot selection in the properties panel


  • Added icon and slot selection in the properties panel
  • Added text property for label, placeholder, value, helper, error and success messages to modify text value directly in the control panel
  • ☝️ Attention: detached label, placeholder, value, helper, error and success messages to enable the text property


  • Added text property in the properties panel
  • ☝️ Attention: added icon boolean property, this allowed deprecation of 50% of variants

Text area

  • Added text property for values, helper and error message in the property panel
  • ☝️ Attention: detached value, helper and error message to enable the text property
  • Fixed issues with auto-layout when stretching component horizontally

Text field

  • Added text property for label, placeholder, value, helper, error and success messages to modify text value directly in the control panel
  • ☝️ Attention: detached label, placeholder, value, helper, error and success messages to enable the text property
  • Added instance swap for icons
  • Added slot selection in the properties panel


  • Added text property in the property panel
  • Updated documentation for all components for easier access through the inspect panel

Text utility

  • Made it available outside of the library (previously was used as an internal atom)

Icon utility

  • Added icon selection in the properties panel


  • Removed internal dependencies in style libraries: now you shouldn't have promts that some libraries are missing

Other improvements

  • Button: Updated elevated button shadow to not change on hover
  • Frame: Added support for faded border color values
  • Hidden: Increased hidden mixin classname specificity over other component styles
  • Select: Fixed vertical text alignment issue in Firefox
  • Updated public Next.js examples and documentation to use our ESM build instead of the pre-compiled version
  • Updated source code component demo on the homepage to Modal component to better demonstrate our codebase and problems that we're solving
  • Added an endpoint for external tooling to get a list of available package versions
  • We are adding new profile panel to display everything about your purchases and give you quick access to the latest releases
7 May 2022
Download v1.0.0
Unlock the releases by purchasing a license

After two years of active development, we've finally reached an important milestone. Today we're releasing the 1.0 version of Reshaped for React and Figma and we're live on Product Hunt.

With this release, we're starting to follow our release strategy with no more breaking changes for the following year. It means that the library has reached a stable state, and you can update to any upcoming minor release in a matter of minutes.

Until June 10, we're keeping early-bird prices to celebrate the release, and we hope you enjoy using Reshaped as much as we do ourselves.

  • We have updated our Figma integration documentation, including a new section on how to handle library updates
  • Both React and Figma video demos have been updated and made more than 2 times shorter while keeping all relevant content in
  • We have added a new FAQ page and revamped the content we had previously

☝️ In case you have custom themes built with Reshaped, don't forget to run the generation script for them to get these new tokens available in your theme.

  • Design tokens: Updated backgroundPrimaryFaded value to better align it with other colors in dark mode
  • Actionable: Removed native highlight color as a part of Actionable css reset
  • Popover: Added scoped theming support for the content rendered inside the portal
  • DropdownMenu: Added scoped theming support for the content rendered inside the portal
  • Tabs: Added dynamic height support for the selected tab indicator in the pill variant
  • Card: Updated bleed property to only support numbers
20 April 2022
Download v0.21.0
Unlock the releases by purchasing a license

☝️ In case you have custom themes built with Reshaped, don't forget to run the generation script for them to get these new tokens available in your theme.

We've made a few improvements to our available color tokens to make theming support even more customisation cases:

  • Started generating on-background-highlighted color tokens separately from regular on-background ones. This allows you to completely change the background color of a component in the highlighted state while keeping it accessible for users.
  • Added new background-positive-highlighted color in order to introduce positive Button variant.
  • Updated default tokens with more vibrant default values.

We've gone through the whole library and tested everything for React 18 compatibility. To confirm that it's all working in external environments, we've also migrated this website to React 18.

React 18 was added to our package peer dependencies and you can start your project migration. However, make sure all other dependencies you use are compatible with React 18, there are a few Typescript changes that a lot of packages are catching up with.

We have updated property tables for all components and utilities to make them more scannable. They also now contain icon indicators for responsive and required properties.

  • Button: Added positive variant support
  • Checkbox: Removed unused aria-describedby attribute
  • Icon: Added attributes.style support
  • Icon: Fixed justify-content value for autoWidth icons
  • Stack: Added automatic key assignment for the Hidden children
  • TextField: Added support for iconPosition to render an icon on the end side of the field
27 March 2022
Download v0.20.0
Unlock the releases by purchasing a license

We're adding support for installing Reshaped by access tokens. Since we're not publishing the library on the public NPM, this should help 3rd party tools to easier integrate with our design system and install it as a dependency without manually downloading the system. In the future we might also explore this approach as our default way for installing the library in any codebase.

Meanwhile, if this is something you would like to see working in your tool or you want to be able to install Reshaped in your codebase - send us a message.

  • Button: Renamed outlined variant to outline to keep API consistent with Badge
  • Updated m viewport values to 661px-900px to simplify responsive design and development
  • Updated values for highlighted color tokens in the default Reshaped theme


  • Actionable: Removed default :active style
  • Button: Updated :active style to scale down on click
  • Frame: Automated on-background text colors for primary, constructive and critical Frames to keep the text contrast ratio accessible by default
  • Theme: Added className support
  • Reshaped provider: Added className support
  • Backdrop: Fixed absolutely positioned elements z-index inside Backdrop conflicting with page elements in Safari


  • Avatar: Updated an image used in the component by default
  • Badge: Updated copy for all variants to “Badge” to keep overrides while switching variants
  • Button: Updated copy for all variants to “Button” to keep overrides while switching variants
  • Switch: added interactive component support
  • Added component library version to the name to help swap libaries
14 March 2022
Download v0.19.0
Unlock the releases by purchasing a license

During the past two months we've been working on updating our brand and our brand assets. There are still a few things we're going to roll-out before 1.0 gets released but today we're shipping our renamed library and the new landing page.

We're renaming to Reshaped, which means there are a few things that are renamed in the code:

  • Name of the NPM package was changed to reshaped
  • Arcade provider is now called Reshaped provider
  • Main theme is called reshaped
  • CSS variables a new short --rs prefix instead of --arcade

We're changing our theming approach just a bit to make it work with NextJS server-side rendering. Theme definitions now rely on the data-rs-theme attribute which means you can assign it in the _document.jsx file without importing .css files.

<body data-rs-theme="reshaped-light">
  • Avatar: Added an alt property and made it render as an img tag instead of using backround
  • Button: Fixed rounded border-radius when used with size="large"
  • Card: Added responsive syntax support for the padding property
  • Container: Replaced size property with width to allow more granular control over its dimensions
  • Frame: Added base and elevated background support
  • Frame: Added responsive syntax for height and width properties
  • Divider: Added automatic aria-orientation support
  • DropdownMenu: Updated focus management to return focus back to the trigger element on pressing Tab instead of moving it to the next one
  • Loader: Added aria-label and aria-live support
  • Progress: Added duration support to make animated progress bars
  • Hidden: Added inline property for hidden text elements
  • Updated border color token values in dark mode
16 January 2022
Download v0.18.0
Unlock the releases by purchasing a license

We've updated framework integrations guidelines and moved them to a separate documentation section on the website. All example projects have been updated with the latest dependencies and their setup has been simplified.

In addition to that, we have added Gatsby starter example and documentation. Check its documentation in the Integrations sections in our docs.

In this release, we've updated the way you can add custom themes. Instead of working with createTheme and createThemeFragment functions, themes are created from an reshaped.config.js file. You can store in the root level of the repository or provide a custom path to our theming CLI.

  • Avatar: Added support for dynamic size values which means you can pass any unit token to it
  • TextField: Normalized input value suggestion style
25 December 2021
Download v0.17.0
Unlock the releases by purchasing a license

This release is the first one to include Reshaped Figma library which is available for both regular and source code licenses. Library consists of 3 files that include:

  • Figma components with variants and auto-layout that are aligned with code
  • File with design tokens for light mode
  • File with design tokens for dark mode

With the help of Figma Themer plugin, you'll be able to design your product just once and switching to dark mode will happen automatically without any manual customisation. This works not only with Reshaped components but also with any custom component you create yourself.

Along with Figma release, we're also updating our pricing tiers.

First of all, even though we're adding Figma library to the list, we're keeping our single seat license to $79 while we're getting closer to v1.0 release of Reshaped. Shortly after the release its price is going to raise to $99.

Team licenses now scale based on the amount of seats you purchase with increasing discounts which means now you get a better deal for 2-3 people teams.

On top of that we're adding two new tiers:

  • Source code, for teams building their own design system and who want to use Reshaped as a starting point and skip the whole setup phase. Additionally it could useful for front-end and design teams willing to learn new best practices and dive deeper into the internals of Reshaped for new ideas.
  • Enterprise, for companies who need more than just code and design files. We can help you with onboarding to Reshaped, in-house design system workshops, audits or other activities tailored to your needs.
  • Frame: Added support for responsive padding property values.
  • Frame: Added support for new background color values.
  • Hidden: Added visibility flag to work with CSS visibility property instead of display. This is helpful when you want to hide an element visually but keep its space reserved and avoid content jumps.
  • Hidden: Aligned responsive syntax with other components. Instead of providing from and to value, you can now use hide property with the regular responsive properties syntax.
  • Stack: Added support for multiple Stack.Item using grow in the same Stack.
  • Stack: Added support for defining Stack height.
  • Text: Added support for line-through decoration.
3 December 2021
Download v0.16.0
Unlock the releases by purchasing a license

In this release, we've updated the way we generate output of the theming engine and the way themes are used in the code. We've moved away from theme components and ColorMode utility to a single Theme component that works with both, scoped themes and color modes. This allowed us to avoid additional rerenders of the app when a theme changes and reduced the complexity of theming in general.

import { Reshaped, Theme } from "reshaped";
import reshapedTheme from "reshaped/themes/reshaped.module.css";
import productTheme from "themes/product.module.css";
const Application = () => (
<Reshaped theme={reshapedTheme}>
Reshaped theme is used here
<Theme name={productTheme}>Product theme is used here</Theme>

Library bundle

For the cases where using our ESM build output is not possible, we're now additionally providing Reshaped JS and CSS bundles. This will disable regular tree-shaking of the modules but makes it possible to use the library in environments that currently don't support CSS imports from within node_modules. However this shouldn't affect the performance much considering that current library total size is lest than 40kb including both CSS and JS.

To use the bundles, you can import them directly from the package. Note that you will need to import styles just once.

import { Button } from "reshaped";
import "reshaped.css";

Other improvements

  • Tabs: Adjusted size to align better with other components
  • Tabs: Adjusted focus selector area to better respect tab item content
  • Updated border radius values across components
  • Updated foundation names and values to align with Figma and improve default theme quality
  • Added Theme component and useTheme hook
14 November 2021
Download v0.15.0
Unlock the releases by purchasing a license

After 3 months of design work we're finalising our Figma library with all the components moving into testing phase. All components are designed with variants, auto-layout and paying incredible attention to handling composition of components the same way you would do that in code. Both React and Figma libraries are perfectly aligned so anything you can design with Reshaped Figma library - you can immediately implement in code with no problems.

Design tokens documentation

We have revamped our design tokens documentation and added visual examples for all Reshaped tokens. Every token type now has a separate page, going through their values and guidelines on how to use them.

Other improvements

  • Added Vite starter project to the installation guide
  • Backdrop: Overlay component was renamed to Backdrop utility
  • Divider: Added blank property support for easier composition with Tabs
  • FormControl: Updated label color for the disabled form fields
  • Modal: Merged with Drawer to support position property
  • Modal: Added support for custom and responsive padding values
  • Modal: Added support for custom width values
  • Overlay: Scrim was renamed to Overlay
  • Overlay: Added easing to the scrim gradient value
  • Popover: Added custom padding support
  • Progress: Added small size and white color support
  • Select: Added icon support
  • Tabs: Merged SegmentedControl with tabs. Tabs support pills-elevated now and all variants can work as a form control
  • Text field: Added icon support
30 October 2021
Download v0.14.0
Unlock the releases by purchasing a license

Documentation updates

We've made an major update to our documentation layout to let you discover the information you're looking for faster. Some of the highlights are:

  • Previews and highlights for all components and utilities
  • Navigation to similar components
  • Navigation to previous and next articles
  • Search to the side menu to filter the components, including filtering by keywords
  • Outline of the article highlighting section that are currently on the screen
  • Anchor links for specific parts of the article

Other improvements

  • Card: Add elevated card support
  • Card: Added support for custom bleed values and responsive bleed behaviour
  • Container: Added support for custom padding values and responsive padding
  • Checkbox: Updated styles for disabled checked state
  • Hidden: Update format of the function arguments when used with render props
  • Icon: Added dynamic size support. Any unit token multiplier can now be used to define the icon size
  • MenuItem: Moved from fullWidth property to roundedCorners to simplify its API
  • Radio: Updated styles for disabled checked state
  • Switch: Added built-in integration with FormControl utility
17 October 2021
Download v0.13.0
Unlock the releases by purchasing a license

Framework integrations

During the past two weeks we have been improving the Reshaped onboarding experience for some of the most popular front-end frameworks and bundles. So far we have prepared 4 starter examples for Parcel, Webpack, NextJS and Create React App as well as few demos with more advanced examples.

Figma progress

We have passed 50% of our Figma library progress with 12 components and design token library ready. Everything is already built with theming/dark mode support, using auto-layout and providing variants for every component.

If you want to track the progress, you can do that in our project board.

Other improvements

  • Actionable: Improved event handling logic
  • Avatar: Fixed icon alignment for auto width icons
  • Documentation: Added navigation for previous and next articles
3 October 2021
Download v0.12.0
Unlock the releases by purchasing a license

RGB color tokens support

When using colors as variables in CSS, you would usually hit a wall when you want to apply custom opacity values to them. The only way to combine a color variable with opacity is to use it with rgba() color function in CSS.

In order to support this case, we've added auto-generation for rgb values of the background color tokens. They use similar names to background token names with an additional rgb prefix:

var(--rs-color-rgb-background-neutral) /* 223, 226, 234 */

Note that the variable stores only the rgb values themselves but doesn't wrap it with a function. This means you can now use it together with rgba() color function in your css:

background: rgba(var(--rs-color-rgb-background-neutral), 0.5);

Other improvements

  • Avatar: Adjusted icon size in larger Avatar size, added faded colors support.
  • Button: Updated neutral Button to use inherit Loader color, added white and black colors support for rendering on media content.
  • Card: Add custom padding value support.
  • Frame: Added maxWidth and maxHeight properties.
  • Icon: Added smallest size value, added inherit size support.
  • Link: Added critical color, added icon support.
  • Select: Aligned Select height with Button height on mobile viewports.
  • Stack: Stack.Item split flag migrated to gap="auto".
  • Switch: Updated the disabled checked background color to use primary color.
  • TextField: Aligned TextField height with Button height on mobile viewports.
19 September 2021
Download v0.11.0
Unlock the releases by purchasing a license

Reshaped video demo

On the hompage, we now have a video demo for those who want to take a look of how the development process looks like. In the demo we are building a social media card with some common layouts and interactive behavior that you would usually see in your day-to-day job. Additionally, we show how theming and dark mode work with no extra effort or requirements to write custom styling logic on your side.

Chained trap focus

While building interfaces we have to implement complex behaviors like modal being opened from a dropdown. Both of these components should trap the focus and return it back to the trigger element when closed. Starting with this release with support chained trap focus. It will return the focus back to the correct trigger even if some of the trigger elements are no longer rendered on the screen.

For example, try going through the whole flow using your keyboard in the following example. Once you close the modal, focus will return to the "Open menu" button.

Hint: Click near the button first and press Tab, to focus on the button using keyboard.

Other improvements

  • Button: Elevated flag support.
  • Container: Fixed layout issues when used inside other flexbox elements.
  • DropdownMenu: Added custom width support.
  • Frame: Added support for separating vertical and horizontal padding values.
  • Stack: Stack.Item split flag support to pull an item away from the rest of the items.
  • Stack: Added automatic wrap handling for Stack.Item using grow and split with responsive values.
  • Backdrop: Darkened the background to improve the contrast ratio of the backdrop content with the page.
  • useElementId: Fixed id generation for React.StrictMode development mode.
  • Reshaped theme: Reduced the line-height of caption1 font token.
16 August 2021
Download v0.10.0
Unlock the releases by purchasing a license

New homepage

Our homepage has been completely revamped to put emphasize on the newly released features, including our recent theming engine. You can try applying one of the 3 demo themes to our whole website, including their light and dark modes.

More stack improvements

  • Stack.Item now has gap support. This comes handy when you need a list of elements with different gaps and lets you achieve that without nesting multiple Stacks in each other.
  • Stack got improved nested responsive properties support, including bug fixes for the edge cases found that were not supported before.
  • Inline and reversed flags got merged into a single direction property for better responsive properties support.
  • Vertical stack now automatically take full height of its parent to make controlling its children alignment easier.

Other improvements

  • ThemeMode: Renamed to ColorMode.
  • ColorMode: Added default foreground color reset for ColorMode scopes instead of using the global text color.
  • Hidden: Migrated to from and till properties to provide better support of responsive values.
  • Text: Added align property.
  • Text: Added text color transition for cases when parent is controlling the color value.
  • Card: Added selected flag.
  • Reshaped Provider: Improved switching between root-level themes
28 July 2021
Download v0.9.0
Unlock the releases by purchasing a license

Dynamic responsive properties

Stack is the core of any layout you build, and we want it to be as flexible as possible. Starting with 0.9.0 we are using CSS variables to work with responsive styles, and we've started with Stack component integration. Till now, we've only supported a limited number of values that you could use as gap property because its styles have been predefined in CSS. With the new responsive CSS variables, we're changing gap property to support any numerical value as a multiplier of the base unit token.

This change includes both, regular and responsive properties, which means you can pass any number you want for every viewport size:

<View gap={{ s: 2, l: 10 }} />

With this new approach, we're shipping a couple more features for the Stack component:

  • Grid is finally merged with Stack. Stack.Item now supports size property while all other properties stay the same.
  • Stack now supports responsive wrap property to control flex-wrap manually.
  • Stack.Item now supports responsive order property to control the order of items rendering.

Logical properties for RTL

We've moved away from supporting RTL during build step with a PostCSS plugin and are using CSS logical properties now instead. This takes us one step closer to moving away from CSS build step and using completely native CSS. Additionally, this update helped us improve a handful components and how they render in RTL mode.

Bundle size

We have added size-limit integration to our merge requests which lets us track all the bundle size changes as one of our main metrics. For example, even after introducing all these new features and responsive styles, we have actually reduced our total bundle size by 2kb down to 41kb.

17 July 2021
Download v0.8.0
Unlock the releases by purchasing a license

Theming Engine

We're finally releasing out theming engine, including completely typed JS API and CLI to build themes using Reshaped design tokens. Writing your theme definition once will build a React component for you that's ready to be imported into your application. Among other features its main highlights are:

  • All theming happens in build time and doesn't affect your runtime performance.
  • Dark mode is supported on the design tokens level. No need to write conditionals in your components.
  • Scoped theming support which makes it easy to use multiple themes in the same application.
  • Theme fragments which define only a part of a theme to save your bundle size

Other improvements

  • Added additional viewport boundaries checks for mobile viewports in Popover.
  • Fixed Popover with triggerType="hover" affecting how other Popovers on the page work.
19 June 2021
Download v0.7.0
Unlock the releases by purchasing a license

Reshaped demo

For this release we've built our first demo of a page using Reshaped. It's aiming to provide a publicly available example of a project setup as well as giving a hint about how building interfaces with Reshaped looks like.

  • Project repository: https://github.com/reshaped/demo
  • Deployed project: https://reshaped.github.io/demo/

Responsive properties API update

We've started supporting more scenarios for responsive development. In this release we're adding another viewport support to differentiate between portrait and landscape tablet modes. This means that our viewport media queries names have been updated accordingly:

@media (--rs-viewport-s) @media (--rs-viewport-m) @media (--rs-viewport-l) @media (--rs-viewport-xl);

To make the components easier to use with 4 viewports available, we're also switching from array notation to an object notation for the responsive properties. Since we use mobile-first approach, you don't have to define values for every viewport manually. For example, you can set the Stack gap to be x2 by default and change to x4 starting with large viewport size.

<View gap={{ s: 2, l: 4 }}>

Other improvements

  • Tabs: Fixed button animation blinking in iOS Safari
  • Popover: Improved keyboard navigation defaults for triggerType="hover"
8 June 2021
Download v0.6.0
Unlock the releases by purchasing a license

Rethinking Stack utility

We've completely rebuilt our Stack component from ground up to cover a huge number of new edge cases. Most of our focus went into improving nested stacks, edge cases for specific components and reducing the number of elements rendered per every stack:

  • Refactored the usage of children removing all unnecessary item wrappers
  • Aligned gap property naming with token names.
  • Added item grow support to divided stack.
  • Improved support for button elements rendered as direct Stack children.
  • Added support for nested Stacks with flex-wrap: nowrap.
  • Added responsive property support for Stack.Item grow.
  • Improved AspectRatio and Card default layout calculations when used in Stack.

We've also tried using the new gap API for flexbox which turned out not so well, due to the limited Safari support and some webkit bugs that have to be fixed first. Once the state of the API becomes more stable, we will immediately migrate to it.

Other improvements

  • Actionable: Added custom tag support with as property.
  • ActionBar: Added large size support.
  • Button: Removed min-width from the text button variant.
  • Container: Added size presets for its max-width.
  • DropdownMenu: Added small gaps between menu items.
  • DropdownMenu: Fixed a bug which sometimes caused dropdown menu stay open after its close was triggerred.
  • Frame: Added support for any padding value as a unit design token multiplier.
  • Link: Added color and underline properties.
  • Switch: Improved keyboard navigation support when used inside Popover and Modal.
  • Tabs: Replaced navigation arrows with fade-out for scrolling tabs on mobile.
  • Tabs: Improved the navigation arrows toggle throttling.
21 May 2021
Download v0.5.0
Unlock the releases by purchasing a license

Tabs: New variants

Tabs get 2 new variants to support new UI scenarios. borderless is helpful when it's used with parent component that provides its own border already. pills variant is used for less prominent secondary navigation.

Other improvements

  • Dismissible got min-height defined in case it has no content provided.
  • Popover got its keyboard navigation improved when it has no focusable elements in it.
  • Modal now supports title and subtitle elements to handle accessibility.
  • Backdrop now won't close when user tries to close any type of dropdown menu.
9 May 2021
Download v0.4.0
Unlock the releases by purchasing a license

Progress component

We release Progress component to the progress status for a task that takes a long time or consists of several steps. In some cases it can be used for other types of context, like displaying the score values etc.

Overlay component

We're adding Overlay component to let you build nice-looking media cards and display text content on top of them. You can find which position values it supports in the documentation.

Other improvements

  • Added HiddenVisually utility to render test applicable only for screen readers.
  • Removed Menu component in favor of MenuItem composition with existing layout components like Grid or Stack.
  • Added Button text variant that have padding around the text.
  • Removed Link icon support since that can be achieved with Button component now.
  • Add inherit color support for the TextField to use them on any background.
  • Added backgroundColor, borderColor, borderRadius and overflow for the Frame utility.
  • Improved focus trap functionality for components like Modal and Popover.
  • Added a color property for Icon when you want to override a color coming from the parent element.
  • Added an internal Portal utility that helps with managing z-index values of the components.
24 April 2021
Download v0.3.0
Unlock the releases by purchasing a license

Tabs component

We release Tabs component to let you organise navigation between multiple pages or content sections. Its compound components approach lets you easily build custom tab panels or add animation to them, and it's responsive out-of-the-box. Read more about it in its documentation.

Dropdown menu component

We're adding a DropdownMenu component built on top of Popover to simplify the process of building action menus. It works with a similar API as Popover does, however it encapsulates some of its logic, which means you don't have to pass all the right props and aria attributes to Popover manually. Read more about it in its documentation.

Other improvements

  • Popover, Tooltip: Improved the usage of accessibility attributes on their trigger and content components
  • Popover: Separated trapFocusMode and navigationMode into separate properties
  • Menu: Adjusted the gap size between an icon and content in the small Menu.Item
  • Actionable: Added a flag to apply the focus ring inside the element boundaries to make it work better with overflow: hidden parents
  • Dismissible: Simplified properties API
  • AspectRatio: Added default size styles for the img elements used inside it
  • Color design tokens: Simplified the usage of color tokens that include state
8 April 2021
Download v0.2.0
Unlock the releases by purchasing a license

Reshaped hooks

We have published and documented 6 hooks provided by the library. Together with our utility components they should close the gaps and let you build custom components using the Reshaped context data:

  • useElementId to generate ids for DOM elements.
  • useFormControl to inherit values from the FormControl utility in your custom-built form fields.
  • useRTL to control the direction of the content flow
  • useScrollLock to lock and unlock page scrolling.
  • useColorMode to switch between light and dark mode of the used theme.
  • useToggle for toggling states on and off.

Other improvements

  • Frame utility is now exposed from the library
  • Badge component received an additional wrapper support for handling Badge position and display
30 March 2021
Download v0.1.0
Unlock the releases by purchasing a license

After a year in the making, the first release of the Reshaped is now available for everyone to use. We're starting by releasing v0.1.0 with 31 components, utilities and their documentation. If you're just starting with the library, start with the Overview page from the menu on the left. We hope you enjoy using Reshaped and are already looking forward to get the next release out of the door! 🕹️