yo

library1.12.2jsnpmunverified

CLI tool for running Yeoman generators. v7.0.1 (2025) is the latest stable, requiring Node.js ^20.17.0 || >=22.9.0. Yo provides a unified interface to scaffold projects using Yeoman generator ecosystem. Key differentiators: tight integration with yeoman-environment and yeoman-generator, supports local and global generators, and offers a doctor command for troubleshooting. Alternatives like create-* packages are project-specific; yo is framework-agnostic. Release cadence is irregular but major versions (v5, v6, v7) updated dependencies (got, inquirer, meow) and dropped Node.js versions.

devops

npm install yo

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · YO

devopsjavascriptv1.12.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (CLI run)

✓ npm install --global yo && yo generator

✗ npx yo generator

Use global install for reliability; npx may cause version conflicts.

Programmatic API

✓ import { runGenerator } from 'yo'

✗ import yo from 'yo'

Programmatic API is not well-documented; the package is primarily a CLI.

Environment

✓ import { Environment } from 'yeoman-environment'

✗ import { Environment } from 'yo'

yo re-exports yeoman-environment indirectly; for advanced usage, import directly from yeoman-environment.

Shows basic usage: install yo globally, install a generator, and run it to scaffold a project. Also includes local generator and doctor commands.

// Install yo globally // npm install --global yo // Install a generator // npm install --global generator-webapp // Run the generator // yo webapp // To generate scaffold: // yo // To run a local generator: // yo ./path/to/generator // Troubleshoot: // yo doctor

yo --version

Debug

Known issues

breakingyo v7 requires Node.js ^20.17.0 or >=22.9.0; drops support for Node 18 and 19.

fix

Upgrade Node.js to 20.17.0+ or 22.9.0+.

affects: >=7.0.0

breakingyo v6 dropped completion support and removed direct dependency on inquirer, relying on @yeoman/adapter.

fix

Update generator adapters to use @yeoman/adapter. Custom scripts using inquirer directly may need updates.

affects: >=6.0.0

breakingyo v5 updated got to v11 and requires Node.js >=18.13.0.

fix

Update Node.js to 18.13.0+; check any custom HTTP logic for got v11 breaking changes.

affects: >=5.0.0

deprecatedyo v4 removed insight module for tracking; telemetry is no longer collected.

fix

No action needed; if you relied on insight, switch to your own analytics.

affects: >=4.3.1

gotchaRunning a globally installed generator requires yo to be installed globally as well. Mixing global and local installations can cause errors.

fix

Ensure yo and generators are installed in the same global prefix, or use npx with explicit version.

affects: all

Errors

Common errors & fixes

Error: Cannot find module 'yeoman-environment'

Missing required dependency when using yo programmatically or via npx.

fix

Install yeoman-environment: npm install --save-dev yeoman-environment

Error: Generator not found. Run `yo doctor` to troubleshoot.

The generator is not installed or not in the lookup path.

fix

Install the generator globally: npm install -g generator-webapp. Or use --local-only for local generators.

Error: The engine "node" is incompatible with this module.

Node.js version lower than required (>=20.17.0 for yo v7).

fix

Upgrade Node.js to 20.17.0 or 22.9.0+

Upgrade

Version history

1.12.2latest on npm

Audit

Dependencies

yeoman-environmentrequiredCore runtime to interact with generators

yeoman-generatorrequiredBase class for generators; often a peer dep

@yeoman/adapterrequiredAdapter abstraction for prompts since v7

Agent activity

19 hits · last 30 days

node

Resources

githubhttps://github.com/yeoman/yo ↗

packagehttps://www.npmjs.com/package/yo ↗

homepagehttps://yeoman.io ↗