Zango Components

A React component library built with Tailwind CSS. 30+ accessible components, fully typed, themeable through CSS variables.

Installation

npm install @zango-core/components

Peer dependencies — React 16.8 or newer, if your project does not already have it:

npm install react react-dom

Everything else the library needs (@radix-ui/react-dialog, lucide-react, sonner, tailwind-merge) ships as a regular dependency and installs automatically.

Usage

import { Button, Badge } from '@zango-core/components';
// CSS is bundled and injected automatically — no separate import needed.

function App() {
  return (
    <>
      <Button variant="primary">Click me</Button>
      <Badge variant="success">Active</Badge>
    </>
  );
}

Theming

Override CSS variables to re-theme the library. Unset variables fall back to their defaults, so declare only what you want to change.

:root {
  --color-brand-500: #3b82f6;
  --zango-border-radius-md: 8px;
  --zango-control-height-md: 36px;
  --zango-border-color-default: #d4d6d9;
}

Documentation

• Components — usage examples for every component
• CSS variables — full theming reference
• Development setup

Run Storybook for interactive demos and the complete prop reference:

npm run storybook

Development

Requires Node.js 22+ and npm.

git clone https://github.com/Healthlane-Technologies/zango-react-components.git
cd zango-react-components
npm install
npm run dev

| Script | Description | | --- | --- | | npm run dev | Start the development server | | npm run storybook | Start Storybook | | npm run build | Build the library | | npm run test | Run the test suite | | npm run type-check | Type-check without emitting | | npm run check | Lint, format, and organize imports |

Browser support

All modern evergreen browsers (last 2 versions of Chrome, Firefox, Safari, and Edge). The library ships ES2020 output. Internet Explorer is not supported.

Contributing

Contributions are welcome. See CONTRIBUTING.md to get started, and please follow our Code of Conduct.

License

MIT — see LICENSE.

This library is part of the Zango framework, whose licensing terms provide that all client-side JavaScript is licensed under the MIT License.