Organizing Your Codebase: Workspaces and Repository Structure

Tue, 19 May 2026 00:00:00 +0000

Welcome back, intrepid developer! So far, you’ve mastered the basics of Jujutsu’s unique approach to version control, from its mutable history to the powerful operation log. You’ve seen how jj empowers you to shape your history with confidence. But what happens when your project grows, or when you need to juggle multiple development lines simultaneously without creating a mess of separate Git clones?

This chapter introduces you to jj’s elegant solution: workspaces. We’ll dive into how jj structures repositories and how workspaces allow you to manage multiple working directories, each potentially focused on a different task, all backed by a single, shared repository. This isn’t just about saving disk space; it’s about streamlining your workflow, improving context switching, and enabling more flexible development patterns.

Monorepo Mastery: npm Workspaces & npx Unlocked

Tue, 10 Feb 2026 00:00:00 +0000

Monorepo Mastery: npm Workspaces & npx Unlocked

Native monorepo management with npm workspaces and on-demand package execution with npx. Node.js v22.x, npm v10.x (as of 2026-02-10).

Core Setup: npm Workspaces

Initialize a monorepo and define workspace roots in the root package.json to enable npm’s native monorepo capabilities.

// root/package.json
{
"name": "my-monorepo",
"version": "1.0.0",
"private": true, // Prevents accidental publishing of the root package
"workspaces": [ // Defines directories containing workspace packages
"packages/*", // Example: packages/ui-lib, packages/utils
"apps/*" // Example: apps/web, apps/admin
],
"scripts": {
"build": "npm run build --workspaces", // Runs 'build' script in all workspaces
"test": "npm test --workspaces" // Runs 'test' script in all workspaces
},
"devDependencies": {
"typescript": "^5.3.3" // Common dev dependencies are often hoisted to the root
}
}

Each workspace package also has its own package.json.

Workspaces on AI VOID

Organizing Your Codebase: Workspaces and Repository Structure

Monorepo Mastery: npm Workspaces & npx Unlocked

Monorepo Mastery: npm Workspaces & npx Unlocked

Core Setup: npm Workspaces