> For the complete documentation index, see [llms.txt](https://docs.giize.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giize.com/ticket-dashboard-en/getting-started/quick-start.md).

# Quick Start

## Requirements

* Node.js `^20.19.0 || >=22.12.0` (`.nvmrc` selects Node 22)
* npm `>=9`
* Playwright Chromium

## Clean setup

```bash
nvm use
npm run setup
npx playwright install chromium
```

The repository intentionally has separate root and frontend lockfiles. `npm run setup` installs both with `npm ci`.

## Run locally

```bash
npm run dev
```

The launcher starts Vite on localhost, opens the browser, and lets you configure the SDP background-refresh interval.

## Runtime notes

* React pages live under `frontend/src/`.
* `frontend/vite.config.js` is a thin adapter over extracted modules in `server/`.
* Node/Playwright workers live under `scripts/`.
* Generated cache, session, state, and log files live under `data/`.
* `npm run build` creates only the static frontend; integrations require the local runtime started by `npm run dev`.

## Verify a checkout

```bash
npm run verify
```

This runs Node/server/script lint, frontend lint, Node syntax checks, tests, documentation link validation, and the production frontend build.

## Next reading

* `Architecture Overview` for the current C1/C2/C3 structure
* `My Portal And Portal Tools` for IT Portal tracking and workflow actions
* `OpenVPN Pipeline` for VPN ticket automation