yarnpkg/yarn · error · MessageError

manifestNameDot

Error message

manifestNameDot

What it means

Error "manifestNameDot" thrown in yarnpkg/yarn.

Source

Thrown at src/util/normalize-manifest/validate.js:62

export default function(info: Object, isRoot: boolean, reporter: Reporter, warn: WarnFunction) {
  if (isRoot) {
    for (const key in typos) {
      if (key in info) {
        warn(reporter.lang('manifestPotentialTypo', key, typos[key]));
      }
    }
  }

  // validate name
  const {name} = info;
  if (typeof name === 'string') {
    if (isRoot && isBuiltinModule(name)) {
      warn(reporter.lang('manifestBuiltinModule', name));
    }

    // cannot start with a dot
    if (name[0] === '.') {
      throw new MessageError(reporter.lang('manifestNameDot'));
    }

    // cannot contain the following characters
    if (!isValidPackageName(name)) {
      throw new MessageError(reporter.lang('manifestNameIllegalChars'));
    }

    // cannot equal node_modules or favicon.ico
    const lower = name.toLowerCase();
    if (lower === 'node_modules' || lower === 'favicon.ico') {
      throw new MessageError(reporter.lang('manifestNameBlacklisted'));
    }
  }

  // validate license
  if (isRoot && !info.private) {
    if (typeof info.license === 'string') {
      const license = info.license.replace(/\*$/g, '');

View on GitHub (pinned to c2dda503f3)

Solutions

1. Rename the package so its name does not start with a dot ("."). Edit the name field in package.json.

Example fix

"name": ".my-package" -> "my-package"

When it happens

Trigger: A manifest name starts with a dot ('.') during normalization validation in src/util/normalize-manifest/validate.js.

Common situations: Occurs when package.json 'name' begins with '.', which npm registry rules forbid.

AI-assisted analysis of yarnpkg/yarn@c2dda503f3 (2026-08-13). Data as JSON: /api/errors/7f69aa0bce5a2c34. Report an issue: GitHub.