Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@instructure/ui

instructure23.7kMIT10.26.4TypeScript support: included

A meta package exporting all UI components

readme


id: instructure-ui

Instructure UI

MIT License Code of Conduct

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

changelog

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

10.26.3 (2025-11-19)

Note: Version bump only for package @instructure/ui

10.26.2 (2025-10-13)

Note: Version bump only for package @instructure/ui

10.26.1 (2025-10-06)

Note: Version bump only for package @instructure/ui

10.26.0 (2025-10-01)

Note: Version bump only for package @instructure/ui

10.25.0 (2025-09-09)

Note: Version bump only for package @instructure/ui

10.24.2 (2025-08-11)

Note: Version bump only for package @instructure/ui

10.24.1 (2025-07-30)

Note: Version bump only for package @instructure/ui

10.24.0 (2025-07-18)

Note: Version bump only for package @instructure/ui

10.23.0 (2025-07-09)

Note: Version bump only for package @instructure/ui

10.22.0 (2025-07-04)

Features

  • many: add new package (instructure) and three new components: AiInformation, NutritionFacts and DataPermissionLevels (073be7b)

10.21.0 (2025-06-27)

Note: Version bump only for package @instructure/ui

10.20.1 (2025-06-17)

Note: Version bump only for package @instructure/ui

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

10.19.0 (2025-06-03)

Note: Version bump only for package @instructure/ui

10.18.1 (2025-05-29)

Note: Version bump only for package @instructure/ui

10.18.0 (2025-05-26)

Note: Version bump only for package @instructure/ui

10.17.0 (2025-05-20)

Note: Version bump only for package @instructure/ui

10.16.4 (2025-05-09)

Note: Version bump only for package @instructure/ui

10.16.3 (2025-04-30)

Note: Version bump only for package @instructure/ui

10.16.2 (2025-04-22)

Note: Version bump only for package @instructure/ui

10.16.1 (2025-04-22)

Note: Version bump only for package @instructure/ui

10.16.0 (2025-04-11)

Note: Version bump only for package @instructure/ui

10.15.2 (2025-04-07)

Note: Version bump only for package @instructure/ui

10.15.1 (2025-04-03)

Note: Version bump only for package @instructure/ui

10.15.0 (2025-03-31)

Note: Version bump only for package @instructure/ui

10.14.0 (2025-03-17)

Note: Version bump only for package @instructure/ui

10.13.0 (2025-03-06)

Bug Fixes

  • many: fix form label not read by NVDA in hover mode and other layout issues (ef77281)

10.12.0 (2025-02-24)

Note: Version bump only for package @instructure/ui

10.11.0 (2025-02-03)

Note: Version bump only for package @instructure/ui

10.10.0 (2024-12-18)

Note: Version bump only for package @instructure/ui

10.9.0 (2024-12-12)

Features

  • many: make meta package export every component and type definition (dee9abb)

10.8.0 (2024-12-09)

Note: Version bump only for package @instructure/ui

10.7.0 (2024-12-03)

Note: Version bump only for package @instructure/ui

10.6.1 (2024-11-26)

Note: Version bump only for package @instructure/ui

10.6.0 (2024-11-18)

Note: Version bump only for package @instructure/ui

10.5.0 (2024-11-07)

Note: Version bump only for package @instructure/ui

10.4.1 (2024-10-28)

Bug Fixes

10.4.0 (2024-10-16)

Note: Version bump only for package @instructure/ui

10.3.0 (2024-10-03)

Note: Version bump only for package @instructure/ui

10.2.2 (2024-09-13)

Note: Version bump only for package @instructure/ui

10.2.1 (2024-08-30)

Note: Version bump only for package @instructure/ui

10.2.0 (2024-08-23)

Note: Version bump only for package @instructure/ui

10.1.0 (2024-08-23)

Note: Version bump only for package @instructure/ui

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

9.5.0 (2024-07-26)

Note: Version bump only for package @instructure/ui

9.4.0 (2024-07-26)

Note: Version bump only for package @instructure/ui

9.3.0 (2024-07-17)

Features

  • ui,ui-date-input: add new DateInput2 component (9c893fc)

9.2.0 (2024-07-09)

Note: Version bump only for package @instructure/ui

9.1.0 (2024-06-14)

Note: Version bump only for package @instructure/ui

9.0.1 (2024-05-09)

Note: Version bump only for package @instructure/ui

9.0.0 (2024-05-09)

Features

  • shared-types,ui,ui-navigation: remove deprecated component Navigation (0173c76)

8.56.0 (2024-05-06)

Note: Version bump only for package @instructure/ui

8.55.1 (2024-04-30)

Note: Version bump only for package @instructure/ui

8.55.0 (2024-04-09)

Note: Version bump only for package @instructure/ui

8.54.0 (2024-03-21)

Note: Version bump only for package @instructure/ui

8.53.2 (2024-02-15)

Note: Version bump only for package @instructure/ui

8.53.1 (2024-02-09)

Note: Version bump only for package @instructure/ui

8.53.0 (2024-02-08)

Note: Version bump only for package @instructure/ui

8.52.0 (2024-02-02)

Note: Version bump only for package @instructure/ui

8.51.0 (2023-12-14)

Note: Version bump only for package @instructure/ui

8.50.0 (2023-12-05)

Note: Version bump only for package @instructure/ui

8.49.0 (2023-11-24)

Note: Version bump only for package @instructure/ui

8.48.3 (2023-11-23)

Note: Version bump only for package @instructure/ui

8.48.2 (2023-11-21)

Note: Version bump only for package @instructure/ui

8.48.1 (2023-11-17)

Note: Version bump only for package @instructure/ui

8.48.0 (2023-11-10)

Note: Version bump only for package @instructure/ui

8.47.1 (2023-11-06)

Note: Version bump only for package @instructure/ui

8.47.0 (2023-10-27)

Note: Version bump only for package @instructure/ui

8.46.1 (2023-10-13)

Note: Version bump only for package @instructure/ui

8.46.0 (2023-10-11)

Note: Version bump only for package @instructure/ui

8.45.0 (2023-10-03)

Note: Version bump only for package @instructure/ui

8.44.0 (2023-09-21)

Note: Version bump only for package @instructure/ui

8.43.1 (2023-09-11)

Note: Version bump only for package @instructure/ui

8.43.0 (2023-09-07)

Note: Version bump only for package @instructure/ui

8.42.0 (2023-09-07)

Note: Version bump only for package @instructure/ui

8.41.1 (2023-08-24)

Note: Version bump only for package @instructure/ui

8.41.0 (2023-08-21)

Note: Version bump only for package @instructure/ui

8.40.1 (2023-08-18)

Note: Version bump only for package @instructure/ui

8.40.0 (2023-08-17)

Note: Version bump only for package @instructure/ui

8.39.0 (2023-07-21)

Features

  • instui-config,shared-types,ui-navigation,ui-side-nav-bar,ui: add side-nav-bar component and deprecate navigation (45848bf)

8.38.1 (2023-06-13)

Note: Version bump only for package @instructure/ui

8.38.0 (2023-05-15)

Note: Version bump only for package @instructure/ui

8.37.0 (2023-04-25)

Note: Version bump only for package @instructure/ui

8.36.0 (2023-03-23)

Note: Version bump only for package @instructure/ui

8.35.1 (2023-03-10)

Note: Version bump only for package @instructure/ui

8.35.0 (2023-02-17)

Note: Version bump only for package @instructure/ui

8.34.0 (2023-02-10)

Note: Version bump only for package @instructure/ui

8.33.2 (2023-01-25)

Note: Version bump only for package @instructure/ui

8.33.1 (2023-01-06)

Note: Version bump only for package @instructure/ui

8.33.0 (2023-01-04)

Note: Version bump only for package @instructure/ui

8.32.1 (2022-12-01)

Note: Version bump only for package @instructure/ui

8.32.0 (2022-11-23)

Note: Version bump only for package @instructure/ui

8.31.0 (2022-11-21)

Features

  • shared-types,ui,ui-top-nav-bar: add new TopNavBar component (3f27257)

8.30.0 (2022-10-26)

Note: Version bump only for package @instructure/ui

8.29.0 (2022-09-29)

Note: Version bump only for package @instructure/ui

8.28.2 (2022-09-16)

Bug Fixes

  • ui: wrong peer dependency for react (80580a7)

8.28.1 (2022-09-12)

Note: Version bump only for package @instructure/ui

8.28.0 (2022-09-02)

Features

  • ui-truncate-list,ui: add TruncateList utility component (f8b17ea)

8.27.0 (2022-07-25)

Features

8.26.3 (2022-07-14)

Note: Version bump only for package @instructure/ui

8.26.2 (2022-07-11)

Note: Version bump only for package @instructure/ui

8.26.1 (2022-07-06)

Note: Version bump only for package @instructure/ui

8.26.0 (2022-06-30)

Features

  • ui-color-picker: Add ColorPicker component (1cbd877)
  • ui-source-code-editor,ui-code-editor,ui: add new SourceCodeEditor component (b5064f5)

8.25.0 (2022-06-03)

Note: Version bump only for package @instructure/ui

8.24.5 (2022-05-31)

Note: Version bump only for package @instructure/ui

8.24.4 (2022-05-27)

Note: Version bump only for package @instructure/ui

8.24.3 (2022-05-25)

Note: Version bump only for package @instructure/ui

8.24.2 (2022-05-02)

Note: Version bump only for package @instructure/ui

8.24.1 (2022-04-29)

Note: Version bump only for package @instructure/ui

8.24.0 (2022-04-26)

Note: Version bump only for package @instructure/ui

8.23.0 (2022-04-07)

Note: Version bump only for package @instructure/ui

8.22.0 (2022-03-31)

Features

  • ui-drilldown,ui: add new Drilldown component (44e7e13)
Drilldown component

The Drilldown component exists to support navigating and managing tree structures in compact spaces. It is a diverse component that displays hierarchical data in a fashion that allows the users to “drill down” and dig deeper into the layers (pages) of the data structure. It has similar look and features to the Menu, Select and TreeBrowser components.

8.21.0 (2022-03-30)

Note: Version bump only for package @instructure/ui

8.20.0 (2022-03-22)

Note: Version bump only for package @instructure/ui

8.19.0 (2022-03-16)

Note: Version bump only for package @instructure/ui

8.18.0 (2022-02-23)

Note: Version bump only for package @instructure/ui

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

8.15.0 (2022-01-26)

Note: Version bump only for package @instructure/ui

8.14.0 (2021-12-16)

Note: Version bump only for package @instructure/ui

8.13.0 (2021-12-01)

Note: Version bump only for package @instructure/ui

8.12.0 (2021-11-17)

Features

  • ui-date-time-input,ui-i18n,ui-time-select: add DateTimeInput (1054ae9)

8.11.1 (2021-10-19)

Note: Version bump only for package @instructure/ui

8.11.0 (2021-10-15)

Note: Version bump only for package @instructure/ui

8.10.2 (2021-10-01)

Note: Version bump only for package @instructure/ui

8.10.1 (2021-10-01)

Note: Version bump only for package @instructure/ui

8.10.0 (2021-09-28)

Note: Version bump only for package @instructure/ui

8.9.1 (2021-09-16)

Note: Version bump only for package @instructure/ui

8.9.0 (2021-09-15)

Note: Version bump only for package @instructure/ui

8.8.0 (2021-08-27)

Note: Version bump only for package @instructure/ui

8.7.0 (2021-07-16)

Note: Version bump only for package @instructure/ui

8.6.0 (2021-06-18)

Note: Version bump only for package @instructure/ui

8.5.0 (2021-06-09)

Note: Version bump only for package @instructure/ui

8.4.0 (2021-05-11)

Bug Fixes

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

8.3.0 (2021-05-04)

Bug Fixes

  • ui: export EmotionThemeProvider and withStyle from ui package (61e153c)

8.2.1 (2021-04-22)

Note: Version bump only for package @instructure/ui

8.2.0 (2021-04-22)

Note: Version bump only for package @instructure/ui

8.1.0 (2021-04-15)

Bug Fixes

  • ui: add SimpleSelect export to @instructure/ui (e6efc4d)

8.0.0 (2021-03-29)

Code Refactoring

  • ui-metric,ui: removed deprecated MetricList component (d795851)
  • ui-metric,ui: removed deprecated MetricListItem component (b8e52b8)
  • ui-progress,ui: delete deprecated Progress component (69a84d0)

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.
  • ui-metric,ui: Removed deprecated MetricList component, use MetricGroup instead.
  • ui-metric,ui: Removed deprecated MetricListItem component, use Metric instead.
  • ui-progress,ui: Deleted deprecated Progress component, use ProgressBar or ProgressCircle instead.

7.5.0 (2021-03-22)

Note: Version bump only for package @instructure/ui

7.4.4 (2021-03-12)

Note: Version bump only for package @instructure/ui

7.4.3 (2021-03-11)

Note: Version bump only for package @instructure/ui

7.4.2 (2021-03-11)

Note: Version bump only for package @instructure/ui

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

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

7.3.1 (2020-11-30)

Note: Version bump only for package @instructure/ui

7.3.0 (2020-10-26)

Note: Version bump only for package @instructure/ui

7.2.4 (2020-10-09)

Note: Version bump only for package @instructure/ui

7.2.3 (2020-10-08)

Note: Version bump only for package @instructure/ui

7.2.2 (2020-10-08)

Note: Version bump only for package @instructure/ui

7.2.1 (2020-10-07)

Note: Version bump only for package @instructure/ui

7.2.0 (2020-09-23)

Note: Version bump only for package @instructure/ui

7.1.4 (2020-09-09)

Note: Version bump only for package @instructure/ui

7.1.3 (2020-08-10)

Note: Version bump only for package @instructure/ui

7.1.2 (2020-07-17)

Note: Version bump only for package @instructure/ui

7.1.1 (2020-07-01)

Note: Version bump only for package @instructure/ui

7.1.0 (2020-06-25)

Note: Version bump only for package @instructure/ui

7.0.0 (2020-05-27)

Note: Version bump only for package @instructure/ui

6.26.0 (2020-04-30)

Note: Version bump only for package @instructure/ui

6.25.0 (2020-04-27)

Features

  • instui-config,ui: add a universal export package (9e74450)

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