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.26.4 (2025-11-20)

Note: Version bump only for package @instructure/ui-themes

10.26.3 (2025-11-19)

Note: Version bump only for package @instructure/ui-themes

10.26.2 (2025-10-13)

Note: Version bump only for package @instructure/ui-themes

10.26.1 (2025-10-06)

Note: Version bump only for package @instructure/ui-themes

10.26.0 (2025-10-01)

Note: Version bump only for package @instructure/ui-themes

10.25.0 (2025-09-09)

Note: Version bump only for package @instructure/ui-themes

10.24.2 (2025-08-11)

Note: Version bump only for package @instructure/ui-themes

10.24.1 (2025-07-30)

Note: Version bump only for package @instructure/ui-themes

10.24.0 (2025-07-18)

Note: Version bump only for package @instructure/ui-themes

10.23.0 (2025-07-09)

Note: Version bump only for package @instructure/ui-themes

10.22.0 (2025-07-04)

Note: Version bump only for package @instructure/ui-themes

10.21.0 (2025-06-27)

Note: Version bump only for package @instructure/ui-themes

10.20.1 (2025-06-17)

Note: Version bump only for package @instructure/ui-themes

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/ui-themes

10.19.0 (2025-06-03)

Note: Version bump only for package @instructure/ui-themes

10.18.1 (2025-05-29)

Note: Version bump only for package @instructure/ui-themes

10.18.0 (2025-05-26)

Features

• ui-themes,shared-types: add new shadow tokens (8e28f83)

10.17.0 (2025-05-20)

Features

• ui-themes,shared-types: add new primitive and contrast colors (c943d27)

10.16.4 (2025-05-09)

Note: Version bump only for package @instructure/ui-themes

10.16.3 (2025-04-30)

Note: Version bump only for package @instructure/ui-themes

10.16.2 (2025-04-22)

Note: Version bump only for package @instructure/ui-themes

10.16.1 (2025-04-22)

Note: Version bump only for package @instructure/ui-themes

10.16.0 (2025-04-11)

Features

• ui-link: add variants to <Link> (308bb2f)

10.15.2 (2025-04-07)

Note: Version bump only for package @instructure/ui-themes

10.15.1 (2025-04-03)

Note: Version bump only for package @instructure/ui-themes

10.15.0 (2025-03-31)

Bug Fixes

• ui-themes,emotion: fix typos in names of some spacing token (9bbc6e4)

10.14.0 (2025-03-17)

Note: Version bump only for package @instructure/ui-themes

10.13.0 (2025-03-06)

Note: Version bump only for package @instructure/ui-themes

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/ui-themes

10.10.0 (2024-12-18)

Features

• many: add new Typography tokens and update text and heading (a09fa0f)

10.9.0 (2024-12-12)

Note: Version bump only for package @instructure/ui-themes

10.8.0 (2024-12-09)

Note: Version bump only for package @instructure/ui-themes

10.7.0 (2024-12-03)

Features

• ui-link: update Link's color (c3f5f37)

10.6.1 (2024-11-26)

Note: Version bump only for package @instructure/ui-themes

10.6.0 (2024-11-18)

Bug Fixes

• many: adjust border colors to meet a11y contrast standards (2f47e06)

10.5.0 (2024-11-07)

Bug Fixes

• ui-themes: make all colors available (46f9e38)

10.4.1 (2024-10-28)

Bug Fixes

• update license (1c039d9)

10.4.0 (2024-10-16)

Note: Version bump only for package @instructure/ui-themes

10.3.0 (2024-10-03)

Note: Version bump only for package @instructure/ui-themes

10.2.2 (2024-09-13)

Note: Version bump only for package @instructure/ui-themes

10.2.1 (2024-08-30)

Note: Version bump only for package @instructure/ui-themes

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/ui-themes

9.5.0 (2024-07-26)

Note: Version bump only for package @instructure/ui-themes

9.4.0 (2024-07-26)

Note: Version bump only for package @instructure/ui-themes

9.3.0 (2024-07-17)

Note: Version bump only for package @instructure/ui-themes

9.2.0 (2024-07-09)

Note: Version bump only for package @instructure/ui-themes

9.1.0 (2024-06-14)

Note: Version bump only for package @instructure/ui-themes

9.0.1 (2024-05-09)

Note: Version bump only for package @instructure/ui-themes

9.0.0 (2024-05-09)

Note: Version bump only for package @instructure/ui-themes

8.56.0 (2024-05-06)

Note: Version bump only for package @instructure/ui-themes

8.55.1 (2024-04-30)

Note: Version bump only for package @instructure/ui-themes

8.55.0 (2024-04-09)

Note: Version bump only for package @instructure/ui-themes

8.54.0 (2024-03-21)

Note: Version bump only for package @instructure/ui-themes

8.53.2 (2024-02-15)

Note: Version bump only for package @instructure/ui-themes

8.53.1 (2024-02-09)

Note: Version bump only for package @instructure/ui-themes

8.53.0 (2024-02-08)

Note: Version bump only for package @instructure/ui-themes

8.52.0 (2024-02-02)

Note: Version bump only for package @instructure/ui-themes

8.51.0 (2023-12-14)

Note: Version bump only for package @instructure/ui-themes

8.50.0 (2023-12-05)

Note: Version bump only for package @instructure/ui-themes

8.49.0 (2023-11-24)

Note: Version bump only for package @instructure/ui-themes

8.48.3 (2023-11-23)

Note: Version bump only for package @instructure/ui-themes

8.48.2 (2023-11-21)

Note: Version bump only for package @instructure/ui-themes

8.48.1 (2023-11-17)

Note: Version bump only for package @instructure/ui-themes

8.48.0 (2023-11-10)

Note: Version bump only for package @instructure/ui-themes

8.47.1 (2023-11-06)

Note: Version bump only for package @instructure/ui-themes

8.47.0 (2023-10-27)

Note: Version bump only for package @instructure/ui-themes

8.46.1 (2023-10-13)

Note: Version bump only for package @instructure/ui-themes

8.46.0 (2023-10-11)

Note: Version bump only for package @instructure/ui-themes

8.45.0 (2023-10-03)

Note: Version bump only for package @instructure/ui-themes

8.44.0 (2023-09-21)

Note: Version bump only for package @instructure/ui-themes

8.43.1 (2023-09-11)

Note: Version bump only for package @instructure/ui-themes

8.43.0 (2023-09-07)

Note: Version bump only for package @instructure/ui-themes

8.42.0 (2023-09-07)

Note: Version bump only for package @instructure/ui-themes

8.41.1 (2023-08-24)

Note: Version bump only for package @instructure/ui-themes

8.41.0 (2023-08-21)

Note: Version bump only for package @instructure/ui-themes

8.40.1 (2023-08-18)

Note: Version bump only for package @instructure/ui-themes

8.40.0 (2023-08-17)

Note: Version bump only for package @instructure/ui-themes

8.39.0 (2023-07-21)

Note: Version bump only for package @instructure/ui-themes

8.38.1 (2023-06-13)

Note: Version bump only for package @instructure/ui-themes

8.38.0 (2023-05-15)

Note: Version bump only for package @instructure/ui-themes

8.37.0 (2023-04-25)

Note: Version bump only for package @instructure/ui-themes

8.36.0 (2023-03-23)

Note: Version bump only for package @instructure/ui-themes

8.35.1 (2023-03-10)

Note: Version bump only for package @instructure/ui-themes

8.35.0 (2023-02-17)

Note: Version bump only for package @instructure/ui-themes

8.34.0 (2023-02-10)

Note: Version bump only for package @instructure/ui-themes

8.33.2 (2023-01-25)

Note: Version bump only for package @instructure/ui-themes

8.33.1 (2023-01-06)

Note: Version bump only for package @instructure/ui-themes

8.33.0 (2023-01-04)

Note: Version bump only for package @instructure/ui-themes

8.32.1 (2022-12-01)

Note: Version bump only for package @instructure/ui-themes

8.32.0 (2022-11-23)

Note: Version bump only for package @instructure/ui-themes

8.31.0 (2022-11-21)

Note: Version bump only for package @instructure/ui-themes

8.30.0 (2022-10-26)

Note: Version bump only for package @instructure/ui-themes

8.29.0 (2022-09-29)

Note: Version bump only for package @instructure/ui-themes

8.28.2 (2022-09-16)

Note: Version bump only for package @instructure/ui-themes

8.28.1 (2022-09-12)

Note: Version bump only for package @instructure/ui-themes

8.28.0 (2022-09-02)

Note: Version bump only for package @instructure/ui-themes

8.27.0 (2022-07-25)

Note: Version bump only for package @instructure/ui-themes

8.26.3 (2022-07-14)

Note: Version bump only for package @instructure/ui-themes

8.26.2 (2022-07-11)

Note: Version bump only for package @instructure/ui-themes

8.26.1 (2022-07-06)

Note: Version bump only for package @instructure/ui-themes

8.26.0 (2022-06-30)

Note: Version bump only for package @instructure/ui-themes

8.25.0 (2022-06-03)

Note: Version bump only for package @instructure/ui-themes

8.24.5 (2022-05-31)

Note: Version bump only for package @instructure/ui-themes

8.24.4 (2022-05-27)

Note: Version bump only for package @instructure/ui-themes

8.24.3 (2022-05-25)

Note: Version bump only for package @instructure/ui-themes

8.24.2 (2022-05-02)

Note: Version bump only for package @instructure/ui-themes

8.24.1 (2022-04-29)

Note: Version bump only for package @instructure/ui-themes

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/ui-themes

8.22.0 (2022-03-31)

Note: Version bump only for package @instructure/ui-themes

8.21.0 (2022-03-30)

Note: Version bump only for package @instructure/ui-themes

8.20.0 (2022-03-22)

Note: Version bump only for package @instructure/ui-themes

8.19.0 (2022-03-16)

Note: Version bump only for package @instructure/ui-themes

8.18.0 (2022-02-23)

Note: Version bump only for package @instructure/ui-themes

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/ui-themes

8.15.0 (2022-01-26)

Note: Version bump only for package @instructure/ui-themes

8.14.0 (2021-12-16)

Note: Version bump only for package @instructure/ui-themes

8.13.0 (2021-12-01)

Features

• canvas-theme,ui-theme-tokens,ui-themes: update canvas theme colors (a72237d)
• instructure-theme,ui-theme-tokens,ui-themes: update Instructure theme colors (07352f5)

8.12.0 (2021-11-17)

Note: Version bump only for package @instructure/ui-themes

8.11.1 (2021-10-19)

Note: Version bump only for package @instructure/ui-themes

8.11.0 (2021-10-15)

Note: Version bump only for package @instructure/ui-themes

8.10.2 (2021-10-01)

Note: Version bump only for package @instructure/ui-themes

8.10.1 (2021-10-01)

Note: Version bump only for package @instructure/ui-themes

8.10.0 (2021-09-28)

Note: Version bump only for package @instructure/ui-themes

8.9.1 (2021-09-16)

Note: Version bump only for package @instructure/ui-themes

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/ui-themes

8.7.0 (2021-07-16)

Note: Version bump only for package @instructure/ui-themes

8.6.0 (2021-06-18)

Note: Version bump only for package @instructure/ui-themes

8.5.0 (2021-06-09)

Note: Version bump only for package @instructure/ui-themes

8.4.0 (2021-05-11)

Bug Fixes

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

8.3.0 (2021-05-04)

Note: Version bump only for package @instructure/ui-themes

8.2.1 (2021-04-22)

Note: Version bump only for package @instructure/ui-themes

8.2.0 (2021-04-22)

Note: Version bump only for package @instructure/ui-themes

8.1.0 (2021-04-15)

Note: Version bump only for package @instructure/ui-themes

8.0.0 (2021-03-29)

Features

• ui-test-sandbox,ui: delete ui-themeable package and usages (60e4080)

BREAKING CHANGES

• ui-test-sandbox,ui: The whole ui-themeable package was deleted. It is superseeded by the emotion package.

7.5.0 (2021-03-22)

Note: Version bump only for package @instructure/ui-themes

7.4.4 (2021-03-12)

Bug Fixes

• Add CommonJS build to @instructure/ui-themes (7e99643)

7.4.3 (2021-03-11)

Note: Version bump only for package @instructure/ui-themes

7.4.2 (2021-03-11)

Note: Version bump only for package @instructure/ui-themes

7.4.1 (2021-03-04)

Bug Fixes

• all: Fix package imports, now everything can be imported; fix test:all in main package.json (2f11024)

7.4.0 (2021-02-01)

Note: Version bump only for package @instructure/ui-themes

7.3.5 (2021-01-21)

Bug Fixes

• esm: specify "exports" in package manifests (6007684)

7.3.4 (2021-01-14)

Bug Fixes

• esm: specify "exports" in package manifests (6007684)

7.3.3 (2021-01-13)

Bug Fixes

• esm: specify "exports" in package manifests (6007684)

7.3.2 (2020-12-10)

Note: Version bump only for package @instructure/ui-themes

7.3.1 (2020-11-30)

Note: Version bump only for package @instructure/ui-themes

7.3.0 (2020-10-26)

Note: Version bump only for package @instructure/ui-themes

7.2.4 (2020-10-09)

Note: Version bump only for package @instructure/ui-themes

7.2.3 (2020-10-08)

Note: Version bump only for package @instructure/ui-themes

7.2.2 (2020-10-08)

Note: Version bump only for package @instructure/ui-themes

7.2.1 (2020-10-07)

Note: Version bump only for package @instructure/ui-themes

7.2.0 (2020-09-23)

Note: Version bump only for package @instructure/ui-themes

7.1.4 (2020-09-09)

Note: Version bump only for package @instructure/ui-themes

7.1.3 (2020-08-10)

Note: Version bump only for package @instructure/ui-themes

7.1.2 (2020-07-17)

Note: Version bump only for package @instructure/ui-themes

7.1.1 (2020-07-01)

Note: Version bump only for package @instructure/ui-themes

7.1.0 (2020-06-25)

Note: Version bump only for package @instructure/ui-themes

7.0.0 (2020-05-27)

chore

• remove canvas-ams-theme (91f1336)

BREAKING CHANGES

• • Removed the canvas-ams-theme package. Use canvas-theme instead.

Change-Id: I077f6b8cbbef9ee12e5904fb4c9dc4b48409acbb Reviewed-on: https://gerrit.instructure.com/c/instructure-ui/+/237960 Tested-by: Service Cloud Jenkins svc.cloudjenkins@instructure.com Reviewed-by: Steve Jensen sejensen@instructure.com QA-Review: Daniel Sasaki dsasaki@instructure.com Product-Review: Steve Jensen sejensen@instructure.com Visual-Regression-Test: Steve Jensen sejensen@instructure.com

6.26.0 (2020-04-30)

Note: Version bump only for package @instructure/ui-themes

6.25.0 (2020-04-27)

Note: Version bump only for package @instructure/ui-themes

6.24.0 (2020-04-14)

Note: Version bump only for package @instructure/ui-themes

6.23.0 (2020-04-02)

Features

• instui-config,canvas-ams-theme,ui-themes,ui-view: add canvas-ams-theme (f31849f)

6.22.0 (2020-03-16)

Note: Version bump only for package @instructure/ui-themes

6.21.0 (2020-02-26)

Note: Version bump only for package @instructure/ui-themes

6.20.0 (2020-02-13)

Note: Version bump only for package @instructure/ui-themes

6.19.0 (2020-02-11)

Features

• instructure-theme: add instructure-theme (df088ec)

6.18.0 (2020-02-04)

Note: Version bump only for package @instructure/ui-themes

6.17.0 (2020-01-22)

Bug Fixes

• Update Package READMEs and align deprecation statements (8f892e4)

6.16.0 (2019-12-13)

Note: Version bump only for package @instructure/ui-themes

6.15.0 (2019-11-18)

Note: Version bump only for package @instructure/ui-themes

6.14.0 (2019-10-14)

Note: Version bump only for package @instructure/ui-themes

6.13.0 (2019-09-24)

Note: Version bump only for package @instructure/ui-themes

6.12.0 (2019-09-17)

Note: Version bump only for package @instructure/ui-themes

6.11.0 (2019-09-16)

Note: Version bump only for package @instructure/ui-themes

6.10.0 (2019-08-27)

Note: Version bump only for package @instructure/ui-themes

6.9.0 (2019-08-07)

Note: Version bump only for package @instructure/ui-themes

6.8.1 (2019-08-02)

Note: Version bump only for package @instructure/ui-themes

6.8.0 (2019-07-31)

Note: Version bump only for package @instructure/ui-themes

6.7.0 (2019-07-15)

Note: Version bump only for package @instructure/ui-themes

6.6.0 (2019-07-03)

Note: Version bump only for package @instructure/ui-themes

6.5.0 (2019-07-01)

Note: Version bump only for package @instructure/ui-themes

6.4.0 (2019-06-13)

Note: Version bump only for package @instructure/ui-themes

6.3.0 (2019-05-28)

Note: Version bump only for package @instructure/ui-themes

6.2.0 (2019-05-13)

Note: Version bump only for package @instructure/ui-themes

6.1.0 (2019-05-09)

Note: Version bump only for package @instructure/ui-themes

6.0.0 (2019-05-03)

Features

• remove deprecated packages/props (1d8813c)
• canvas-theme,canvas-high-contrast-theme: separate canvas theme packages (ef2e1d0)
• ui-babel-preset: transform member imports to full paths (d02cc45)

BREAKING CHANGES

• • ui-core package has been removed

5.52.3 (2019-04-25)

Note: Version bump only for package @instructure/ui-themes

5.52.2 (2019-04-17)

Note: Version bump only for package @instructure/ui-themes

5.52.1 (2019-04-08)

Note: Version bump only for package @instructure/ui-themes

5.52.0 (2019-04-03)

Features

• console: remove console statements in prod env (603c738)

5.51.1 (2019-03-30)

Note: Version bump only for package @instructure/ui-themes

5.51.0 (2019-03-29)

Note: Version bump only for package @instructure/ui-themes

5.50.0 (2019-03-28)

Note: Version bump only for package @instructure/ui-themes

5.49.0 (2019-03-22)

Note: Version bump only for package @instructure/ui-themes

5.48.0 (2019-03-18)

Note: Version bump only for package @instructure/ui-themes

5.47.0 (2019-03-15)

Note: Version bump only for package @instructure/ui-themes

5.46.1 (2019-03-13)

Note: Version bump only for package @instructure/ui-themes

5.46.0 (2019-03-12)

Note: Version bump only for package @instructure/ui-themes

5.45.1 (2019-03-12)

Note: Version bump only for package @instructure/ui-themes

5.45.0 (2019-03-11)

Note: Version bump only for package @instructure/ui-themes

5.44.0 (2019-03-01)

Features

• ui-buttons,ui-elements,ui-themes: underline the Link component by default (9a90a7f), closes #008EE2

5.43.0 (2019-02-27)

Note: Version bump only for package @instructure/ui-themes

5.42.0 (2019-02-15)

Features

• ui-scripts,ui-test-utils: add a --mocha option to ui-test (bd37e2b)

5.41.1 (2019-01-30)

Note: Version bump only for package @instructure/ui-themes

5.41.0 (2019-01-29)

Note: Version bump only for package @instructure/ui-themes

5.40.0 (2019-01-15)

Note: Version bump only for package @instructure/ui-themes

5.39.0 (2019-01-11)

Bug Fixes

• ui-overlays: set Modal transition to 0s for IE11 (7a669e5)

5.38.0 (2019-01-04)

Note: Version bump only for package @instructure/ui-themes

5.37.0 (2018-12-18)

Note: Version bump only for package @instructure/ui-themes

5.36.0 (2018-12-12)

Note: Version bump only for package @instructure/ui-themes

5.35.0 (2018-12-06)

Bug Fixes

• ui-test-utils: handle React 16 uncaught errors (7fd8bec)

Features

• ui-buttons,ui-elements,ui-themes: update link color for standard theme (78a18fa), closes #2578
• ui-test-utils: support Sizzle selectors (65481ff)

5.34.0 (2018-11-20)

Note: Version bump only for package @instructure/ui-themes

5.33.0 (2018-11-14)

Note: Version bump only for package @instructure/ui-themes

5.32.0 (2018-10-31)

Note: Version bump only for package @instructure/ui-themes

5.31.0 (2018-10-26)

Note: Version bump only for package @instructure/ui-themes

5.30.0 (2018-09-27)

Note: Version bump only for package @instructure/ui-themes

5.29.0 (2018-09-26)

Note: Version bump only for package @instructure/ui-themes

5.28.1 (2018-09-18)

Note: Version bump only for package @instructure/ui-themes

5.28.0 (2018-09-13)

Note: Version bump only for package @instructure/ui-themes

5.27.0 (2018-09-10)

Note: Version bump only for package @instructure/ui-themes

5.26.0 (2018-09-06)

Note: Version bump only for package @instructure/ui-themes

5.25.0 (2018-08-24)

Note: Version bump only for package @instructure/ui-themes

5.24.0 (2018-08-08)

Bug Fixes

• ui-elements: remove relative import (d0a184e)
• ui-themeable,ui-themes,ui-utils: remove immutable variable (5b6178e)

Performance Improvements

• get babel helpers from 'babel-runtime' instead of inlining them (1472658)

5.23.0 (2018-08-03)

Note: Version bump only for package @instructure/ui-themes

5.22.0 (2018-07-27)

Bug Fixes

• ui-themeable,ui-themes: fix theme.use({ accessible: true }) (fe07a3a)

5.21.0 (2018-07-25)

Features

• ui-elements,ui-themes: add link decoration brand variable to canvas theme (e88ca27)

Performance Improvements

• ui-themeable: avoid doing work per-instance (9b2a84c)

5.20.1 (2018-07-18)

Note: Version bump only for package @instructure/ui-themes

5.20.0 (2018-07-17)

Note: Version bump only for package @instructure/ui-themes

5.19.0 (2018-07-12)

Performance Improvements

• ui-themeable: some things to make themeable faster (fc0a269)

5.18.0 (2018-07-09)

Note: Version bump only for package @instructure/ui-themes

5.17.0 (2018-07-06)

Note: Version bump only for package @instructure/ui-themes

5.16.0 (2018-07-06)

Bug Fixes

• ui-layout,ui-motion,ui-overlays: theme prop should work w/ Portal (2c20181)

5.15.0 (2018-06-28)

Note: Version bump only for package @instructure/ui-themes

5.14.0 (2018-06-28)

Note: Version bump only for package @instructure/ui-themes

5.13.1 (2018-06-22)

Note: Version bump only for package @instructure/ui-themes

5.13.0 (2018-06-16)

Note: Version bump only for package @instructure/ui-themes

5.12.0 (2018-06-11)

Note: Version bump only for package @instructure/ui-themes

5.11.0 (2018-06-06)

Note: Version bump only for package @instructure/ui-themes

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