Monorepos

Overview

Paradev 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 several services from the 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.

Git Submodules

Add to the setup script:

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