| name | bun |
| description | Bun package manager and build commands for this OwlMeans Native monorepo. Use when installing packages, building, watching, or running scripts. Covers workspace filters, tsc -b builds, and monorepo-specific patterns. |
| allowed-tools | Bash(bun *) |
Bun — OwlMeans Native Monorepo
Uses Bun 1.3.10. Always use bun, never yarn or npm.
Package Management
- Install all workspace deps:
bun install
- Add dep to specific workspace:
bun add <pkg> --cwd packages/<name>
- Add dep to root:
bun add <pkg>
- Lock file:
bun.lock (tracked in git)
- Workspace config:
workspaces: ["packages/*", "libraries/common/packages/..."] in root package.json
- Common packages are consumed via
libraries/common/ symlink — explicit entries only (no globs)
Building
- Build all packages:
bun run build from root
- Build one package:
bun run build from inside packages/<name>, or bun --filter '@owlmeans/<name>' run build from root
- Each package compiles with:
tsc -b (no bundler, pure TypeScript)
- Output:
packages/<name>/build/
- Watch mode:
bun run watch → tsc -b -w per package
- Dev mode:
bun run dev → nodemon watching src/
Root Scripts
"dev": "bun run --filter './packages/*' --parallel dev",
"build": "bun run --filter './packages/*' build",
"watch": "bun run --filter './packages/*' --parallel watch"
Scripts target only packages/* — not the linked library packages from libraries/common/.
Rules & Gotchas
- Syntax:
bun run --filter <pattern> <script> — NOT bun --filter ... run <script>
- Hoisted linker required:
bunfig.toml must have [install] linker = "hoisted"
- Common packages listed explicitly in
workspaces — never use libraries/common/packages/* glob
- Common packages dep versions: always semver
"^0.1.2", never workspace:*
dep-config is always "workspace:*" (resolves via libraries/common/packages/dep-config workspace entry)- Adding a new common package: append
"libraries/common/packages/<name>" to root package.json workspaces, then bun install
