open-index/open-npm huggingface dataset:
npm package: @itireact/react-components
Description: This repository contains the ITI React component library — a small collection of reusable React + TypeScript components packaged for use in other projects.
Latest version: 0.1.24

# ITI React Component Library

This repository contains the ITI React component library — a small collection of reusable React + TypeScript components packaged for use in other projects.

The library is built with Vite and TypeScript and is intended to provide consistent UI building blocks for ITI applications.

## Install

Install the published package into your application (example package name used here — replace with the actual package name if different):

```bash
npm install @itireact/react-components
# or
yarn add @itireact/react-components
```

## Basic usage

Import the components you need and use them in your React app:

```tsx
import React from "react";
import { PrimaryButton, BasicCard } from "@itireact/react-components";

export default function Example() {
  return (
    <div>
      <BasicCard title="Welcome">
        <p>This is an example card from the ITI component library.</p>
        <PrimaryButton onClick={() => alert("Clicked")}>Click me</PrimaryButton>
      </BasicCard>
    </div>
  );
}
```

## Available components

The library exposes a small set of UI primitives (see `src/components` for source):

- Buttons
  - `PrimaryButton`
  - `OutlineButton`
- Cards
  - `BasicCard`
  - `ImageCard`
- Navigation
  - `BasicNavbar`
  - `GradientNavbar`
  - `SideNavbar`
- Footers
  - `BasicFooter`

If you add or change components, update this list accordingly.

## Development

Run and iterate locally using the scripts in `package.json`.

Install dependencies:

```bash
npm install
```

Start the dev server (local example/demo app):

```bash
npm run dev
```

Build the library for production:

```bash
npm run build
```

Publish the library (project already includes a `publish-library.sh` script in `scripts/`):

```bash
npm run publish:lib
```

## Contributing

Contributions are welcome. Please follow these simple steps:

1. Fork the repo.
2. Create a feature branch.
3. Add or update components and tests.
4. Run the build and make sure the demo app works.
5. Open a PR with a clear summary of changes.

## License

Specify the project license here (e.g. MIT). If you need a different license, update `LICENSE` accordingly.

---

If you want, I can also add a short example project in `examples/` or update the `package.json` `homepage`/`repository` fields. Tell me what else you'd like to include.