pnpm Scripts Reference

Complete reference for all Turborepo-orchestrated pnpm scripts in Nebutra-Sailor.

All scripts are orchestrated by Turborepo and run from the monorepo root unless otherwise noted.

# Run any script from the monorepo root
pnpm <script>

# Run a script for a specific package
pnpm --filter @nebutra/ui typecheck
pnpm --filter apps/web dev

Development

ScriptDescription
pnpm devStart all apps simultaneously
pnpm dev:dashboardWeb (3000) + Admin (3002) + API gateway (3001)
pnpm dev:marketingLanding page (3002) + Sanity Studio (3333)
pnpm dev:ai-saasAll 6 AI SaaS apps
pnpm dev:overseasInternational locale apps (4 apps)
pnpm dev:growthGrowth-focused apps (3 apps)
pnpm dev:creativeCreative suite apps (2 apps)
pnpm dev:blogBlog apps (2 apps)
pnpm dev:communityCommunity platform apps (3 apps)
pnpm dev:soloSolo developer bundle (4 apps)
pnpm dev:designDesign tools (2 apps)

Build

ScriptDescription
pnpm buildProduction build for all apps
pnpm build:ai-saasBuild AI SaaS preset (6 apps)
pnpm build:marketingBuild marketing preset (3 apps)
pnpm build:dashboardBuild dashboard preset (3 apps)

Code quality

ScriptDescription
pnpm typecheckTypeScript type checking (turbo, all packages)
pnpm lintBiome lint (all packages)
pnpm lint:fixAuto-fix lint issues
pnpm formatBiome format (all packages)

Testing

ScriptDescription
pnpm testRun all Vitest unit tests
pnpm test:watchWatch mode
pnpm test:coverageWith coverage report (80% threshold)
pnpm test:archArchitecture conformance tests
pnpm e2ePlaywright E2E tests

Database

ScriptDescription
pnpm db:generateRegenerate Prisma client
pnpm db:migrateRun pending migrations
pnpm db:pushPush schema without migration
pnpm db:studioLaunch Prisma Studio GUI

Infrastructure

ScriptDescription
pnpm infra:upStart full Docker stack (PG + Redis + ClickHouse + Meilisearch)
pnpm infra:liteStart lite stack (PostgreSQL only — fastest)
pnpm infra:downStop all services
pnpm check-envValidate environment variables

Brand & Design

ScriptDescription
pnpm brand:syncSync brand assets across packages
pnpm brand:initInitialize brand configuration
pnpm brand:applyApply brand changes to all packages
pnpm brand:paletteInteractive palette generator
# Generate a custom color palette
node scripts/generate-palette.mjs --primary=#7C3AED --secondary=#F59E0B

API & Types

ScriptDescription
pnpm generate:api-typesRegenerate TypeScript types from OpenAPI spec
pnpm docs:cliAuto-generate CLI reference documentation

Preset & Configuration

ScriptDescription
pnpm preset:envConfigure active preset via interactive CLI

Release & Versioning

ScriptDescription
pnpm version:packagesBump package versions (changesets)
pnpm releasePublish packages to npm registry
# Standard release workflow
pnpm version:packages   # Bump versions based on changesets
git push --follow-tags
pnpm release            # Publish to npm

Bundle analysis

ScriptDescription
pnpm sizeCheck bundle size against budget
pnpm size:whyDetailed bundle composition analysis

Governance & compliance

ScriptDescription
pnpm license:checkAudit production dependency licenses
pnpm ui:validate-policyValidate UI token governance policy
pnpm ui:verify-governanceStrict governance verification

Useful combos

# Fresh start (full reset)
pnpm infra:down
pnpm infra:up
pnpm db:migrate

# Before a commit
pnpm typecheck && pnpm lint && pnpm test

# After pulling changes
pnpm install
pnpm db:generate
pnpm db:migrate

# Storybook development
pnpm --filter @nebutra/storybook dev

# Production readiness check
pnpm build && pnpm test && pnpm e2e

Filter syntax

Use --filter to target specific apps or packages:

# By package name
pnpm --filter @nebutra/ui typecheck
pnpm --filter @nebutra/billing test

# By app name (without @)
pnpm --filter landing dev
pnpm --filter web build

# Multiple filters
pnpm --filter @nebutra/ui --filter @nebutra/tokens build

# Run script in all packages
pnpm -r typecheck

Turborepo caching

Turborepo caches task outputs locally and (optionally) remotely. Cache hits are shown with cache hit, replaying output.

# Force re-run, bypass cache
pnpm build --force

# Remote caching (requires Vercel account)
pnpm dlx turbo login
pnpm dlx turbo link

How is this guide?

Edit on GitHub

Last updated on

On this page