Cloudwerk Monorepo

Workflow guide for the Cloudwerk pnpm monorepo. Covers building, testing, changesets, and package relationships.

When to Apply

Reference these guidelines when:

• Building or testing Cloudwerk packages
• Creating changesets for version bumps
• Understanding package dependencies
• Adding new packages to the monorepo
• Running the dev server

Package Structure

Commands

All commands run from the repo root:

# Build all packages (required before testing cross-package changes)
pnpm build

# Run all tests
pnpm test

# Run tests for a specific package
pnpm --filter @cloudwerk/core test
pnpm --filter @cloudwerk/cli test

# Run a single test file
pnpm --filter @cloudwerk/cli vitest --run src/server/__tests__/registerRoutes.page.test.ts

# Watch mode
pnpm --filter @cloudwerk/core test:watch

# Lint
pnpm lint

# Dev server
pnpm dev

Changeset Workflow

Every PR that changes package behavior MUST include a changeset file.

Create a changeset by adding a markdown file to .changeset/:

---
"@cloudwerk/core": patch
---

Description of the change.

Or use the helper script:

skills/cloudwerk-monorepo/scripts/changeset.sh

Bump types:

• patch — Bug fixes, minor improvements
• minor — New features, non-breaking changes
• major — Breaking API changes

Adding New Packages

When creating a new package that will be published to npm, the initial version must be published manually before the automated release pipeline can take over. Inform the user:

"This is a new package. Before the automated release works, you'll need to publish the initial version manually and set up npm access."