---

name: running-scripts description: How to run scripts in this pnpm + turbo monorepo. Covers turbo task filtering, caching, package-local scripts, and common pitfalls.

Running Scripts

Key Principle

Always run from root directory unless you specifically need package-local behavior. Turbo handles dependencies automatically.

Common Commands

Building

Copy# Build all packages (respects dependency order)
pnpm turbo build

# Build specific package
pnpm turbo build --filter=@kitz/core

# Build package and its dependencies
pnpm turbo build --filter=@kitz/assert...

# Force rebuild (bypass cache)
pnpm turbo build --filter=@kitz/core --force

Type Checking

Copy# Type check all packages
pnpm turbo check:types

# Type check specific package
pnpm turbo check:types --filter=@kitz/assert

Linting

Copy# Lint all packages
pnpm turbo check:lint

# Lint specific package
pnpm turbo check:lint --filter=@kitz/core

Package Validation

Copy# Validate package.json exports (publint + attw)
pnpm turbo check:package

# Validate specific package
pnpm turbo check:package --filter=@kitz/core

Testing

Copy# Run tests for specific file (use vitest directly)
pnpm vitest packages/core/src/arr/_.test.ts --run

# Run tests for a package directory
pnpm vitest packages/core/src/arr/ --run

# Run all tests via turbo
pnpm turbo test

# ALWAYS use --run to avoid watch mode

Formatting

Copy# Format all files
pnpm format

# Check formatting
pnpm format:check

Development Mode

Copy# Watch mode for a package (rebuilds on changes)
pnpm turbo dev --filter=@kitz/core

Release

Copy# Publish packages with changesets
pnpm release

Turbo Cache

Turbo caches task outputs. If you change source files, it rebuilds. If nothing changed, it replays cached output.

Cache hit = "replaying logs" in output (task skipped)

To force fresh run:

Copypnpm turbo build --force

Or delete the build folder:

Copyrm -rf packages/core/build && pnpm turbo build --filter=@kitz/core

Package-Local Scripts

Some packages have scripts in scripts/ directories that aren't npm scripts. Run with tsx:

Copy# Assert package - regenerate builder code
tsx packages/assert/scripts/generate-builder.ts

Common Pitfalls

Notes

• Task dependencies and caching are configured in turbo.json at project root