[Bug]: Docs dlx create-react-app fails with deprecation warning and error EROFS

[MikeMcC399]

Self-service

• I'd be willing to implement a fix

Describe the bug

• follows on from [Bug]: Workflow E2E CRA fails with deprecation warning and error EROFS #6691

The https://yarnpkg.com/cli/dlx#examples instructions fail:

Use create-react-app to create a new React app :

yarn dlx create-react-app ./my-app

create-react-app is deprecated.

You can find a list of up-to-date React frameworks on react.dev
For more info see:https://react.dev/link/cra

This error message will only be shown once per install.
/tmp/xfs-9dbf8d91/dlx-1983/.pnp.cjs:5738
      throw EROFS(`open '${p}'`);

To reproduce

See above

Environment

System:
    OS: Linux 6.11 Ubuntu 24.04.2 LTS 24.04.2 LTS (Noble Numbat)
    CPU: (2) x64 11th Gen Intel(R) Core(TM) i5-11400F @ 2.60GHz
  Binaries:
    Node: 22.14.0 - /tmp/xfs-73466da1/node
    Yarn: 1.22.22 - /tmp/xfs-73466da1/yarn
    npm: 10.9.2 - ~/n/bin/npm
    pnpm: 10.4.1 - ~/n/bin/pnpm

Additional context

• See Sunsetting Create React App Feb 14, 2025

• Removes CRA from the E2E tests #6692 already removed CRA from CI tests

• I don't know what the best substitute in this example would be, which is why I didn't offer to submit a PR

[clemyan]

I don't know what the best substitute in this example would be

Probably create-vite?

[MikeMcC399]

@clemyan

I don't know what the best substitute in this example would be

Probably create-vite?

I'm not sure about using create-vite as a dlx example since the create-vite repo recommends running:

yarn create vite

or with a template example:

yarn create vite my-vue-app --template vue

[clemyan]

Yes, yarn dlx create-vite and yarn create vite are equivalent

Or are you looking for something like create-next-app where the official installation guide does not specify a yarn command?

[MikeMcC399]

@clemyan

Corepack bug nodejs/corepack#202 from Oct 2022 means that:

yarn dlx create-vite and yarn create vite aren't exactly equivalent

yarn dlx uses the hard-coded Yarn version. For corepack@0.32.0 this is yarn@4.6.0
yarn create vite will use yarn@1.22.22 by default, unless Corepack's lastKnownGood.json has a stored value for yarn. For instance corepack install -g yarn@stable would currently cause yarn@4.9.1 to be used.

That being said, changing the example in https://yarnpkg.com/cli/dlx#examples

from

yarn dlx create-react-app ./my-app

to

yarn dlx create-vite

would still be an improvement. It may not be the best example, however I don't have a better suggestion at this time.

[MikeMcC399]

A workaround is to specify the Yarn version explicitly, for instance:

corepack yarn@stable dlx create-vite

Considering that the Corepack bug has been open such a long time and there doesn't seem to be any action to remediate it, perhaps the workaround needs to be documented for Yarn?

[MikeMcC399]

@clemyan

I've taken your advice and submitted PR #6792