Osuki Kit

React Native and Expo UI, built for products that are read as much as they are tapped — dense screens, long lists, CJK text beside Latin text.

Plain React Native styles, semantic theme tokens, and dark mode treated with the same care as light. No utility classes, no className, no runtime style engine.

Commerce templates	Form primitives	The same screens, dark
Config-driven settings	Swappable theme presets	Multi-step checkout

Screens from apps/native, the Expo showcase app in this repository.

Packages

Package	What it is
@osuki-dev/ui	65 primitives and the theme: Text, Button, Input, Select, Sheet, Dialog, Tabs, ListItem, Screen, EmptyState, Toast
@osuki-dev/kit-community	~30 whole screens driven by config objects: auth, settings, dashboard, list/detail/form, commerce, content

Reach for a kit-community screen when the screen is a shape the kit already knows, and drop to @osuki-dev/ui when it is not.

npx expo install @osuki-dev/ui @osuki-dev/kit-community

Then mount one provider:

import { ThemeProvider } from "@osuki-dev/ui";

export function Root() {
	return (
		<ThemeProvider>
			<App />
		</ThemeProvider>
	);
}

Both packages are MIT and released together on the same version. Nothing is bundled — every shared runtime library is a peer dependency, so you control its version. getting-started.md has the table.

Support matrix

@osuki-dev/ui	Expo SDK	React Native	React
1.0.x	57	0.86	19.2

Each release targets one Expo SDK. When a new SDK ships, a compatible release follows; older SDKs are not backported.

Documentation

The docs ship inside the npm package, at node_modules/@osuki-dev/ui/docs/, so they can never drift from the version you installed and an agent can read them offline. In this repository they live in packages/ui/docs/:

You are…	Read
setting up a new app	getting-started.md
choosing a component	components.md
theming, dark mode, brand colour	theme.md
assembling a whole screen	patterns.md
reviewing a diff	conventions.md

For coding agents

.agents/skills/osuki-kit/SKILL.md is a skill an agent can load before writing UI with these packages. Copy it into your own project's skills directory, or point your agent at the path. For changing the packages themselves rather than consuming them, there is osuki-ui-architecture.

The showcase app

apps/native is a real Expo Router app covering every primitive and template — it is where the screenshots above come from.

bun install
bun run dev:native

cd apps/native
bun run ios       # or: bun run android

ios/ and android/ are generated, not committed. Every native setting that must survive regeneration lives in apps/native/app.json — bundle identifiers, icons, splash screen, iOS privacy manifest, config plugins. Editing the generated projects directly is not durable: the next expo prebuild discards it.

The app reads from a local SQLite adapter by default. The commerce screens can also read a Shopify storefront; the committed default points at a public demo store, and EXPO_PUBLIC_SHOPIFY_STOREFRONT_DOMAIN / EXPO_PUBLIC_SHOPIFY_STOREFRONT_ACCESS_TOKEN point it at your own.

End-to-end coverage

cd apps/native
bun run e2e:generate
bun run e2e:ios       # or: bun run e2e:android

Flows are generated one per page, plus a /component-e2e route that exercises every exported primitive, and executed by agent-device. The coverage report is written to apps/native/e2e/generated/COVERAGE.md.

Development

bun run check                  # lint, format, types, tests
bun run check:docs-coverage    # every exported component is documented
bun run smoke:public-packages  # both packages pack and install cleanly

Adding an export without documenting it fails the build.

Contributing

Read CONTRIBUTING.md first — it states up front which changes are accepted, so a rejection is never a surprise. Bug fixes, accessibility fixes, platform differences, and documentation are welcome as PRs. New components are decided by the roadmap.

• Code of Conduct
• Security policy — never report a vulnerability in a public issue
• Component quality bar

License

MIT © Osuki

The MIT License covers code only. The Osuki name, logo, and brand assets are not included — see NOTICE.