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

# linkapp dev

> Start the development server with live preview and hot reloading

## Usage

```bash theme={"system"}
npx @linktr.ee/linkapp dev [options]
```

Starts the Rsbuild dev server for your LinkApp. The CLI will try port `3000`; if it is busy, it picks the next available port and prints it.

## Options

| Flag            | Description               | Default |
| --------------- | ------------------------- | ------- |
| `--port <port>` | Preferred dev server port | `3000`  |
| `-h, --help`    | Show command help         | -       |

## What it does

* Generates `.linkapp` entrypoints for layouts found in your project (`sheet`, `featured`, and `featured-carousel` when present).
* Serves static assets from your project `public/` folder (mirrors legacy dev-server behavior).
* Watches `linkapp.config.ts` (root or `.config/`) and restarts the dev server when it changes.
* Prints ready URLs and the latest ready time after each start or restart.

## Keyboard shortcuts

* `r` — restart the dev server
* `u` — show the current URLs
* `c` — clear the console
* `q` or `Ctrl+C` — exit

## Typical flow

```bash theme={"system"}
npx @linktr.ee/linkapp dev
# edit app/, components/, linkapp.config.ts
# browser reloads automatically
```

If the CLI restarts after a config change, it reloads preview props and settings from `linkapp.config.ts` before serving again.