docs: clarify frozen lockfile flag migration by zkochan · Pull Request #924 · pnpm/pnpm.io

zkochan · 2026-09-10T07:15:13Z

Document that pnpm 12 rejects pnpm install --frozen-lockfile false and that users should replace it with pnpm install --no-frozen-lockfile. Add the migration note to the v12.0 release article and the linked differences guide, and remove the release article's claim that all v11 flags carry over.

Companion documentation for pnpm/pnpm#14765, addressing pnpm/pnpm#14741. The GitHub v12.0.0 release notes already contain the same guidance.

Validation: English Docusaurus production build passed.

Written by an agent (Codex, GPT-6).

Summary by CodeRabbit

Documentation
- Updated pnpm 12 documentation to reflect eight differences from pnpm 11.
- Documented that pnpm install --frozen-lockfile false is no longer supported.
- Clarified that --no-frozen-lockfile disables frozen-lockfile mode, while --frozen-lockfile enables it without a separate true argument.
- Updated migration guidance for replacing --resolution-only before switching to pnpm 12.

bolt-new-by-stackblitz · 2026-09-10T07:15:16Z

Run & review this pull request in StackBlitz Codeflow.

coderabbitai · 2026-09-10T07:15:30Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 42647af1-58e0-46d6-871f-2a6ffe8fff19

📥 Commits

Reviewing files that changed from the base of the PR and between 825de38 and 9fa5807.

📒 Files selected for processing (1)

blog/2026-08-10-whats-different-in-pnpm-12.md

🚧 Files skipped from review as they are similar to previous changes (1)

blog/2026-08-10-whats-different-in-pnpm-12.md

Included review availability: Your plan provides up to 2 included reviews per hour; 0 remain after this review.

📜 Recent review details

⏰ Context from checks skipped due to timeout. (2)

GitHub Check: Greptile Review
GitHub Check: Analyze (javascript-typescript)

📝 Walkthrough

Walkthrough

The pnpm 12 comparison and release posts now document eight differences from pnpm 11 and explain the supported alternatives to --frozen-lockfile false.

Changes

pnpm 12 documentation

Layer / File(s)	Summary
Frozen-lockfile syntax documentation `blog/2026-08-10-whats-different-in-pnpm-12.md`, `blog/releases/12.0.md`	The posts document that `pnpm install --frozen-lockfile false` is unsupported. They recommend `--no-frozen-lockfile` to disable the mode and `--frozen-lockfile` without `true` to enable it. The comparison post now reports eight differences and two rejected command-line syntaxes.
Release overview correction `blog/releases/12.0.md`	The release introduction no longer states that all pnpm 11 commands, flags, settings, and lockfile formats carry over to pnpm 12.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Merge Risk: ⚪ Minimal · up to 9fa58

The documentation update clarifies the unsupported frozen-lockfile syntax and directs users to the supported alternative, with no remaining merge-readiness risk identified.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main documentation change: it clarifies the migration from the rejected frozen-lockfile flag value to the supported syntax.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch docs/frozen-lockfile-migration

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{A rabbit reads the flags at night
Eight changes now are clear and bright
Frozen locks know which way to go
No false value trips the flow
pnpm twelve hops into sight}

_{Comment @coderabbitai help to get the list of available commands.}

qodo-code-review · 2026-09-10T07:15:43Z

PR Summary by Qodo

Clarify pnpm 12 frozen-lockfile flag migration

📝 Documentation 🕐 Less than 10 minutes

AI Description

• Documents pnpm 12's rejection of explicit --frozen-lockfile Boolean values.
• Directs users to supported positive and negated flag forms in both migration resources.
• Removes the inaccurate claim that every pnpm 11 flag carries over.

Diagram

graph TD
  A["pnpm 11 syntax"] --> B["Migration guidance"] --> C["Differences guide"] --> E["pnpm 12 users"]
  B --> D["Release article"] --> E

High-Level Assessment

The direct documentation approach is appropriate: both standalone migration resources should contain the complete flag replacement guidance. A shared documentation fragment would add maintenance complexity for one short note without improving clarity.

Files changed (2) +10 / -2

Documentation (2) +10 / -2

2026-08-10-whats-different-in-pnpm-12.mdAdd frozen-lockfile syntax to the pnpm 12 differences guide +5/-1

Add frozen-lockfile syntax to the pnpm 12 differences guide
• Updates the difference count to include two rejected command-line forms. Adds migration guidance replacing explicit frozen-lockfile Boolean values with the supported positive or negated flags.
blog/2026-08-10-whats-different-in-pnpm-12.md

12.0.mdDocument frozen-lockfile migration as a breaking change +5/-1

Document frozen-lockfile migration as a breaking change
• Removes the inaccurate statement that all pnpm 11 flags carry over. Adds the frozen-lockfile syntax migration to the pnpm 12 breaking changes.
blog/releases/12.0.md

greptile-apps · 2026-09-10T07:17:03Z

Confidence Score: 5/5

The documentation changes appear safe to merge, with no actionable issues remaining.

_{Reviews (2) · Last reviewed commit: "docs: keep migration notes before conclu..."}

docs: clarify frozen lockfile flag migration

825de38

zkochan deployed to deploy September 10, 2026 07:15 — with GitHub Actions Active

zkochan mentioned this pull request Sep 10, 2026

fix(cli): suggest negated frozen lockfile flag pnpm/pnpm#14765

Open

5 tasks

greptile-apps Bot reviewed Sep 10, 2026

View reviewed changes

Comment thread blog/2026-08-10-whats-different-in-pnpm-12.md Outdated

coderabbitai Bot approved these changes Sep 10, 2026

View reviewed changes

docs: keep migration notes before conclusion

9fa5807

zkochan deployed to deploy September 10, 2026 07:18 — with GitHub Actions Active

greptile-apps Bot approved these changes Sep 10, 2026

View reviewed changes

Navigation Menu

Uh oh!

docs: clarify frozen lockfile flag migration - #924

docs: clarify frozen lockfile flag migration#924
zkochan wants to merge 2 commits into
mainfrom
docs/frozen-lockfile-migration

zkochan commented Sep 10, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

bolt-new-by-stackblitz Bot commented Sep 10, 2026

Uh oh!

coderabbitai Bot commented Sep 10, 2026 •

edited

Loading

Walkthrough

Changes

Uh oh!

qodo-code-review Bot commented Sep 10, 2026

Uh oh!

greptile-apps Bot commented Sep 10, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

zkochan commented Sep 10, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

bolt-new-by-stackblitz Bot commented Sep 10, 2026

Uh oh!

coderabbitai Bot commented Sep 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Uh oh!

qodo-code-review Bot commented Sep 10, 2026

PR Summary by Qodo

Uh oh!

greptile-apps Bot commented Sep 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Confidence Score: 5/5

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

zkochan commented Sep 10, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Sep 10, 2026 •

edited

Loading

greptile-apps Bot commented Sep 10, 2026 •

edited

Loading