[🐞] [v1->v2] builder dependencies need overriding
Open
@dmitry-stepanenko is already working on this.
Since Aug 10, 2025.
bug
DX
V2
- Dominant language
- TypeScript
- Stars
- 22.1k
- Forks
- 1.4k
- Avg merge
- 1d 10h
- Merged PRs (30d)
- 52
Description
Which component is affected?
Qwik Runtime
Describe the bug
When migrating from v1 to v2, qwik libraries will still want the @builder.io dependencies.
This isn't a problem for the build, because the optimizer replaces those imports with @qwik.dev. However, typescript won't have types because it's looking in the wrong place.
Steps to reproduce
- take a v1 project with a qwik lib dependency like e.g. @auth/qwik
- run
npx qwik migrate-v2 - the types for @auth/qwik will be
any
To fix direct dependencies of dependencies: add overrides
"overrides": {
"@builder.io/qwik": "npm:@qwik.dev/core",
"@builder.io/qwik-city": "npm:@qwik.dev/router",
"@builder.io/qwik-react": "npm:@qwik.dev/react",
"@builder.io/eslint-plugin-qwik": "npm:@qwik.dev/eslint-plugin-qwik",
},
To fix peer dependencies: add aliased dependencies so that they are used as peers when needed
in package.json:
"devDependencies": {
"@builder.io/qwik": "npm:@qwik.dev/core",
"@builder.io/qwik-city": "npm:@qwik.dev/router",
},
Other packages could be added too but they don't normally get used as peer dependencies and they would get installed.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.