# Build Run Script

> Ensures `package.json` scripts for dev, build, preview, lint, test, and format are present and validates environment variable usage before running. Use when this capability is needed.

- Skill: `tomevault-io/build-run-script` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/build-run-script`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/build-run-script/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/build-run-script

---


# Build & Run Script

When to use this skill

- Use when bootstrapping the project's `package.json` scripts or when validating build-time env variables.
- Triggered by requests to add/update `dev`, `build`, `preview`, or helper scripts.

Instructions

1. First Step: Ensure `package.json` contains scripts:
  - `dev`: `vite`
  - `build`: `vite build`
  - `preview`: `vite preview --port 4173`
  - `lint`, `test`, `format` helpers as needed.

2. Second Step: Add a script `start:ci` if CI needs to build and run a static server (e.g., `serve -s dist`).

3. Third Step: Validate that required `VITE_` variables are documented and, optionally, verified at runtime with a small pre-flight check.

Examples

- `npm run dev` to start local dev server; `npm run build && npm run preview` to test production output locally.

Notes

- Encourage `cross-env` or platform-neutral approaches when setting env vars in scripts.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/cargdev) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->