Does storybook 10.2 work on yarn pnp?

[hongwonlim]

Summary

Recently I migrate to yarn berry pnp
but when I command yarn run storybook still doesn't work

I think storybook 10.2 doesn't work on yarn pnp is it right?

Additional information

No response

Create a reproduction

No response

[dosubot[bot]]

Hi @hongwonlim! I'm Dosu and I’m helping the storybook team.

Storybook does officially support Yarn PnP, but there are some known issues with Storybook 10.x and Yarn PnP.

The most common problem is a missing React peer dependency that causes errors like:

Error: storybook tried to access react, but it isn't declared in its dependencies

Workaround: Add this to your .yarnrc.yml:

packageExtensions:
  storybook@10.0.2:
    peerDependencies:
      react: '^19.0.0'

(Adjust the version numbers to match your setup)

Additionally, note that PnP support is being deprecated and will be removed in Storybook 11 due to low adoption.

Could you share the specific error message you're seeing when running yarn run storybook? That would help narrow down whether this is the React peer dependency issue or something else.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[gebt2000]

Short answer: yes, Storybook can work with Yarn PnP, but PnP requires stricter dependency resolution and some addons/framework combos still need tweaks.

Try this checklist:

1. Ensure all @storybook/* packages are on the same version.
2. Run yarn dlx @yarnpkg/doctor to catch missing peer deps.
3. If a package can't be resolved under PnP, add a packageExtensions entry in .yarnrc.yml for the missing peer.
4. Clear Storybook cache and rerun.
5. If you're blocked, temporarily use nodeLinker: node-modules to confirm it's a PnP resolution issue, then revert and patch peers.

If you share the exact error line from yarn storybook, I can suggest the minimal packageExtensions snippet.