# truckwashdashboardsfrontend

This template should help get you started developing with Vue 3 in Vite.

## Recommended IDE Setup

[VSCode](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur).

## Customize configuration

See [Vite Configuration Reference](https://vite.dev/config/).

## Project Setup

```sh
npm install
```

### Compile and Hot-Reload for Development

```sh
npm run dev
```

### Compile and Minify for Production

```sh
npm run build
```

## Playwright Batched Chromium Runs

Run default e2e tests in deterministic 25-test shards across `chromium-desktop` and `chromium-mobile`:

```sh
npm run test:e2e:batched:chromium
```

Run the same flow and automatically re-run failed shards with `PLAYWRIGHT_WORKERS=1`:

```sh
npm run test:e2e:batched:chromium:rerun-failed
```

Optional overrides:

```sh
PLAYWRIGHT_BATCH_SIZE=25
PLAYWRIGHT_BATCH_WORKERS=2
PLAYWRIGHT_BATCH_DEV_PORT=5193
```

You can also forward Playwright args:

```sh
npm run test:e2e:batched:chromium -- --grep @smoke
```

Artifacts and summaries:

- `output/playwright/batched-chromium/last-run.json`
- `output/playwright/batched-chromium/failed-shards.json`
- `output/playwright/batched-chromium/report-index.html`
- `output/playwright/batched-chromium-shard-<i>-of-<n>/report/index.html`
- `output/playwright/batched-chromium-rerun-shard-<i>-of-<n>/report/index.html`

## Playwright Full E2E

Run the permanent grouped full-suite entrypoint with a hard max of 5 total workers across:

- `chromium-(desktop|tablet|mobile)`
- `firefox-(desktop|tablet|mobile)`
- `webkit-(desktop|tablet|mobile)`

```sh
npm run test:e2e:ci
```

Run a single full-suite slice for one role and one Playwright project:

```sh
npm run test:e2e:full:slice -- --role=admin --project=webkit-tablet
```

Default worker allocation:

```sh
PLAYWRIGHT_PARALLEL_WORKERS_CHROMIUM=2
PLAYWRIGHT_PARALLEL_WORKERS_FIREFOX=1
PLAYWRIGHT_PARALLEL_WORKERS_WEBKIT=2
```

Optional overrides:

```sh
PLAYWRIGHT_PARALLEL_BASE_PORT=5191
PLAYWRIGHT_PARALLEL_WORKERS_CHROMIUM=2
PLAYWRIGHT_PARALLEL_WORKERS_FIREFOX=1
PLAYWRIGHT_PARALLEL_WORKERS_WEBKIT=2
```

The runner fails fast if the combined worker count exceeds 5.

Artifacts and summaries:

- `output/playwright/ci-parallel-report/index.html`
- `output/playwright/ci-parallel-chromium/report/index.html`
- `output/playwright/ci-parallel-firefox/report/index.html`
- `output/playwright/ci-parallel-webkit/report/index.html`
- `output/playwright/test-lists/<role>-<project>.txt`

## Bubblewrap (TWA) Build and Install

To build and install the Trusted Web Activity (TWA) using Bubblewrap, use the following commands:

### Build the TWA

```sh
bubblewrap build
```

### Install the TWA on a connected device

```sh
bubblewrap install
```