@impulse-ui-native/primitives

Token-aware React Native building blocks used directly by applications and by the higher-level Impulse UI Native packages.

Installation

pnpm add @impulse-ui-native/primitives

Render primitives inside ThemeProvider from @impulse-ui-native/theme.

Main exports

• View adds theme spacing, dimensions, flex, borders, colors, and shadow props to React Native's view.
• SafeAreaView maps safe-area edges to the theme spacing scale.
• Typography exposes named text presets such as DisplayLarge, Title1, Body, Caption, and Code.
• Button, IconButton, Pressable, and Tag provide themed interaction primitives.
• Control is a compound control system with Provider, Root, Label, Container, Addon, Input, Placeholder, Value, Loader, and Error parts.
• createPreset creates reusable themed typography presets.
• Public prop types describe every primitive and control part.

Example

import { Button, Tag, Typography, View } from "@impulse-ui-native/primitives";

export function ProfileSummary() {
  return (
    <View gap="md" padding="lg">
      <Typography.Title3>Profile</Typography.Title3>
      <Tag label="Active" color="success" />
      <Button variant="filled" onPress={() => {}}>
        Continue
      </Button>
    </View>
  );
}

Use the compound Control when building a custom field that should share the same label, addon, error, size, and variant behavior as Input and Select.