Skip to content

docs: run Vite+ through pnpm exec #90

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
altaywtf merged 1 commit into from
Oct 4, 2026
Merged

docs: run Vite+ through pnpm exec #90

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 20 additions & 16 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -103,36 +103,40 @@ touches, and search `node_modules/effect/src` for anything it does not cover.

## Checks

Vite+ is the pinned `vite-plus` devDependency, so run it as `pnpm exec vp`; no
global install is needed.

```bash
vp install
vp run hooks:install
vp run verify
pnpm install
pnpm exec vp run hooks:install
pnpm exec vp run verify
```

Fast loops:

```bash
vp run check
vp run typecheck
vp run smoke
vp run test
pnpm exec vp run check
pnpm exec vp run typecheck
pnpm exec vp run smoke
pnpm exec vp run test
```

Live Roku checks when a developer-enabled device exists:
Live Roku checks when a developer-enabled device exists; `node dist/rokit.mjs`
is the CLI that `live:smoke` builds:

```bash
ROKIT_TARGET=<roku-ip> vp run live:smoke
ROKIT_TARGET=<roku-ip> ROKIT_PASSWORD=<password> vp run live:probe
ROKIT_TARGET=<roku-ip> vp exec rokit check
ROKIT_TARGET=<roku-ip> vp exec rokit launch dev
ROKIT_TARGET=<roku-ip> vp exec rokit press Info Back
ROKIT_TARGET=<roku-ip> pnpm exec vp run live:smoke
ROKIT_TARGET=<roku-ip> ROKIT_PASSWORD=<password> pnpm exec vp run live:probe
ROKIT_TARGET=<roku-ip> node dist/rokit.mjs check
ROKIT_TARGET=<roku-ip> node dist/rokit.mjs launch dev
ROKIT_TARGET=<roku-ip> node dist/rokit.mjs press Info Back
```

Which proof a change needs:

- Docs only: `vp run check`, plus `vp run skills:lint` for `skills/`; no
device run.
- Source, command, env, output or export changes: `vp run verify`.
- Docs only: `pnpm exec vp run check`, plus `pnpm exec vp run skills:lint` for
`skills/`; no device run.
- Source, command, env, output or export changes: `pnpm exec vp run verify`.
- Device-facing behavior: `verify`, then `live:smoke` (read-only) or
`live:probe` (installs the generic probe channel).

Expand Down
10 changes: 5 additions & 5 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,15 @@
## Setup

```bash
vp install
pnpm install
```

## Run Locally

Use the built CLI through the package scripts while developing:

```bash
vp run smoke
pnpm exec vp run smoke
```

For live Roku checks, set local environment variables in your shell or
Expand All @@ -20,7 +20,7 @@ For live Roku checks, set local environment variables in your shell or
## Validation

```bash
vp run verify
pnpm exec vp run verify
```

`verify` runs formatting/lint checks, skill lint, TypeScript, package bundling,
Expand All @@ -32,8 +32,8 @@ before release.
Live checks require a developer-enabled Roku on the same network:

```bash
ROKIT_TARGET=<roku-ip> vp run live:smoke
ROKIT_TARGET=<roku-ip> vp exec rokit press Info Back
ROKIT_TARGET=<roku-ip> pnpm exec vp run live:smoke
ROKIT_TARGET=<roku-ip> node dist/rokit.mjs press Info Back
```

Screenshots and installs require `ROKIT_PASSWORD`.
Expand Down