@libria/scaffold-plugin-ts-workspace

@libria/scaffold-plugin-ts-workspace

TypeScript workspace (monorepo) template for @libria/scaffold.

This plugin manages TypeScript monorepo workspaces with npm workspaces and TypeScript project references. It provides two subcommands: init to create a new workspace, and add to add projects into an existing workspace.

Installation

npm install @libria/scaffold-plugin-ts-workspace

Usage

Initialize a new workspace

# Interactive — prompts for all options
lb-scaffold new ts-workspace my-monorepo

# Non-interactive
lb-scaffold new ts-workspace my-monorepo --package-manager npm --git-init

Add a project to an existing workspace

# Interactive — prompts for template and options
lb-scaffold new ts-workspace my-project --workspace ./my-monorepo --template ts-lib

# Add an Angular app
lb-scaffold new ts-workspace my-app --workspace ./my-monorepo --template angular

# Add a NestJS backend
lb-scaffold new ts-workspace my-api --workspace ./my-monorepo --template nestjs

Supported Options

init subcommand

Option	Type	Description
--package-manager	select	Package manager (npm, yarn, pnpm)
--git-init	boolean	Initialize a git repository

add subcommand

Option	Type	Description
--workspace	string	Path to the workspace root
--template	select	Template to use (ts-lib, angular, nestjs, nextjs)
--base-path	string	Subdirectory for the new project (e.g. packages)

How It Works

The init subcommand creates a workspace directory with a root package.json (configured for npm workspaces), a shared tsconfig.base.json, and a root tsconfig.json with project references.

The add subcommand delegates to other template plugins (ts-lib, angular, nestjs, nextjs) to scaffold the project, then automatically:

• Adds the project to the workspace's package.json workspaces array
• Adds a TypeScript project reference to the root tsconfig.json
• Patches the project's tsconfig.json to extend from the workspace's tsconfig.base.json

License

MIT