Title: [Feature]: Promote `devtools` to Stable — ship the browser-extension panel · Issue #146 · bQuery/bQuery · GitHub
Open Graph Title: [Feature]: Promote `devtools` to Stable — ship the browser-extension panel · Issue #146 · bQuery/bQuery
X Title: [Feature]: Promote `devtools` to Stable — ship the browser-extension panel · Issue #146 · bQuery/bQuery
Description: Pre-flight checklist I searched existing issues and did not find a duplicate request. I explained the problem or use case, not just the desired API. Problem or use case This is the single clearest deficit versus competitors. React DevToo...
Open Graph Description: Pre-flight checklist I searched existing issues and did not find a duplicate request. I explained the problem or use case, not just the desired API. Problem or use case This is the single clearest ...
X Description: Pre-flight checklist I searched existing issues and did not find a duplicate request. I explained the problem or use case, not just the desired API. Problem or use case This is the single clearest ...
Opengraph URL: https://github.com/bQuery/bQuery/issues/146
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Feature]: Promote `devtools` to Stable — ship the browser-extension panel","articleBody":"**Pre-flight checklist**\n- [x] I searched existing issues and did not find a duplicate request.\n- [x] I explained the problem or use case, not just the desired API.\n\n**Problem or use case**\nThis is the single clearest deficit versus competitors. React DevTools, Vue DevTools, and Svelte DevTools all ship mature **browser extensions** with a component tree and reactive-state inspection (Svelte DevTools+ advertises time-travel; Vue DevTools provides a timeline). bQuery's `devtools` module (Beta) offers only runtime inspection helpers — timeline, diffs, traces, snapshots, perf helpers — plus an `installBrowserBridge()` that the docs describe as \"for future extension panels.\" In other words **there is no actual extension yet**, only a bridge stub. Without it, debugging bQuery apps is materially worse than the alternatives, and `devtools` cannot credibly be called stable.\n\n**Proposed solution**\nBuild the browser extension that `installBrowserBridge()` only stubs today: a panel showing the component (Web Component) tree, live signal/store inspection (reading the existing `window.__BQUERY_DEVTOOLS__` store hook), and timeline/time-travel debugging built on the module's existing snapshot/diff/trace primitives. Stabilize the bridge protocol as the public contract between app and extension, then freeze the `devtools` API. Exit criteria: shipped extension (at least Chromium; Firefox ideally), stabilized bridge protocol, component-tree + state inspection + timeline, docs.\n\n**Possible API or UX shape**\n```ts\nimport { installBrowserBridge } from \"@bquery/bquery/devtools\";\n\ninstallBrowserBridge(); // stabilized protocol; the extension connects to this\n// Extension panel: component tree • signal/store values • timeline + time-travel\n// (consumes existing snapshot/diff/trace + window.__BQUERY_DEVTOOLS__)\n```\n\n**Alternatives considered**\nShipping only the in-page runtime helpers and documenting console-based inspection — far below the bar set by React/Vue/Svelte DevTools and a real adoption deterrent. A standalone Electron inspector instead of a browser extension — worse DX than an in-browser panel and not where developers expect framework devtools to live.\n\n**Relevant area**\n`devtools`\n\n**Additional context**\nThe snapshot/diff/trace primitives and the store devtools hook (`window.__BQUERY_DEVTOOLS__`) already exist, so much of the data layer is in place — the missing piece is the extension UI and a frozen bridge protocol. Wire in hydration-mismatch (#130) and a11y-audit (#142) surfaces so they're inspectable too. This is the highest-visibility single ticket in the set.\n","author":{"url":"https://github.com/JosunLP","@type":"Person","name":"JosunLP"},"datePublished":"2026-06-26T21:25:50.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/146/bQuery/issues/146"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:ee6f7736-ef80-da8a-91f2-296e4ff4171d |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | BB20:1F1613:F98862:166C403:6A4E5413 |
| html-safe-nonce | e95e7eac3cb114b069efb5a617ed8c0b3fbb16f8875f85907559ee9271c4f321 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCQjIwOjFGMTYxMzpGOTg4NjI6MTY2QzQwMzo2QTRFNTQxMyIsInZpc2l0b3JfaWQiOiI2Njc5MjExMTA4MTY5ODMxNDQzIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 9d87c41ef1ae1c3400f50f14d92300cf12d4643035d3cc7945d7f90a4f6a8b56 |
| hovercard-subject-tag | issue:4755239932 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/bQuery/bQuery/146/issue_layout |
| twitter:image | https://opengraph.githubassets.com/e5c3c634de781ac25511f1c017df7ad5a294e46617356d34d22d35ed24d6c07c/bQuery/bQuery/issues/146 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/e5c3c634de781ac25511f1c017df7ad5a294e46617356d34d22d35ed24d6c07c/bQuery/bQuery/issues/146 |
| og:image:alt | Pre-flight checklist I searched existing issues and did not find a duplicate request. I explained the problem or use case, not just the desired API. Problem or use case This is the single clearest ... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | JosunLP |
| hostname | github.com |
| expected-hostname | github.com |
| None | 030096ee0db095447bfe77409d33bfac127ca7128299c58deef27c52eaa1b1f0 |
| turbo-cache-control | no-preview |
| go-import | github.com/bQuery/bQuery git https://github.com/bQuery/bQuery.git |
| octolytics-dimension-user_id | 256381806 |
| octolytics-dimension-user_login | bQuery |
| octolytics-dimension-repository_id | 1139284244 |
| octolytics-dimension-repository_nwo | bQuery/bQuery |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1139284244 |
| octolytics-dimension-repository_network_root_nwo | bQuery/bQuery |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | f344f1eab54fc7dfc02d0d018cda7e158c3db65c |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width