> 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/product-docs/getting-started/quick-start.md).

# Quick Start

## Requirements

* Node.js `>= 18`
* npm `>= 9`
* Playwright Chromium installed

```bash
npx playwright install chromium
```

## Run Locally

```bash
npm run dev
```

## Important Runtime Notes

* the frontend is React + Vite
* the current backend behavior lives in `frontend/vite.config.js`
* automation features depend on local Node/Playwright scripts in `scripts/`
* many workflows depend on session state files under `data/`

## What Works Only In Dev Runtime

The built frontend alone is not enough for:

* scraping
* session-aware integrations
* workflow automation
* local JSON state updates

These features require the middleware + scripts runtime that starts with `npm run dev`.

## Next Reading

* `Architecture Overview` for code structure
* `Order Report` if you work with IT Portal order flows
* `OpenVPN Pipeline` if you work with VPN ticket automation