> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rainy-mate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Local setup

> Set up Rainy MaTE for local development with frontend and Tauri runtime.

<Warning>
  `BETA 1` desktop distribution is macOS-only right now. Windows and Linux support is planned for a near-future release.
</Warning>

## Prerequisites

Install these tools before cloning:

* Node.js `18+`
* pnpm
* Rust toolchain
* Tauri prerequisites for your operating system

## Clone and install

```bash theme={null}
git clone https://github.com/ferxalbs/rainy-mate.git
cd rainy-mate
pnpm install
```

## Run development modes

UI only:

```bash theme={null}
pnpm run dev
```

Desktop app (UI + Tauri backend):

```bash theme={null}
pnpm run tauri dev
```

## Build locally

```bash theme={null}
pnpm run build
pnpm run preview
```

## Optional related services

If your workspace includes related private services, run them separately:

```bash theme={null}
cd rainy-atm && bun run dev
```

```bash theme={null}
cd rainy-api-v2 && bun run dev
```

<Info>
  `rainy-atm` is internal/private infrastructure. `rainy-api-v2` and `rainy-sdk` may exist as related projects outside this checkout.
</Info>