Skip to content

Monorepo support

xtarterize detects monorepos and filters tasks by scope, so the offered list matches your current directory.

xtarterize looks for these markers at or above the current directory:

  • pnpm-workspace.yaml
  • turbo.json
  • nx.json
  • lerna.json
  • At least two of packages/, apps/, or services/

A marker inside packages/, apps/, or services/ means you are inside a workspace package.

Scope Applies at
root Monorepo root only
package Inside a workspace package only
both Everywhere

Running at the monorepo root offers CI workflows, release tooling, turbo.json, Renovate, .vscode settings, root scripts, .npmrc, and cross-cutting tooling such as Biome, Knip, and TypeScript strict mode. Package-only tasks, such as Vite plugins and tsconfig path aliases, are hidden.

Running inside a workspace package offers package-scoped tasks plus cross-cutting tooling; root-only tasks are hidden.

In single-package projects, scope filtering is disabled and every applicable task is offered.

See the task catalog for task IDs, and the configuration guide for gating rules.