Monorepos

Overview

Superset works with monorepos. Workspaces are created at the repo root with access to all packages.

Lifecycle Setup Script

{
  "setup": [
    "bun install",
    "cp \"$SUPERSET_ROOT_PATH/.env\" .env"
  ]
}

Running Services

Run multiple services from terminal:

bun run dev                          # All services
bun run --filter @myapp/web dev &    # Specific package
bun run --filter @myapp/api dev

Sparse Checkout

List the folders your worktrees actually need in the project's Sparse checkout setting. New worktrees for that project then materialize only those folders plus the repo-root files (git cone mode).

• Applies only to worktrees created after the setting changes; existing worktrees and the main repo are untouched
• Leave the list empty for a full checkout
• If git rejects the sparse cone, workspace creation falls back to a full checkout instead of failing

Git Submodules

Add to setup script:

{
  "setup": ["git submodule update --init --recursive", "bun install"]
}