QwikDev / QwikDev/qwik

[🐞] [v1->v2] builder dependencies need overriding

Open
#7,803 2 comments 2 reactions 1 assignee View on GitHub

@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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.