René's URL Explorer Experiment


Title: Proposal: inline dock mode for persistent side-panel workflows · Issue #287 · devframes/devframe · GitHub

Open Graph Title: Proposal: inline dock mode for persistent side-panel workflows · Issue #287 · devframes/devframe

X Title: Proposal: inline dock mode for persistent side-panel workflows · Issue #287 · devframes/devframe

Description: Context The current embedded dock works well when a developer opens a tool briefly and then returns to the application. Float and edge modes both sit over the page, though, which is less comfortable when the DevTools panel is part of the...

Open Graph Description: Context The current embedded dock works well when a developer opens a tool briefly and then returns to the application. Float and edge modes both sit over the page, though, which is less comfortabl...

X Description: Context The current embedded dock works well when a developer opens a tool briefly and then returns to the application. Float and edge modes both sit over the page, though, which is less comfortabl...

Opengraph URL: https://github.com/devframes/devframe/issues/287

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Proposal: inline dock mode for persistent side-panel workflows","articleBody":"## Context\n\nThe current embedded dock works well when a developer opens a tool briefly and then returns to the application. Float and edge modes both sit over the page, though, which is less comfortable when the DevTools panel is part of the workflow rather than an occasional interruption.\n\nOne example is a developer working with a persistent reference or feedback panel:\n\n- Keep API responses, schema documentation, component props, accessibility results, or other reference data open beside the application.\n- Interact with the application while watching that panel update.\n- Edit the source and let HMR update both the application and the DevTools view.\n- Compare the live result against the reference data without repeatedly reopening or moving an overlay.\n\nThis is similar to working with browser DevTools docked to the side. The application gets a smaller layout area, but the panel no longer covers the thing being inspected. Clicking around the page also does not dismiss it.\n\nI would like to explore whether `@devframes/hub-ui` should support this as a third dock mode:\n\n```ts\ntype DockMode = 'float' | 'edge' | 'inline'\n```\n\n## Proposal\n\nThe host would opt in by providing a mount target as part of its own layout:\n\n```html\n\u003cmain id=\"app\">\u003c/main>\n\u003caside id=\"devframes-root\">\u003c/aside>\n```\n\n```ts\ncreateUi({\n  dockPreferences: {\n    defaultMode: 'inline',\n  },\n})\n```\n\n`createUi()` could default the selector to `#devframes-root`, with an optional `inlineTarget` override.\n\nA viewer adapter could provide a more natural default for its own users. For example, Vite DevTools could default to `#devtools-root` and expose the same override through `DevTools()`:\n\n```ts\nDevTools({\n  inlineTarget: '#custom-devtools-root',\n  dockPreferences: {\n    defaultMode: 'inline',\n  },\n})\n```\n\nProviding a target would make Inline available. It would not select the mode automatically, and `defaultMode` would remain a first-use seed rather than overriding an existing browser preference.\n\nThe host would own the surrounding grid or flex layout. DevTools would only publish state on the target:\n\n```html\n\u003caside\n  data-devframes-state=\"open\"\n  data-devframes-position=\"right\"\n/>\n```\n\nThe proposed states are:\n\n- `open`: a panel is selected.\n- `collapsed`: the full dock rail remains visible, with no panel selected.\n- `inactive`: DevTools is floating, edge-mounted, hidden, unauthorized, or open in a popup.\n\nFor resizing, DevTools could reuse its existing persisted width and height and expose them as CSS custom properties:\n\n```css\n--devframes-inline-width: 42vw;\n--devframes-inline-height: 38vh;\n--devframes-inline-rail-size: 40px;\n```\n\nThe host decides how to consume or clamp those values. DevTools would not change body padding, application dimensions, or host layout styles directly.\n\n## Expected behavior\n\nInline would remain user-switchable alongside Float and Edge.\n\nWhen active:\n\n- A fresh tab starts with the complete dock rail and no selected panel.\n- Selecting a dock opens its panel.\n- Selecting the active dock again collapses back to the rail.\n- Escape, Close Panel, and the other existing explicit close actions also collapse it.\n- Clicking elsewhere on the application does not close it.\n- Idle timeout and edge-toolbar auto-collapse do not apply.\n- Mode and geometry keep using the existing local-storage state.\n- Open panel, selected dock, and route keep using the existing per-tab session state.\n- Left, right, top, and bottom positions remain available. DevTools orients its rail and panel, then publishes the position for host CSS to arrange the page.\n\nHide DevTools and popup mode would make the target inactive rather than leaving the rail behind.\n\n## Target resolution and fallback\n\nThe configured selector should resolve to exactly one element.\n\nIt would be useful for the resolver to search the document and reachable open shadow roots, since application shells are often web components. Closed shadow roots and iframe documents would remain outside the selector contract.\n\nFramework rendering and HMR can add or replace the target after the bootstrap starts. A small observer could retry while the target is missing and detect removal of the active target, without continuously rescanning the page once the target is stable.\n\nIf Inline is selected but no unique target can be found:\n\n- Log one browser-side configuration error.\n- Temporarily render Edge mode.\n- Keep the saved preference as Inline.\n- Hide Inline from mode controls while it is unavailable.\n- Restore it if the target appears later.\n\n## Possible implementation direction\n\nI do not think moving the complete existing custom element into the target is safe.\n\nThe embedded element also owns command palettes, confirmations, toasts, menus, and tooltips. A host target may create a containing or stacking context through `transform`, `contain`, `overflow`, or z-index. That could trap global overlays, which is related to the positioning problem previously discussed in [#205](https://github.com/devframes/devframe/issues/205).\n\nA safer shape would use two custom elements backed by one RPC connection and dock context:\n\n```text\ndocument.body\n└── embedded controller\n    ├── float/edge shell when applicable\n    └── command palette, dialogs, toasts, menus, tooltips\n\ninline target\n└── inline rail and selected panel\n```\n\nThe inline shell could adapt the existing edge shell rather than introduce a second dock implementation. It would reuse the current entries, views, position controls, resizer, geometry, and persistence, with small branches for target-relative layout and manual collapse behavior.\n\nThe Vite adapter would only need to forward `inlineTarget` and supply its `#devtools-root` default. The actual behavior would stay framework-neutral in hub-ui.\n\n## Why I am opening an issue first\n\nThis looks useful, but it is larger than adding another mode branch.\n\nThe main challenges seem to be:\n\n- Keeping one RPC/client context while rendering the shell and global overlays in different roots.\n- Avoiding duplicate or short-lived iframe/view ownership during mode changes.\n- Handling targets inside open shadow roots and targets replaced by framework rendering.\n- Defining a host CSS contract that works for four positions and drag resizing.\n- Adding a public mode union member that downstream exhaustive switches may need to handle.\n\nMy rough estimate is a medium-sized feature: perhaps 350–600 lines of production code across devframe and the Vite forwarding layer, followed by a similar or larger amount of tests, fixture code, and documentation.\n\n## Questions for maintainers\n\nThe main question is whether this workflow feels common and useful enough to justify supporting it in `@devframes/hub-ui`.\n\nDoes Inline belong in the reference UI, or would you prefer hosts with this requirement to build a custom viewer against `@devframes/hub/client`?\n\nIf it belongs here:\n\n- Does the target-selector API seem like the right boundary?\n- Is supporting all four positions and the existing resizer worthwhile in the first version?\n- Is open-shadow-root lookup appropriate, or should the first version require a light-DOM target?\n- Would you prefer a smaller first pass before committing to the complete host layout contract?\n\nI would be happy to work on an implementation if this direction feels worthwhile, but I would rather confirm that it fits the project before adding another supported presentation mode.\n","author":{"url":"https://github.com/dvcolomban","@type":"Person","name":"dvcolomban"},"datePublished":"2026-08-24T15:32:50Z","url":"https://github.com/devframes/devframe/issues/287"}

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react-reconciler,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@d5750093facf
route-pattern/_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format)
route-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:469a1a20-4e61-45fd-8f1e-5a18f6b13e6c
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idDE5E:34DD79:6B4756:97DECC:6AFB67AD
html-safe-nonceb4d2e7399c2120eb102ba4ccf817b89fe1f894b582bb95e5eb3abfe796bef160
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJERTVFOjM0REQ3OTo2QjQ3NTY6OTdERUNDOjZBRkI2N0FEIiwidmlzaXRvcl9pZCI6IjM1MzQyNDMxMzcwMDM5Mzk3NTciLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmaca281724879a35360895a9cad30aa007fa888d76501d67baa8018e2ac8248c809
hovercard-subject-tagissue:5236580120
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/devframes/devframe/287/issue_layout
twitter:imagehttps://opengraph.githubassets.com/18d3496bfd79db4c5067890686d7f5a6a4290cd80addcac8e0ae2a928a7c1f00/devframes/devframe/issues/287
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/18d3496bfd79db4c5067890686d7f5a6a4290cd80addcac8e0ae2a928a7c1f00/devframes/devframe/issues/287
og:image:altContext The current embedded dock works well when a developer opens a tool briefly and then returns to the application. Float and edge modes both sit over the page, though, which is less comfortabl...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamedvcolomban
hostnamegithub.com
expected-hostnamegithub.com
Noneea33d13c96d0ff66bd8fa906b193d2213536b78cb06b0c50a4632c58b1418f94
turbo-cache-controlno-preview
go-importgithub.com/devframes/devframe git https://github.com/devframes/devframe.git
octolytics-dimension-user_id279879373
octolytics-dimension-user_logindevframes
octolytics-dimension-repository_id1231722386
octolytics-dimension-repository_nwodevframes/devframe
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id1231722386
octolytics-dimension-repository_network_root_nwodevframes/devframe
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release59ef97164c52cf59bd10558ddec9c4f482763988
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/devframes/devframe/issues/287#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fdevframes%2Fdevframe%2Fissues%2F287
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fdevframes%2Fdevframe%2Fissues%2F287
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=devframes%2Fdevframe
Reloadhttps://github.com/devframes/devframe/issues/287
Reloadhttps://github.com/devframes/devframe/issues/287
Reloadhttps://github.com/devframes/devframe/issues/287
devframeshttps://github.com/devframes
devframehttps://github.com/devframes/devframe
Codehttps://github.com/devframes/devframe
Issues12 (12)https://github.com/devframes/devframe/issues
Pull requests13 (13)https://github.com/devframes/devframe/pulls
Actionshttps://github.com/devframes/devframe/actions
Security and qualityhttps://github.com/devframes/devframe/security
Insightshttps://github.com/devframes/devframe/pulse
https://github.com/devframes/devframe
New issuehttps://github.com/login?return_to=https://github.com/devframes/devframe/issues/287
New issuehttps://github.com/login?return_to=https://github.com/devframes/devframe/issues/287
Proposal: inline dock mode for persistent side-panel workflowshttps://github.com/devframes/devframe/issues/287#top
https://github.com/dvcolomban
dvcolombanhttps://github.com/dvcolomban
on Aug 24, 2026https://github.com/devframes/devframe/issues/287#issue-5236580120
#205https://github.com/devframes/devframe/issues/205
Sign up for freehttps://github.com/signup?return_to=https://github.com/devframes/devframe/issues/287
Sign in to commenthttps://github.com/login?return_to=https://github.com/devframes/devframe/issues/287
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.