Skip to content

docs: install the framework adapters as dev dependencies everywhere - #547

Open
AlemTuzlak wants to merge 1 commit into
mainfrom
docs/227-install-dev-dependency
Open

AlemTuzlak wants to merge 1 commit into
mainfrom
docs/227-install-dev-dependency

Conversation

@AlemTuzlak

Copy link
Copy Markdown
Collaborator

The docs disagree on how to install the devtools: some pages use npm install -D, and others use a regular install. This PR makes every framework adapter install use -D. The installation page now says in one line when to use a regular dependency instead.

🎯 Changes

  • installation.md and most of quick-start.md already used -D.
  • The adapter pages, the basic setup pages (React, Preact, Solid, Vue, Svelte, Angular), and the Svelte and Angular quick start used a regular install. They now use -D.
  • installation.md now says to install as a dev dependency, with a link to its Production Builds section.
  • The @tanstack/devtools-event-client and @tanstack/devtools-utils installs stay regular, because library and plugin code use them at runtime.

✅ Checklist

  • I have followed the steps in the Contributing guide.
  • I have tested code changes locally with pnpm test:pr, or these tests do not apply to this pull request.
  • I fully understand the code in this pull request, including any code generated with AI assistance.

🚀 Release Impact

  • This change affects published code, and I have generated a changeset.
  • This change is docs/CI/dev-only (no release).

Testing

Commands run

  • prettier --check on the changed docs: pass.
  • grep for adapter install lines without -D in docs/: none left.

Manual test

  1. Open the three pages from Install as dev dependency or regular dependency? #227: Installation, Quick Start, and the React adapter.
  2. Make sure that all three use npm install -D @tanstack/react-devtools.

How this PR makes testing easy

Docs only.

Linked issues

Fixes #227

Risk / rollback

None. Docs only. To undo, revert this PR.

🤖 Generated with Claude Code

The installation page and most of the quick start used `npm install -D`,
but the adapter pages, the basic setup pages, and the Svelte and Angular
quick start used a regular install. Every adapter install now uses -D, and
the installation page says when to use a regular dependency instead.

Fixes #227
@coderabbitai

coderabbitai Bot commented Oct 2, 2026

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 1 minute.

Check out review usage here.

View limit details

Limit details: You’ve used all 4 included reviews currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Repository: TanStack/devtools/.coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 0f6e2a62-5e53-4c55-bb4b-16f9b96feeb5

📥 Commits

Reviewing files that changed from the base of the PR and between afa01fe and 17638c2.

📒 Files selected for processing (14)
  • docs/framework/angular/adapter.md
  • docs/framework/angular/basic-setup.md
  • docs/framework/preact/adapter.md
  • docs/framework/preact/basic-setup.md
  • docs/framework/react/adapter.md
  • docs/framework/react/basic-setup.md
  • docs/framework/solid/adapter.md
  • docs/framework/solid/basic-setup.md
  • docs/framework/svelte/adapter.md
  • docs/framework/svelte/basic-setup.md
  • docs/framework/vue/adapter.md
  • docs/framework/vue/basic-setup.md
  • docs/installation.md
  • docs/quick-start.md
  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.


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

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

@nx-cloud

nx-cloud Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit 17638c2

Command Status Duration Result
nx run-many --target=test:e2e --parallel=1 --pr... ✅ Succeeded 1m 15s View ↗
nx affected --targets=test:eslint,test:sherif,t... ✅ Succeeded 6s View ↗
nx run-many --targets=build --exclude=examples/... ✅ Succeeded 2s View ↗

☁️ Nx Cloud last updated this comment at 2026-10-02 14:03:12 UTC

@nx-cloud

nx-cloud Bot commented Oct 2, 2026

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit 17638c2

Command Status Duration Result
nx run-many --targets=build --exclude=examples/... ✅ Succeeded 2s View ↗

☁️ Nx Cloud last updated this comment at 2026-10-02 14:01:27 UTC

@pkg-pr-new

pkg-pr-new Bot commented Oct 2, 2026

Copy link
Copy Markdown
More templates

@tanstack/angular-devtools

npm i https://pkg.pr.new/@tanstack/angular-devtools@547

@tanstack/devtools

npm i https://pkg.pr.new/@tanstack/devtools@547

@tanstack/devtools-a11y

npm i https://pkg.pr.new/@tanstack/devtools-a11y@547

@tanstack/devtools-bundler-core

npm i https://pkg.pr.new/@tanstack/devtools-bundler-core@547

@tanstack/devtools-client

npm i https://pkg.pr.new/@tanstack/devtools-client@547

@tanstack/devtools-rspack

npm i https://pkg.pr.new/@tanstack/devtools-rspack@547

@tanstack/devtools-ui

npm i https://pkg.pr.new/@tanstack/devtools-ui@547

@tanstack/devtools-utils

npm i https://pkg.pr.new/@tanstack/devtools-utils@547

@tanstack/devtools-vite

npm i https://pkg.pr.new/@tanstack/devtools-vite@547

@tanstack/devtools-webmcp

npm i https://pkg.pr.new/@tanstack/devtools-webmcp@547

@tanstack/devtools-event-bus

npm i https://pkg.pr.new/@tanstack/devtools-event-bus@547

@tanstack/devtools-event-client

npm i https://pkg.pr.new/@tanstack/devtools-event-client@547

@tanstack/preact-devtools

npm i https://pkg.pr.new/@tanstack/preact-devtools@547

@tanstack/react-devtools

npm i https://pkg.pr.new/@tanstack/react-devtools@547

@tanstack/solid-devtools

npm i https://pkg.pr.new/@tanstack/solid-devtools@547

@tanstack/svelte-devtools

npm i https://pkg.pr.new/@tanstack/svelte-devtools@547

@tanstack/vue-devtools

npm i https://pkg.pr.new/@tanstack/vue-devtools@547

commit: 17638c2

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Install as dev dependency or regular dependency?

1 participant