Extensions
An extension is a package that adds components, hooks, or utilities to a React UI Library app and behaves like the rest of it. Nothing registers itself at runtime — an extension is an ordinary npm package that follows four conventions, so anything built on it composes with the components already in the app.
Takes the host theme
Colors, spacing, radii, and typography come from the app's React UI Library theme, so an extension changes with the theme instead of shipping a palette of its own — including light and dark.Speaks the same props
color, size, variant, and the spacing shorthands mean the same thing they mean on a Button. A developer who knows the UI package can already use the extension.Fits the space it is given
Components size themselves from their container rather than from fixed pixel values, so an extension works in a sidebar, a modal, and a phone screen without per-breakpoint code.Ships its own docs
Typed props with JSDoc, a demos folder per component, and a meta entry — the same layout the docs site generates these pages from, so an extension can be documented the same way.Published extensions
@platform-blocks/charts
official
25 chart types — line, bar, area, pie, heatmap, sankey, candlestick, and more — themed by the same tokens as the UI components.
Build your own
Built an extension? Publish it to npm, then open a pull request adding it to this registry.
1
Start from the template
It ships a themed sample component, an Expo example app that hot-reloads the package on iOS, Android, and web, tests, linting, CI, and a one-command npm release.2
Keep @platform-blocks/react-ui-library a peer dependency
A bundled second copy of the UI package means two theme contexts, and components that silently stop sharing the theme.3
Publish, then open a pull request
Add one entry to the registry in apps/react-ui-library.com/config/extensions.ts with a link and a one-line description.</>
react-ui-library
100+ accessible, themeable components that work seamlessly across iOS, Android, and Web.
A Platform Blocks product.
Quick Links
Resources