id: instructure-ui

Instructure UI

Instructure UI is an open source UI framework and design system for React. Its components are used by millions of learners every day when they use Instructure products like Canvas LMS.

See our website for usage, examples and documentation.

Contributing

Before contributing please read our code of conduct and read the contribution guidelines.

React Support

Instructure UI currently supports 16.14.0 and higher.

Browser Support

The last two versions of all modern browsers (Firefox, Safari, Chrome, Edge).

License

MIT

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

10.21.0 (2025-06-27)

Note: Version bump only for package @instructure/emotion

10.20.1 (2025-06-17)

Note: Version bump only for package @instructure/emotion

10.20.0 (2025-06-13)

Bug Fixes

• many: update dependencies, browsersdb and moment timezone database (3813636)

10.19.1 (2025-06-05)

Note: Version bump only for package @instructure/emotion

10.19.0 (2025-06-03)

Bug Fixes

• emotion: fix proptype definition (d140fe3)

10.18.1 (2025-05-29)

Note: Version bump only for package @instructure/emotion

10.18.0 (2025-05-26)

Features

• emotion: [InstUISettingsProvider] should be able to access the current theme (d13b6c1)

10.17.0 (2025-05-20)

Note: Version bump only for package @instructure/emotion

10.16.4 (2025-05-09)

Note: Version bump only for package @instructure/emotion

10.16.3 (2025-04-30)

Note: Version bump only for package @instructure/emotion

10.16.2 (2025-04-22)

Note: Version bump only for package @instructure/emotion

10.16.1 (2025-04-22)

Note: Version bump only for package @instructure/emotion

10.16.0 (2025-04-11)

Note: Version bump only for package @instructure/emotion

10.15.2 (2025-04-07)

Bug Fixes

• update PropTypes to align with the new spacing tokens (223d55b)

10.15.1 (2025-04-03)

Note: Version bump only for package @instructure/emotion

10.15.0 (2025-03-31)

Bug Fixes

• many: fix having the same DOM ids if there are multiple instances of InstUI, e.g. module federation (a0bb4d0)
• ui-themes,emotion: fix typos in names of some spacing token (9bbc6e4)

Features

• ui-avatar,emotion: add theming solution to functional components (9cbfd35)

10.14.0 (2025-03-17)

Note: Version bump only for package @instructure/emotion

10.13.0 (2025-03-06)

Note: Version bump only for package @instructure/emotion

10.12.0 (2025-02-24)

Features

• many: introduce new spacing tokens; add margin prop for more components (048c902)

10.11.0 (2025-02-03)

Note: Version bump only for package @instructure/emotion

10.10.0 (2024-12-18)

Note: Version bump only for package @instructure/emotion

10.9.0 (2024-12-12)

Note: Version bump only for package @instructure/emotion

10.8.0 (2024-12-09)

Note: Version bump only for package @instructure/emotion

10.7.0 (2024-12-03)

Note: Version bump only for package @instructure/emotion

10.6.1 (2024-11-26)

Bug Fixes

• emotion,shared-types: better TS types for theme objects and their overrides (c790958)

10.6.0 (2024-11-18)

Note: Version bump only for package @instructure/emotion

10.5.0 (2024-11-07)

Note: Version bump only for package @instructure/emotion

10.4.1 (2024-10-28)

Bug Fixes

• update license (1c039d9)

10.4.0 (2024-10-16)

Note: Version bump only for package @instructure/emotion

10.3.0 (2024-10-03)

Note: Version bump only for package @instructure/emotion

10.2.2 (2024-09-13)

Note: Version bump only for package @instructure/emotion

10.2.1 (2024-08-30)

Note: Version bump only for package @instructure/emotion

10.2.0 (2024-08-23)

Features

• many: add data visualization colors, refactor theme code (c395e17)

10.1.0 (2024-08-23)

Features

• many: add data visualization colors, refactor theme code (c395e17)

10.0.0 (2024-07-31)

Features

• many: rewrite color system (1e5809e)

BREAKING CHANGES

• many: Breaks color overrides in certain cases

9.5.1 (2024-07-30)

Note: Version bump only for package @instructure/emotion

9.5.0 (2024-07-26)

Note: Version bump only for package @instructure/emotion

9.4.0 (2024-07-26)

Note: Version bump only for package @instructure/emotion

9.3.0 (2024-07-17)

Note: Version bump only for package @instructure/emotion

9.2.0 (2024-07-09)

Note: Version bump only for package @instructure/emotion

9.1.0 (2024-06-14)

Note: Version bump only for package @instructure/emotion

9.0.1 (2024-05-09)

Note: Version bump only for package @instructure/emotion

9.0.0 (2024-05-09)

Note: Version bump only for package @instructure/emotion

8.56.0 (2024-05-06)

Note: Version bump only for package @instructure/emotion

8.55.1 (2024-04-30)

Note: Version bump only for package @instructure/emotion

8.55.0 (2024-04-09)

Note: Version bump only for package @instructure/emotion

8.54.0 (2024-03-21)

Note: Version bump only for package @instructure/emotion

8.53.2 (2024-02-15)

Note: Version bump only for package @instructure/emotion

8.53.1 (2024-02-09)

Note: Version bump only for package @instructure/emotion

8.53.0 (2024-02-08)

Note: Version bump only for package @instructure/emotion

8.52.0 (2024-02-02)

Note: Version bump only for package @instructure/emotion

8.51.0 (2023-12-14)

Note: Version bump only for package @instructure/emotion

8.50.0 (2023-12-05)

Note: Version bump only for package @instructure/emotion

8.49.0 (2023-11-24)

Note: Version bump only for package @instructure/emotion

8.48.3 (2023-11-23)

Note: Version bump only for package @instructure/emotion

8.48.2 (2023-11-21)

Note: Version bump only for package @instructure/emotion

8.48.1 (2023-11-17)

Note: Version bump only for package @instructure/emotion

8.48.0 (2023-11-10)

Bug Fixes

• support multiple decorators with ReactTestUtils (ef704b4)

8.47.1 (2023-11-06)

Note: Version bump only for package @instructure/emotion

8.47.0 (2023-10-27)

Bug Fixes

• emotion,ui-i18n,ui-react-utils: make decorated components testable with ReactTestUtils (3568250)

8.46.1 (2023-10-13)

Note: Version bump only for package @instructure/emotion

8.46.0 (2023-10-11)

Note: Version bump only for package @instructure/emotion

8.45.0 (2023-10-03)

Note: Version bump only for package @instructure/emotion

8.44.0 (2023-09-21)

Note: Version bump only for package @instructure/emotion

8.43.1 (2023-09-11)

Note: Version bump only for package @instructure/emotion

8.43.0 (2023-09-07)

Note: Version bump only for package @instructure/emotion

8.42.0 (2023-09-07)

Note: Version bump only for package @instructure/emotion

8.41.1 (2023-08-24)

Note: Version bump only for package @instructure/emotion

8.41.0 (2023-08-21)

Note: Version bump only for package @instructure/emotion

8.40.1 (2023-08-18)

Note: Version bump only for package @instructure/emotion

8.40.0 (2023-08-17)

Features

• emotion,shared-types,ui-theme-tokens: add mediumSmall spacing to themes (d909ded)

8.39.0 (2023-07-21)

Note: Version bump only for package @instructure/emotion

8.38.1 (2023-06-13)

Note: Version bump only for package @instructure/emotion

8.38.0 (2023-05-15)

Note: Version bump only for package @instructure/emotion

8.37.0 (2023-04-25)

Note: Version bump only for package @instructure/emotion

8.36.0 (2023-03-23)

Note: Version bump only for package @instructure/emotion

8.35.1 (2023-03-10)

Note: Version bump only for package @instructure/emotion

8.35.0 (2023-02-17)

Note: Version bump only for package @instructure/emotion

8.34.0 (2023-02-10)

Note: Version bump only for package @instructure/emotion

8.33.2 (2023-01-25)

Note: Version bump only for package @instructure/emotion

8.33.1 (2023-01-06)

Note: Version bump only for package @instructure/emotion

8.33.0 (2023-01-04)

Note: Version bump only for package @instructure/emotion

8.32.1 (2022-12-01)

Note: Version bump only for package @instructure/emotion

8.32.0 (2022-11-23)

Features

• emotion,ui-babel-preset,ui-source-code-editor: remove lodash (4670be5)

8.31.0 (2022-11-21)

Note: Version bump only for package @instructure/emotion

8.30.0 (2022-10-26)

Note: Version bump only for package @instructure/emotion

8.29.0 (2022-09-29)

Note: Version bump only for package @instructure/emotion

8.28.2 (2022-09-16)

Note: Version bump only for package @instructure/emotion

8.28.1 (2022-09-12)

Note: Version bump only for package @instructure/emotion

8.28.0 (2022-09-02)

Note: Version bump only for package @instructure/emotion

8.27.0 (2022-07-25)

Features

• support React 18 (0a2bf0c)

8.26.3 (2022-07-14)

Note: Version bump only for package @instructure/emotion

8.26.2 (2022-07-11)

Note: Version bump only for package @instructure/emotion

8.26.1 (2022-07-06)

Note: Version bump only for package @instructure/emotion

8.26.0 (2022-06-30)

Note: Version bump only for package @instructure/emotion

8.25.0 (2022-06-03)

Note: Version bump only for package @instructure/emotion

8.24.5 (2022-05-31)

Note: Version bump only for package @instructure/emotion

8.24.4 (2022-05-27)

Note: Version bump only for package @instructure/emotion

8.24.3 (2022-05-25)

Reverts

• Revert "refactor(emotion): import lodash functions directly to leverage tree-shaking" (a82a61e)

8.24.2 (2022-05-02)

Note: Version bump only for package @instructure/emotion

8.24.1 (2022-04-29)

Note: Version bump only for package @instructure/emotion

8.24.0 (2022-04-26)

Features

• theme-registry: add theme-registry pacakge (63216ef)

8.23.0 (2022-04-07)

Note: Version bump only for package @instructure/emotion

8.22.0 (2022-03-31)

Note: Version bump only for package @instructure/emotion

8.21.0 (2022-03-30)

Bug Fixes

• emotion: fix text direction not working on simple html elements (22c25bc)

8.20.0 (2022-03-22)

Note: Version bump only for package @instructure/emotion

8.19.0 (2022-03-16)

Features

• emotion: themeOverride prop to accept function (505f0bf)

8.18.0 (2022-02-23)

Note: Version bump only for package @instructure/emotion

8.17.0 (2022-02-07)

Bug Fixes

• remove type:"commonjs" from package.json files (0b243be)

8.16.0 (2022-02-03)

Note: Version bump only for package @instructure/emotion

8.15.0 (2022-01-26)

Bug Fixes

• emotion: make theme componentOverrides apply to Buttons (8a3583e)

8.14.0 (2021-12-16)

Note: Version bump only for package @instructure/emotion

8.13.0 (2021-12-01)

Features

• canvas-theme,ui-theme-tokens,ui-themes: update canvas theme colors (a72237d)

8.12.0 (2021-11-17)

Bug Fixes

• emotion: fix EmotionThemeProvider falling back to using Canvas theme (cc5ce19)

8.11.1 (2021-10-19)

Note: Version bump only for package @instructure/emotion

8.11.0 (2021-10-15)

Note:

The bidirectionalPolyfill util has been deleted. With the release of Safari 15 (Sep 20, 2021) all of our supported browsers (last 2 major versions) can handle CSS Logical Properties without any polyfills and prefixes, so this util was no longer needed.

8.10.2 (2021-10-01)

Note: Version bump only for package @instructure/emotion

8.10.1 (2021-10-01)

Note: Version bump only for package @instructure/emotion

8.10.0 (2021-09-28)

Bug Fixes

• emotion,ui-i18n: decorator adds allowedProps property (ddc7880)

8.9.1 (2021-09-16)

Note: Version bump only for package @instructure/emotion

8.9.0 (2021-09-15)

Bug Fixes

• fix shared-types TS errors (7b83164)

8.8.0 (2021-08-27)

Note: Version bump only for package @instructure/emotion

8.7.0 (2021-07-16)

Features

• add support for React 17 (f647826)

8.6.0 (2021-06-18)

Note: Version bump only for package @instructure/emotion

8.5.0 (2021-06-09)

Bug Fixes

• emotion: add componentId to match with componenet name in docs (cc255eb)

8.4.0 (2021-05-11)

Bug Fixes

• fix all inter-package dependencies using fix version (75cd898)

8.3.0 (2021-05-04)

Performance improvements

• emotion: upgrade to Emotion 11 whose parser was updated to a more performant one (bcafe99)

8.2.1 (2021-04-22)

Note: Version bump only for package @instructure/emotion

8.2.0 (2021-04-22)

Note: Version bump only for package @instructure/emotion

8.1.0 (2021-04-15)

Bug Fixes

• emotion: fix ui-babel-preset dependency (fb1443e)

8.0.0 (2021-03-29)

Code Refactoring

• emotion,ui-themeable: move ThemeablePropValues and ThemeablePropTypes util to emotion pack (2d0ac1d)
• emotion,ui-themeable,ui-view: move getShorthandPropValue from ui-themeable to emotion (91fd876)
• emotion,ui-themeable,ui-view: move makeThemeVars util from ui-themeable to emotion (f2291ba)
• emotion,ui-themeable,ui-view: move mirrorShorthand utils to emotion (c779407)

BREAKING CHANGES

• emotion,ui-themeable,ui-view: Moved mirrorShorthand, mirrorShorthandEdges, mirrorShorthandCorners utils to from ui-themeable to emotion package.
• emotion,ui-themeable,ui-view: Moved getShorthandPropValue from ui-themeable to emotion package.
• emotion,ui-themeable,ui-view: Moved makeThemeVars util from ui-themeable to emotion package.
• emotion,ui-themeable: Moved ThemeablePropValues and ThemeablePropTypes utils from ui-themeableto emotion package.

See the instructure-ui mono-repo change log for past changes.