# Source setup

> Clone the NatUI repository and install its pnpm workspace prerequisites.

Canonical: https://natui.dev/docs/start/source-setup

## Prerequisites [#prerequisites]

* Node.js 22 or newer
* pnpm 11
* Git
* The platform tools described in the macOS or Windows guide

```bash
git clone https://github.com/floklein/natui.git
cd natui
corepack enable
pnpm install
pnpm build
pnpm typecheck
```

`pnpm build` emits the `natui` package into `packages/natui/dist`. The examples resolve the package through the pnpm workspace, so build the package before running a standalone typecheck.

## Package entrypoints [#package-entrypoints]

The workspace exposes three entrypoints:

* `natui` for components, `run`, and advanced protocol exports
* `natui/components` for component-only bundles that avoid Node built-ins
* `natui/inproc` for the embedded host entrypoint

NatUI is not documented as a public registry package. Keep installation and examples tied to a source checkout until a packaging workflow exists.