@kuloudx/mobius-ui
v1.1.0
Published
Business-neutral React UI components, semantic themes and desktop/mobile templates
Readme
Mobius UI
Version 1.1.0 release prepared; registry publication pending, npm stable 1.0.0. Business-neutral React components and desktop/mobile templates, with an optional native Taro adapter.
npm install @kuloudx/mobius-ui react react-dom radix-uiimport { ThemeProvider, Button, Panel } from '@kuloudx/mobius-ui';
import '@kuloudx/mobius-ui/styles.css';
<ThemeProvider theme="indigo" mode="light" density="comfortable">
<Panel title="Workspace">
<Button onClick={save}>Save</Button>
</Panel>
</ThemeProvider>;Themes: evergreen, indigo, graphite. Modes: light/dark. Density: comfortable/touch. Mobile browser templates use density="touch".
Native Taro 4.2
import { Theme, Panel, Button } from '@kuloudx/mobius-ui/taro';
import '@kuloudx/mobius-ui/taro/tokens.css';
import '@kuloudx/mobius-ui/taro/components.css';Install @tarojs/taro and @tarojs/components only for this entry. Do not import the Web entry or Radix into a mini-program. Native adapter currently includes Theme, Button, Panel, Field, Badge, EmptyState, CopyText, Thumbnail and BottomSheet; it does not promise parity for every desktop template.
Application contracts
Data, authorization, navigation, uploads, revision conflicts, idempotency and writes remain in the application. Components never fake saved or approved state. Field associates a single direct control automatically; compound/custom containers require explicit id, aria-invalid and aria-describedby. Dialog consumers own dirty-draft close policy. CopyText requires clipboard access in a secure browser context.
See DESIGN-SYSTEM.md for tokens, states, composition, accessibility targets and verification limits. See CHANGELOG.md for version changes. Public demos are excluded from the npm package.
Maintenance and consumption
Mobius is maintained as an independent project. It owns the npm package, tokens, Storybook, tests and release records. Consumer applications (including Agrova) install a reviewed exact npm version; they must not import sibling repository paths, link workspace sources in production or copy universal component implementations. Application adapters may map existing brand tokens and retain application APIs/permissions. Web and native Taro are migrated and verified separately.
Run pnpm storybook in the Mobius repository for live component development and pnpm check before release. Package changes follow SemVer; consumers upgrade deliberately after regression checks. See the workbench's contribution guide for state and accessibility requirements.
