René's URL Explorer Experiment


Title: fix(devframe): let a devframe at base `/` fall through to the host app by zerone0x · Pull Request #478 · devframes/devframe · GitHub

Open Graph Title: fix(devframe): let a devframe at base `/` fall through to the host app by zerone0x · Pull Request #478 · devframes/devframe

X Title: fix(devframe): let a devframe at base `/` fall through to the host app by zerone0x · Pull Request #478 · devframes/devframe

Description: Fixes #456 Problem Step 3 of the tutorial mounts devframeViteBridge(def, { base: '/', auth: false }). Opening the Vite URL returns: {"status":404,"message":"Cannot find any route matching [GET] http://localhost:5174/"} I could reproduce this on main with the tutorial files copied as written. There were two causes: The bridge took over every path. The bridge's nodeMiddleware runs before Vite's own middlewares. At base /, every request is inside the base, so h3 answered /, /main.tsx and every other path with its 404. next() was never called, so Vite never served the page. Setting a correct root alone does not fix this. The tutorial config had no root. npx vite --config app/vite.config.ts uses the current folder as the Vite root. That folder has no index.html; the file is in app/. The config's build.outDir: '../dist/client' and Step 4's clientAssets path both expect the root to be app/. Fix createInstanceShell (used by nodeMiddleware): when the base is /, a request that no devframe route answers now goes to the host's next() instead of h3's 404. A devframe at / shares the origin root with its host app, so it cannot own every path. This is done by one middleware at the end of the chain. It uses h3's fromNodeHandler and waits until the host stack has sent its response. Bases like /__/ do not change: inside its own base the devframe still owns the namespace. Existing tests check this, for example the reserved embedded.js 404 and the unmounted __sse 404. The web handler does not change either. Tutorial: add root: fileURLToPath(new URL('.', import.meta.url)) to app/vite.config.ts, the same way examples/files-inspector does it. Update the nodeMiddleware JSDoc to describe the base / case. Test plan New test in packages/devframe/src/adapters/__tests__/initiate.test.ts: at base /, nodeMiddleware sends /, /main.tsx and /nested/page?x=1 to the host's next(). __connection.json still answers, and handler still returns 404 for a miss. This test fails without the fix. New test in packages/vite/test/single.test.ts: devframeViteBridge at base / leaves pages to the middleware registered after it. Manual check with the tutorial project (Steps 1 to 3, React, Vite 8.3.5) and the local builds. npx vite --config app/vite.config.ts now serves / and /main.tsx with 200. __connection.json answers, and over /__ws, data-inspector:get-meta and data-inspector:query('users.0.name') return the expected values. npx vite build --config app/vite.config.ts writes dist/client/. pnpm lint, pnpm knip, pnpm typecheck, pnpm build, vitest run (160 files, 1829 passed) and pnpm docs:build all pass.

Open Graph Description: Fixes #456 Problem Step 3 of the tutorial mounts devframeViteBridge(def, { base: '/', auth: false }). Opening the Vite URL returns: {"status":404,"message":"Cannot ...

X Description: Fixes #456 Problem Step 3 of the tutorial mounts devframeViteBridge(def, { base: '/', auth: false }). Opening the Vite URL returns: {"status":404,"message...

Opengraph URL: https://github.com/devframes/devframe/pull/478

X: @github

direct link

Domain: github.com

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/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:21f9b025-b35b-6d41-a246-8dc467f53e3d
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idA282:16FEFE:952A44:D1F49E:6AFB72EC
html-safe-nonce955a3b7dc5418289a661b7baf4c45b5f86a6cf1654959eef359b713955815d4e
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBMjgyOjE2RkVGRTo5NTJBNDQ6RDFGNDlFOjZBRkI3MkVDIiwidmlzaXRvcl9pZCI6IjQ1NzkzNjAyMzIzMzY3NDkyOTIiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmacc4f77b27b7fc649ea287e1454f89cfc0f2d9691a51f375d6b1e0538bb53ad8ef
hovercard-subject-tagpull_request:5109288756
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/devframes/devframe/pull/478/files
twitter:imagehttps://avatars.githubusercontent.com/u/39543393?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/39543393?s=400&v=4
og:image:altFixes #456 Problem Step 3 of the tutorial mounts devframeViteBridge(def, { base: '/', auth: false }). Opening the Vite URL returns: {"status":404,"message":"Cannot ...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None0e29e7974fdda2feeaf5c891efd4b23b0734b23480232b62c7bdef13f40b5b48
turbo-cache-controlno-preview
diff-viewunified
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 full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release2e8872b770cc4d5d0cc1f2026afab747a268e2ce
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/devframes/devframe/pull/478/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fdevframes%2Fdevframe%2Fpull%2F478%2Ffiles
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%2Fpull%2F478%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=devframes%2Fdevframe
Reloadhttps://github.com/devframes/devframe/pull/478/files
Reloadhttps://github.com/devframes/devframe/pull/478/files
Reloadhttps://github.com/devframes/devframe/pull/478/files
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
Sign up for GitHub https://github.com/signup?return_to=%2Fdevframes%2Fdevframe%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fdevframes%2Fdevframe%2Fissues%2Fnew%2Fchoose
antfuhttps://github.com/antfu
devframes:mainhttps://github.com/devframes/devframe/tree/main
zerone0x:fix/issue-456-bridge-root-fallthroughhttps://github.com/zerone0x/devframe/tree/fix/issue-456-bridge-root-fallthrough
Conversation 2 https://github.com/devframes/devframe/pull/478
Commits 1 https://github.com/devframes/devframe/pull/478/commits
Checks 12 https://github.com/devframes/devframe/pull/478/checks
Files changed 5 https://github.com/devframes/devframe/pull/478/files
fix(devframe): let a devframe at base / fall through to the host app https://github.com/devframes/devframe/pull/478/files#top
Show all changes 1 commit https://github.com/devframes/devframe/pull/478/files
463f7d7 fix(devframe): let a devframe at base `/` fall through to the host app zerone0x Nov 1, 2026 https://github.com/devframes/devframe/pull/478/commits/463f7d765d2bb5d1d2429faebc73f0c4ce7c9238
Clear filters https://github.com/devframes/devframe/pull/478/files
Please reload this pagehttps://github.com/devframes/devframe/pull/478/files
Please reload this pagehttps://github.com/devframes/devframe/pull/478/files
1.tutorial-server-data-inspector.md https://github.com/devframes/devframe/pull/478/files#diff-c746d9f6aa8a1ac9236ba69fbfb0b7b09b18c5760e283520d0060ff86f623ae5
initiate.test.ts https://github.com/devframes/devframe/pull/478/files#diff-6bcd391afe0ce4686676a750685773009e25bceb8f6c48339faef1a778e46ee1
initiate.ts https://github.com/devframes/devframe/pull/478/files#diff-a9bcfb29d9c365ee0dd03456bdef86e93a812ea81bdada66f197d5e0d7631975
instance-shell.ts https://github.com/devframes/devframe/pull/478/files#diff-b7201157bb4da195993e2a8481f0dba03458a7e876da250e0d7e18fc3946371e
single.test.ts https://github.com/devframes/devframe/pull/478/files#diff-b7d4c93babea1e6c25634d871bb072cd9e363c90023cf1ca9d7d6871cbca92cb
docs/content/1.guide/1.tutorial-server-data-inspector.mdhttps://github.com/devframes/devframe/pull/478/files#diff-c746d9f6aa8a1ac9236ba69fbfb0b7b09b18c5760e283520d0060ff86f623ae5
View file https://github.com/zerone0x/devframe/blob/463f7d765d2bb5d1d2429faebc73f0c4ce7c9238/docs/content/1.guide/1.tutorial-server-data-inspector.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/478/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/478/files#diff-c746d9f6aa8a1ac9236ba69fbfb0b7b09b18c5760e283520d0060ff86f623ae5
https://github.com/devframes/devframe/pull/478/files#diff-c746d9f6aa8a1ac9236ba69fbfb0b7b09b18c5760e283520d0060ff86f623ae5
packages/devframe/src/adapters/__tests__/initiate.test.tshttps://github.com/devframes/devframe/pull/478/files#diff-6bcd391afe0ce4686676a750685773009e25bceb8f6c48339faef1a778e46ee1
View file https://github.com/zerone0x/devframe/blob/463f7d765d2bb5d1d2429faebc73f0c4ce7c9238/packages/devframe/src/adapters/__tests__/initiate.test.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/478/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/478/files#diff-6bcd391afe0ce4686676a750685773009e25bceb8f6c48339faef1a778e46ee1
https://github.com/devframes/devframe/pull/478/files#diff-6bcd391afe0ce4686676a750685773009e25bceb8f6c48339faef1a778e46ee1
packages/devframe/src/adapters/initiate.tshttps://github.com/devframes/devframe/pull/478/files#diff-a9bcfb29d9c365ee0dd03456bdef86e93a812ea81bdada66f197d5e0d7631975
View file https://github.com/zerone0x/devframe/blob/463f7d765d2bb5d1d2429faebc73f0c4ce7c9238/packages/devframe/src/adapters/initiate.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/478/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/478/files#diff-a9bcfb29d9c365ee0dd03456bdef86e93a812ea81bdada66f197d5e0d7631975
https://github.com/devframes/devframe/pull/478/files#diff-a9bcfb29d9c365ee0dd03456bdef86e93a812ea81bdada66f197d5e0d7631975
packages/devframe/src/node/instance-shell.tshttps://github.com/devframes/devframe/pull/478/files#diff-b7201157bb4da195993e2a8481f0dba03458a7e876da250e0d7e18fc3946371e
View file https://github.com/zerone0x/devframe/blob/463f7d765d2bb5d1d2429faebc73f0c4ce7c9238/packages/devframe/src/node/instance-shell.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/478/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/478/files#diff-b7201157bb4da195993e2a8481f0dba03458a7e876da250e0d7e18fc3946371e
https://github.com/devframes/devframe/pull/478/files#diff-b7201157bb4da195993e2a8481f0dba03458a7e876da250e0d7e18fc3946371e
https://github.com/devframes/devframe/pull/478/files#diff-b7201157bb4da195993e2a8481f0dba03458a7e876da250e0d7e18fc3946371e
https://github.com/devframes/devframe/pull/478/files#diff-b7201157bb4da195993e2a8481f0dba03458a7e876da250e0d7e18fc3946371e
https://github.com/devframes/devframe/pull/478/files#diff-b7201157bb4da195993e2a8481f0dba03458a7e876da250e0d7e18fc3946371e
https://github.com/devframes/devframe/pull/478/files#diff-b7201157bb4da195993e2a8481f0dba03458a7e876da250e0d7e18fc3946371e
https://github.com/devframes/devframe/pull/478/files#diff-b7201157bb4da195993e2a8481f0dba03458a7e876da250e0d7e18fc3946371e
https://github.com/devframes/devframe/pull/478/files#diff-b7201157bb4da195993e2a8481f0dba03458a7e876da250e0d7e18fc3946371e
packages/vite/test/single.test.tshttps://github.com/devframes/devframe/pull/478/files#diff-b7d4c93babea1e6c25634d871bb072cd9e363c90023cf1ca9d7d6871cbca92cb
View file https://github.com/zerone0x/devframe/blob/463f7d765d2bb5d1d2429faebc73f0c4ce7c9238/packages/vite/test/single.test.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/478/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/478/files#diff-b7d4c93babea1e6c25634d871bb072cd9e363c90023cf1ca9d7d6871cbca92cb
https://github.com/devframes/devframe/pull/478/files#diff-b7d4c93babea1e6c25634d871bb072cd9e363c90023cf1ca9d7d6871cbca92cb
Please reload this pagehttps://github.com/devframes/devframe/pull/478/files
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.