# Run a first react-messenger example

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

## Run locally

Use Node.js 24.21.0 (`.nvmrc` included) and npm 12.2.0. Node.js 24.15.0–24.x or 26+ is required by npm 12.

```sh
npm ci
npm run dev
```

Open http://localhost:3000. For production:

```sh
npm run build
npm start
```

`npm start` now runs the Next.js production server; use `npm run dev` for development. Deploy using any Node.js host that supports Next.js. No environment variables or external accounts are required for demo mode. Live assistant mode is optional and requires the server settings below.

## 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-react-messenger/usage-guide) for the documented components, configuration, and source layout.

## Source and help

- [GitHub repository](https://github.com/qentrah/react-messenger)
- [Original README](https://github.com/qentrah/react-messenger/blob/migrate/nextjs/README.md)
- [Issues and existing reports](https://github.com/qentrah/react-messenger/issues)

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