# Run a first ui-components example

Start with the smallest workflow described by the README for **ui-components**. Complete [installation and configuration](/docs/up-to-code-ui-components/installation-guide) first.

## Run locally

```bash
bun install
bun run dev
```

Open [http://localhost:3000](http://localhost:3000).

## Verify your changes

The root manifest provides this check:

```sh
npm run typecheck
```

Read any errors before continuing. Build and type checks verify source consistency; exercise the README example to verify the behavior you need.

## Next task

[Read the usage guide](/docs/up-to-code-ui-components/usage-guide) for the documented components, configuration, and source layout.

## Source and help

- [GitHub repository](https://github.com/Up-to-code/ui-components)
- [Original README](https://github.com/Up-to-code/ui-components/blob/main/README.md)
- [Issues and existing reports](https://github.com/Up-to-code/ui-components/issues)
- [Open the project website](https://beui.dev)

The catalog identifies the license as **MIT**. Read the repository license before redistributing source or assets.

This catalog entry is a fork. The README may describe upstream packages, domains, or release procedures; those destinations do not establish a separate release of this fork.