Theme UI: themeable React apps, a develop branch and prerelease tags
Build consistent, themeable React apps based on constraint-based design principles
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.
Star history
- system-ui/theme-ui5,413 ★ · +14
| Repository | 2026-09-23 | 2026-11-21 |
|---|---|---|
| system-ui/theme-ui | 5.4k | 5.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
Was this useful?