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

# Quickstart

> Get the Sirvo POS development environment running locally.

## Prerequisites

* Node.js 20+
* Python 3.8+ with Odoo 12
* Rust toolchain (for Tauri desktop builds)
* PostgreSQL

## Frontend

<Steps>
  <Step title="Install dependencies">
    ```bash theme={null}
    cd nu_pos_react
    npm install
    ```
  </Step>

  <Step title="Start the dev server">
    ```bash theme={null}
    npm run dev
    ```

    The app runs at [http://localhost:3000](http://localhost:3000).
  </Step>

  <Step title="Or launch the Tauri desktop window">
    ```bash theme={null}
    npm run desktop:dev
    ```
  </Step>
</Steps>

## Backend

<Steps>
  <Step title="Install the Odoo module">
    Copy or symlink `nu_restaurant_pos/` into your Odoo addons path.
  </Step>

  <Step title="Upgrade the module">
    ```bash theme={null}
    ./odoo-bin -d <db> -u nu_restaurant_pos \
      --addons-path=addons,extra_addons --stop-after-init
    ```
  </Step>
</Steps>

## Sync hub

<Steps>
  <Step title="Install dependencies">
    ```bash theme={null}
    cd nu_pos_hub
    npm install
    ```
  </Step>

  <Step title="Start the hub">
    ```bash theme={null}
    npm run dev
    ```
  </Step>
</Steps>

## Running tests

<Tabs>
  <Tab title="Frontend">
    ```bash theme={null}
    cd nu_pos_react
    npm run test:run
    ```
  </Tab>

  <Tab title="Sync hub">
    ```bash theme={null}
    cd nu_pos_hub
    npm run test:run
    ```
  </Tab>

  <Tab title="Sync protocol">
    ```bash theme={null}
    cd nu_pos_sync_protocol
    npm run test:run
    ```
  </Tab>

  <Tab title="Backend">
    ```bash theme={null}
    ./odoo-bin -d <db> --test-enable \
      --test-tags=nu_restaurant_pos \
      --addons-path=addons,extra_addons --stop-after-init
    ```
  </Tab>
</Tabs>