# Pnpm Monorepo Workflows

> Use this when installing dependencies, running dev servers, building packages, or running scripts in this pnpm monorepo.

- Skill: `tomevault-io/pnpm-monorepo-workflows` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/pnpm-monorepo-workflows`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/pnpm-monorepo-workflows/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- 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/pnpm-monorepo-workflows

---


# pnpm monorepo workflows (Cloudflare Workers SaaS kit)

Use this skill whenever the user asks to set up the repo, run dev servers, rebuild shared packages, or troubleshoot script execution.

## Key packages

- `apps/user-application`: TanStack Start (SSR) app running on Cloudflare Workers
- `apps/data-service`: Backend API Worker (Hono)
- `packages/data-ops`: Shared library for Drizzle ORM + Better Auth

## Setup

- Initial setup (install + build shared lib): `pnpm run setup`

## Dev servers

- User app dev: `pnpm run dev:user-application` (typically on port 3000)
- Data service dev: `pnpm run dev:data-service`

## Shared package builds

- Rebuild shared library after changes: `pnpm run build:data-ops`

## Script hygiene

- Use `pnpm -w ...` only if a script is defined at workspace root.
- Prefer package-scoped scripts:
  - `pnpm --filter data-ops <script>`
  - `pnpm --filter user-application <script>`
  - `pnpm --filter data-service <script>`

## Linting & typechecking

- Lint UI package: `pnpm --filter @workspace/ui lint`
- Typecheck a single package/app (recommended when debugging TS issues):
  - `pnpm -C apps/user-application tsc --noEmit`
  - `pnpm -C apps/data-service tsc --noEmit`
  - `pnpm -C packages/data-ops tsc --noEmit`
  - `pnpm -C packages/ui tsc --noEmit`

## Troubleshooting quick checks

- Ensure `pnpm-lock.yaml` is consistent (avoid mixing npm/yarn).
- If types/bindings changed, regenerate worker types (see the worker typegen skill).
- If `packages/data-ops` changed and consumers are broken, run `pnpm run build:data-ops` and restart dev servers.

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