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-pill

10.26.3 (2025-11-19)

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

10.26.2 (2025-10-13)

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

10.26.1 (2025-10-06)

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

10.26.0 (2025-10-01)

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

10.25.0 (2025-09-09)

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

10.24.2 (2025-08-11)

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

10.24.1 (2025-07-30)

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

10.24.0 (2025-07-18)

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

10.23.0 (2025-07-09)

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

10.22.0 (2025-07-04)

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

10.21.0 (2025-06-27)

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

10.20.1 (2025-06-17)

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

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-pill

10.19.0 (2025-06-03)

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

10.18.1 (2025-05-29)

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

10.18.0 (2025-05-26)

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

10.17.0 (2025-05-20)

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

10.16.4 (2025-05-09)

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

10.16.3 (2025-04-30)

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

10.16.2 (2025-04-22)

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

10.16.1 (2025-04-22)

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

10.16.0 (2025-04-11)

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

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

10.15.0 (2025-03-31)

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

10.14.0 (2025-03-17)

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

10.13.0 (2025-03-06)

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

10.12.0 (2025-02-24)

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

10.11.0 (2025-02-03)

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

10.10.0 (2024-12-18)

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

10.9.0 (2024-12-12)

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

10.8.0 (2024-12-09)

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

10.7.0 (2024-12-03)

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

10.6.1 (2024-11-26)

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

10.6.0 (2024-11-18)

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

10.5.0 (2024-11-07)

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

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-pill

10.3.0 (2024-10-03)

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

10.2.2 (2024-09-13)

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

10.2.1 (2024-08-30)

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

10.2.0 (2024-08-23)

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

10.1.0 (2024-08-23)

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

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-pill

9.5.0 (2024-07-26)

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

9.4.0 (2024-07-26)

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

9.3.0 (2024-07-17)

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

9.2.0 (2024-07-09)

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

9.1.0 (2024-06-14)

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

9.0.1 (2024-05-09)

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

9.0.0 (2024-05-09)

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

8.56.0 (2024-05-06)

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

8.55.1 (2024-04-30)

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

8.55.0 (2024-04-09)

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

8.54.0 (2024-03-21)

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

8.53.2 (2024-02-15)

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

8.53.1 (2024-02-09)

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

8.53.0 (2024-02-08)

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

8.52.0 (2024-02-02)

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

8.51.0 (2023-12-14)

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

8.50.0 (2023-12-05)

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

8.49.0 (2023-11-24)

Features

• shared-types,ui-pill: change pill according to new design guidelines (3bd8ee6)

8.48.3 (2023-11-23)

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

8.48.2 (2023-11-21)

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

8.48.1 (2023-11-17)

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

8.48.0 (2023-11-10)

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

8.47.1 (2023-11-06)

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

8.47.0 (2023-10-27)

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

8.46.1 (2023-10-13)

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

8.46.0 (2023-10-11)

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

8.45.0 (2023-10-03)

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

8.44.0 (2023-09-21)

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

8.43.1 (2023-09-11)

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

8.43.0 (2023-09-07)

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

8.42.0 (2023-09-07)

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

8.41.1 (2023-08-24)

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

8.41.0 (2023-08-21)

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

8.40.1 (2023-08-18)

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

8.40.0 (2023-08-17)

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

8.39.0 (2023-07-21)

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

8.38.1 (2023-06-13)

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

8.38.0 (2023-05-15)

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

8.37.0 (2023-04-25)

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

8.36.0 (2023-03-23)

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

8.35.1 (2023-03-10)

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

8.35.0 (2023-02-17)

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

8.34.0 (2023-02-10)

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

8.33.2 (2023-01-25)

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

8.33.1 (2023-01-06)

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

8.33.0 (2023-01-04)

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

8.32.1 (2022-12-01)

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

8.32.0 (2022-11-23)

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

8.31.0 (2022-11-21)

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

8.30.0 (2022-10-26)

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

8.29.0 (2022-09-29)

Bug Fixes

• support react 18 (972bb93)

8.28.2 (2022-09-16)

Bug Fixes

• support react 18 (972bb93)

8.28.1 (2022-09-12)

Bug Fixes

• support react 18 (972bb93)

8.28.0 (2022-09-02)

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

8.27.0 (2022-07-25)

Features

• support React 18 (0a2bf0c)

8.26.3 (2022-07-14)

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

8.26.2 (2022-07-11)

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

8.26.1 (2022-07-06)

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

8.26.0 (2022-06-30)

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

8.25.0 (2022-06-03)

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

8.24.5 (2022-05-31)

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

8.24.4 (2022-05-27)

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

8.24.3 (2022-05-25)

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

8.24.2 (2022-05-02)

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

8.24.1 (2022-04-29)

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

8.24.0 (2022-04-26)

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

8.23.0 (2022-04-07)

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

8.22.0 (2022-03-31)

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

8.21.0 (2022-03-30)

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

8.20.0 (2022-03-22)

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

8.19.0 (2022-03-16)

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

8.18.0 (2022-02-23)

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

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-pill

8.15.0 (2022-01-26)

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

8.14.0 (2021-12-16)

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

8.13.0 (2021-12-01)

Bug Fixes

• ui-popover,ui-tooltip: fixed Tooltip triggers being transformed to links/buttons (07b0037)

8.12.0 (2021-11-17)

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

8.11.1 (2021-10-19)

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

8.11.0 (2021-10-15)

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

8.10.2 (2021-10-01)

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

8.10.1 (2021-10-01)

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

8.10.0 (2021-09-28)

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

8.9.1 (2021-09-16)

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

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-pill

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

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)

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

8.2.1 (2021-04-22)

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

8.2.0 (2021-04-22)

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

8.1.0 (2021-04-15)

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

8.0.0 (2021-03-29)

Code Refactoring

• Migrated the package and it's component(s) from using ui-themeable to using the new theming solution based on emotion.js.
• emotion,ui-themeable: move ThemeablePropValues and ThemeablePropTypes util to emotion pack (2d0ac1d)
• ui-pill,ui-responsive: remove deprecated props from Pill (125f14c)

BREAKING CHANGES

• emotion,ui-themeable: Moved ThemeablePropValues and ThemeablePropTypes utils from ui-themeableto emotion package.
• ui-pill,ui-responsive: Removed text property: use children instead. Children is now required. Removed variant property: use color instead. Within the new color prop default is now primary (gray), primary has updated to info (blue) and message is now alert.

7.5.0 (2021-03-22)

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

7.4.4 (2021-03-12)

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

7.4.3 (2021-03-11)

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

7.4.2 (2021-03-11)

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

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-pill

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-pill

7.3.1 (2020-11-30)

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

7.3.0 (2020-10-26)

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

7.2.4 (2020-10-09)

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

7.2.3 (2020-10-08)

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

7.2.2 (2020-10-08)

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

7.2.1 (2020-10-07)

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

7.2.0 (2020-09-23)

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

7.1.4 (2020-09-09)

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

7.1.3 (2020-08-10)

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

7.1.2 (2020-07-17)

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

7.1.1 (2020-07-01)

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

7.1.0 (2020-06-25)

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

7.0.0 (2020-05-27)

chore

• bump minimum react version to 16.8.0 (7a96f00)
• remove references to React 15 (4bb2426)

BREAKING CHANGES

• • Minimum react and react-dom version raised to 16.8.0

TEST PLAN:

• no regressions in docs app
• homepage should note the react version change
• automated tests should pass

Change-Id: I7cd9dd6423fb9524e0a1a0dd490caeee3a2c2c17 Reviewed-on: https://gerrit.instructure.com/c/instructure-ui/+/237727 Tested-by: Service Cloud Jenkins svc.cloudjenkins@instructure.com Reviewed-by: Chris Guerrero cguerrero@instructure.com Product-Review: Steve Jensen sejensen@instructure.com QA-Review: Daniel Sasaki dsasaki@instructure.com Visual-Regression-Test: Ken Meleta kmeleta@instructure.com

• Dropping support for React 15.

TEST PLAN:

• yarn dev/yarn start should work
• yarn test/test:watch should work
• there should be no mention of react 15 in code
• there should be nothing depending on react 15 or reactDOM 15

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

6.26.0 (2020-04-30)

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

6.25.0 (2020-04-27)

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

6.24.0 (2020-04-14)

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

6.23.0 (2020-04-02)

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

6.22.0 (2020-03-16)

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

6.21.0 (2020-02-26)

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

6.20.0 (2020-02-13)

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

6.19.0 (2020-02-11)

Features

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

6.18.0 (2020-02-04)

Bug Fixes

• ui-pill: update TruncateText import to new package (8957e76)

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-pill

6.15.0 (2019-11-18)

Bug Fixes

• ui-view: allow View to use native browser focus (7686f1b)

Features

• ui-pill: make ui-pill backwards compatible (480eeb7)
• ui-tooltip: make ui-tooltip backwards compatible (7608e7c)
• ui-view: Make ui-view backwards-compatible (7dd2a2f)

6.14.0 (2019-10-14)

Bug Fixes

• ui-file-drop,ui-pill: update babel (a7a8489)

Features

• ui-tooltip: add ui-tooltip package (2e88e8a)

6.13.0 (2019-09-24)

Features

• ui-elements,ui-pill: add ui-pill package for the Pill Component (4a71024)

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