Workspace

Overview

The workspace schematic creates the root of a NanoForge monorepo: the nanoforge.config.ts workspace declaration, package.json, and TypeScript or JavaScript base config. A workspace holds one or more projects generated with the project schematic under apps/. @nanoforge-dev/cli, @nanoforge-dev/config (using the engine version resolved from @nanoforge-dev/core) and (for TypeScript) typescript are pinned to the newest registry version published at least 48h ago at generation time, mirroring pnpm’s own minimumReleaseAge supply-chain protection so a freshly (and potentially compromised) published release isn’t picked up immediately. Non-nanoforge packages like typescript are pinned to a specific version rather than a range; typescript is also kept on its 6.x line rather than jumping to the 7.x native rewrite.

Usage

schematics @nanoforge-dev/schematics:workspace --name=my-game

Options

Option	Type	Default	Description
`name`	`string`	`nanoforge-workspace`
`directory`	`string`	`name`
`language`	`"ts" \| "js"`	`ts`	Language to use for generated source files
`strict`	`boolean`	`true`
`packageManager`	`"npm" \| "yarn" \| "pnpm" \| "bun"`	`npm`
`allowBuilds`	`string[]`	`[]`

Generated structure

my-game/
├── package.json
├── tsconfig.json          # TypeScript only
├── tsconfig.spec.json     # TypeScript only
├── jsconfig.json          # JavaScript only
├── pnpm-workspace.yaml    # if packageManager: pnpm — allowBuilds map
├── nanoforge.config.ts    # (or .js)
├── .gitignore
├── README.md
└── apps/                  # generated with the `project` schematic

Examples

Minimal TypeScript workspace:

schematics @nanoforge-dev/schematics:workspace --name=my-game

pnpm workspace:

schematics @nanoforge-dev/schematics:workspace \
  --name=my-game \
  --packageManager=pnpm

pnpm workspace allowing an extra dependency’s build scripts (bun is always allowed):

schematics @nanoforge-dev/schematics:workspace \
  --name=my-game \
  --packageManager=pnpm \
  --allowBuilds=esbuild

Commands

Configuration

Getting-Started

Schematics

Overview

Usage

Options

Generated structure

Examples

​Overview

​Usage

​Options

​Generated structure

​Examples

Overview

Usage

Options

Generated structure

Examples