Compatibility
The React, React Native and react-native-screens versions TerraUI supports, the platforms it targets, and how its versions move.
Peer versions
TerraUI supports exactly the versions it is built and tested with:
| Peer | Range | Version |
|---|---|---|
react | ~19.3.0 | React 19.3 |
react-native | ~0.88.0 | React Native 0.88 |
react-native-screens | ~4.30.0 | react-native-screens 4.30 |
These are the versions Expo SDK 58 ships. Older and newer releases are not claimed. A range widens only after a CI run proves the wider one works.
TerraUI needs nothing else: no Expo module, no styling library, no animation library and no icon set. Expo is optional.
Platforms
- iOS and Android: the supported targets.
- Web: not supported. These docs render components through react-native-web for the "Try it (web)" tabs, as an approximation; the iOS and Android captures are the reference.
What the package ships
- Compiled JavaScript: unminified ES modules, so your bundler needs no extra setup to compile TerraUI.
- Type declarations:
.d.tsfiles that keep their documentation comments, so your editor explains every prop. - Docs: these pages as Markdown, in the version you installed.
There is no source and there are no source maps.
Entry points
The root, @terratcg/ui, exports everything public. Each component family also has a subpath, such as @terratcg/ui/button or @terratcg/ui/theme. Anything not listed in the package's exports is internal, and may change in any release.
Versions
TerraUI is on 0.x. Until 1.0:
- Minor (0.1 to 0.2): may break your code. Read the changelog before upgrading.
- Patch (0.1.0 to 0.1.1): compatible fixes.
Pin a minor range, such as ~0.1.0, and upgrade deliberately. Every release has a changelog entry. These docs describe the latest release, whose version is in the header.