Source CLI

Quick start

The archive includes React exports, typed props, styles, assets and source. It has not been published to npm.

Install and import

npm install react@19.2.4 react-dom@19.2.4 ./helios-ui-react-0.1.0.tgz

pnpm add react@19.2.4 react-dom@19.2.4 ./helios-ui-react-0.1.0.tgz

yarn add react@19.2.4 react-dom@19.2.4 ./helios-ui-react-0.1.0.tgz

Import an export and the styles

'use client';
import { NativeScope, NativeButton } from '@helios-ui/react';
import '@helios-ui/react/styles.css';

export default function App() {
  return <NativeScope><NativeButton onClick={() => console.log('Continue')}>Continue</NativeButton></NativeScope>;
}

Copy source from this checkout

The local source copier lists components and copies the shared dependency closure without overwriting an existing directory.

node helios-ui-site/scripts/copy-component.mjs --list
node helios-ui-site/scripts/copy-component.mjs button --to ./src/components/helios-ui

Install the dependencies listed in the copied package manifest. This local script is available in the source checkout; no non-existent npm installer is required.

Monorepos and custom aliases

Install the archive in the workspace that renders the components. Resolve its file path relative to that workspace. For editable source, run the copier from the Helios source checkout and choose a new destination in the consuming application; --to accepts relative or absolute paths.

node helios-ui-site/scripts/copy-component.mjs button --to ./apps/web/src/components/helios-button

The generated USAGE.tsx imports its local barrel. If your application uses an alias, configure that alias in both its TypeScript and bundler settings before changing those imports.

Available commands and safety

--list prints component IDs and named exports. A component ID plus --to copies its source dependency closure, styles, declarations, example and dependency manifest. Button, input, dialog and data-table aliases are supported. An unknown ID or an existing destination exits with an error before copying; existing files are never overwritten.

This local copier does not run package installation, contact a provider, install agent skills, or collect telemetry. Review the copied manifest and install its declared dependencies in the consuming project.

Updating copied components

Rebuild the library from the reviewed checkout, copy into a new directory, and compare that directory with your existing implementation. Merge only the changes you need and rerun your application checks. The copier deliberately has no overwrite or automatic-update mode.

npm run components:build --prefix helios-ui-site
node helios-ui-site/scripts/copy-component.mjs button --to ./src/components/helios-button-review

Template assets

The package includes a public-assets folder with all template images/video and the icon sprite. Copy its contents into the host application’s public directory, preserving paths, before using template defaults. Templates accept assetsBase for image paths.

Tech stack

Showcase: Next.js 16 App Router, React 19, TypeScript and Tailwind CSS 4. Component behavior: React Aria, TanStack Table, Motion, and Recharts.

Set a .dark ancestor for dark mode. Accent variables adapt action surfaces and their labels; reduced motion is respected.

Dark mode

Set the theme on a containing element. Use the same stylesheet in both modes. Accent and label colors must be chosen together so labels remain readable; repeating motion also respects the browser’s reduced-motion preference.

<div className="dark">
  <Button>Continue</Button>
</div>

Inspect the color roles and typography before overriding semantic tokens.

Accent color

The shared accent ramp drives action fills, selected states and focus rings. Choose an audited preset or a custom color from the Color foundation. Data-series and status colors retain their semantic meaning. Review contrast for any custom override.

Plans and access

The downloadable archive is a local preview. INR plan cards describe proposals; checkout and paid-license activation remain closed. No registry login, purchase or license token is required for this local archive.