@vercell-manufacturing/mobile-ui

Private React Native UI package for Vercell mobile applications.

This package is a standalone npm package, not a monorepo workspace package. Apps install it as a versioned dependency from the private registry.

Requirements

• React >=19.0.0
• React Native >=0.79.0
• Metro package exports support enabled by the consuming app's RN version

Apps below RN 0.79 are unsupported.

Install

bun add @vercell-manufacturing/mobile-ui

Apps may use another package manager. The package is published and consumed as a normal npm package.

Usage

import { Button, ThemeProvider, darkTheme } from '@vercell-manufacturing/mobile-ui';

export function Screen() {
  return (
    <ThemeProvider theme={darkTheme}>
      <Button label="Continue" onPress={() => {}} />
    </ThemeProvider>
  );
}

Prefer subpath imports when an app only needs one area of the package:

import { Avatar } from '@vercell-manufacturing/mobile-ui/avatar';
import { Button } from '@vercell-manufacturing/mobile-ui/button';
import { MaterialProvider } from '@vercell-manufacturing/mobile-ui/material';
import { lightTheme } from '@vercell-manufacturing/mobile-ui/theme';
import { semanticColors } from '@vercell-manufacturing/mobile-ui/tokens';

Private deep imports are not supported.

Expo apps that want Liquid Glass and blur can opt into the optional adapter:

import { ExpoMaterialProvider } from '@vercell-manufacturing/mobile-ui/expo-material';

Expo reference app

Use fixtures/expo56-reference-app to develop and visually check components before shipping them to product apps. The fixture imports @vercell-manufacturing/mobile-ui through the public package entrypoints, so build the package before starting Expo:

bun run fixture:expo:install
bun run fixture:expo:start

For an iOS simulator smoke test against Expo Go while SDK 56 is still in preview:

bun run fixture:expo:ios-smoke

Every new component should get a fixture screen that covers its primary variants, states, and theme behavior before release. CI validates the packed tarball against the Expo fixture with:

bun run pack:artifact
bun run verify:expo

Development

bun install
bun run ci:code
bun run pack:artifact
bun run verify:consumer

Use Bun for local package management and scripts. Releases still publish through npm so the package remains compatible with standard React Native/npm tooling.

Documentation

• Consuming the package
• Adding components
• Component API conventions
• Deprecation policy
• Material accessibility follow-up
• Publishing