Open-source project
system-ui/theme-ui avatar
system-ui/theme-ui

Theme UI: themeable React apps, a develop branch and prerelease tags

Build consistent, themeable React apps based on constraint-based design principles

5,413 stars649 forksTypeScriptMIT

At a glance

What is it?
Theme UI is a TypeScript library for building consistent, themeable React apps based on constraint-based design principles, released under MIT and developed on a develop branch that ships prerelease tags.
Who is it for?
Adopt Theme UI when you want a MIT-licensed TypeScript library for consistent, themeable React apps based on constraint-based design principles. Before adopting, note that the default branch is develop and the newest tags are v0.17.5 prerelease builds, while the latest stable tag and the monorepo version are both 0.17.4.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 161 days ago.
What is it written in?
Mainly TypeScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 21, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • system-ui/theme-ui5,413 ★ · +14
Star history
Repository2026-09-232026-11-21
system-ui/theme-ui5.4k5.4k

14 Stars in the last 59 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

Set up the JSX runtime before using sx

First install Theme UI and Emotion, then wrap your application with ThemeUIProvider and pass it your theme object. For a file using the sx prop, tell the JSX compiler to use Theme UI with `/** @jsxImportSource theme-ui */`, or configure the same import source for the project. The [getting-started guide](https://theme-ui.com/getting-started) shows both the provider and the local JSX comment. If standard styles work but theme keys have no effect, check the JSX compiler setup before changing the theme.

How a number selects a theme token

Inside `sx`, a value such as `fontSize: 4` resolves against `theme.fontSizes[4]`. A colour such as `primary` resolves against `theme.colors.primary`. The resulting CSS depends on the theme supplied by the nearest provider. Try the same element under two themes with different font scales to see the effect. This is useful for design systems where components should refer to named colours and typography scales. [Theme-aware properties](https://theme-ui.com/sx-prop#theme-aware-properties)

How responsive arrays map to breakpoints

Theme UI treats the first item in a responsive array as the base value. Each later item starts at the corresponding configured breakpoint, so widths of `['100%', '50%', '25%']` give a full-width element initially, then half and quarter widths as the viewport grows. Use `null` to skip a breakpoint. Inspect the configured breakpoint array and test around its boundaries when the same component is reused under different themes. [Responsive values](https://theme-ui.com/sx-prop#responsive-values)

The install command decides whether color modes come with it

Color modes and layout components decide which package you install.

The repository includes examples for Gatsby, a Gatsby plugin, Next and Typography under examples/.

Two doc sites, two branches, one version number

The homepage is theme-ui.com, and the default branch of the repository is develop. The tags show that split in dates: v0.17.4 shipped on 2026-01-02, then v0.17.5-develop.0 and v0.17.5-develop.1 both landed on 2026-03-05, while the monorepo package.json still reads 0.17.4. The last push to this repository was on 2026-06-14. Check which release line a documented prop belongs to before you debug, because the property you are chasing may describe a prerelease line that your lockfile never installed.

Debug the style where it is resolved

Theme UI passes the theme-aware style object to Emotion through its JSX runtime. When adapting a component, begin with one token such as `color: 'primary'` and inspect the computed style. If the value still looks wrong, check that the component is below ThemeUIProvider, the token exists on that provider's theme, and the file uses Theme UI's JSX runtime. This isolates the point where theme values are lost before you have to inspect an entire screen.

The repository root leaves upgrade and rendering questions open

The root of the repository is where the gaps become visible. MIGRATING.md, CHANGELOG.md and a .size-limit.json sit at the root, so upgrade notes and a bundle-size budget live in their own files.

Editorial conclusion

Adopt Theme UI when you want a MIT-licensed TypeScript library for consistent, themeable React apps based on constraint-based design principles. Before adopting, note that the default branch is develop and the newest tags are v0.17.5 prerelease builds, while the latest stable tag and the monorepo version are both 0.17.4.

Frequently asked questions

What is Theme UI?

A library for creating themeable user interfaces based on constraint-based design principles, written in TypeScript and released under MIT.

What is a UI theme in Theme UI?

Source does not describe the theme object; the repository describes the project as building consistent, themeable React apps based on constraint-based design principles.

What does UI mean for Theme UI's layout components?

Source does not describe the layout components; the repository ships example projects for Gatsby, a Gatsby plugin, Next and Typography under examples/.

Official sources

  1. License: MIT
  2. Project website
  3. README
  4. Releases
  5. system-ui/theme-ui on GitHub

Was this useful?