Title: [BUG] Docs content build fails on Windows: page paths use backslashes · Issue #10066 · simstudioai/sim · GitHub
Open Graph Title: [BUG] Docs content build fails on Windows: page paths use backslashes · Issue #10066 · simstudioai/sim
X Title: [BUG] Docs content build fails on Windows: page paths use backslashes · Issue #10066 · simstudioai/sim
Description: Describe the bug On Windows, bun run content:generate in apps/docs (and so bun run type-check, and the repo's pre-push hook) fails with: error: Navigation /meta.json references missing page ./introduction/index error: script "content:gen...
Open Graph Description: Describe the bug On Windows, bun run content:generate in apps/docs (and so bun run type-check, and the repo's pre-push hook) fails with: error: Navigation /meta.json references missing page ./intro...
X Description: Describe the bug On Windows, bun run content:generate in apps/docs (and so bun run type-check, and the repo's pre-push hook) fails with: error: Navigation /meta.json references missing page ./i...
Opengraph URL: https://github.com/simstudioai/sim/issues/10066
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[BUG] Docs content build fails on Windows: page paths use backslashes","articleBody":"**Describe the bug**\n\nOn Windows, `bun run content:generate` in `apps/docs` (and so `bun run type-check`, and the repo's pre-push hook) fails with:\n\n```\nerror: Navigation /meta.json references missing page ./introduction/index\nerror: script \"content:generate\" exited with code 1\n```\n\n`apps/docs/content/docs/introduction/index.mdx` exists. The cause is in `apps/docs/scripts/compile-content.ts` (line 214 on `staging`):\n\n```ts\nconst relative = path.relative(CONTENT_ROOT, file)\n```\n\nOn Windows, `path.relative` returns `introduction\\index.mdx`. Everything derived from `relative` keeps the backslashes, including the page URL: the `/(^|\\/)index$/` replace doesn't match, so the page becomes `/introduction\\index`. The navigation builder then looks up `meta.json` entries like `./introduction/index` with `/`, finds nothing, and throws.\n\nBecause the pre-push hook runs `type-check` across every workspace, this blocks every push from a Windows machine, whatever the change.\n\n**To Reproduce**\n\n1. On Windows, clone the repo and run `bun install` (Node 24).\n2. `cd apps/docs`\n3. `bun run content:generate`\n4. See the `references missing page ./introduction/index` error.\n\n**Expected behavior**\n\nThe content build behaves the same on Windows as on macOS/Linux.\n\n**Proposed fix**\n\nNormalize the separator once, where `relative` is created:\n\n```ts\nconst relative = path.relative(CONTENT_ROOT, file).split(path.sep).join('/')\n```\n\nI tested this locally on Windows: unpatched, it fails as above; patched, `content:generate` completes (`Catalog ready: 829 pages`). On macOS/Linux `path.sep` is already `/`, so it's a no-op there. Happy to open a PR.\n\n**Screenshots**\n\nTerminal output from `apps/docs`, `bun run content:generate`:\n\n\u003cdetails>\n\u003csummary>Before (unpatched): fails\u003c/summary>\n\n```\n[2026-11-15T02:52:38.022Z] [INFO] [DocsContent] Compiled 500 authored pages\nerror: Navigation /meta.json references missing page ./introduction/index\nerror: script \"content:generate\" exited with code 1\n```\n\u003c/details>\n\n\u003cdetails>\n\u003csummary>After (with the one-line fix): succeeds\u003c/summary>\n\n```\n[2026-11-15T02:53:53.178Z] [INFO] [DocsContent] Compiled 450 authored pages\n[2026-11-15T02:53:53.774Z] [INFO] [DocsContent] Compiled 500 authored pages\n[2026-11-15T02:54:00.902Z] [INFO] [DocsLlmsFullAsset] Generated full documentation static asset\n[2026-11-15T02:54:01.109Z] [INFO] [DocsContent] Catalog ready: 829 pages (510 recompiled), 41999291 bytes\n```\n\u003c/details>\n\n**Additional context**\n\n- Windows 11, Bun 1.4.4, Node 24.22.3, `staging` at `eaed9a110f`.\n- Same class of issue as #9400, which normalizes separators in two `scripts/check-*.ts` audits. This one is in the docs build and isn't covered there.\n- Found while running the local gate for #10065.\n","author":{"url":"https://github.com/mofopeadegoke","@type":"Person","name":"mofopeadegoke"},"datePublished":"2026-11-15T03:14:24Z","url":"https://github.com/simstudioai/sim/issues/10066"}
| react-profiling | 0 |
| react-import-map | react,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-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:f444e54b-9e1d-74cf-c7a2-fa1d4ba34ba7 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 9346:15FC93:CBB0B2:11DBC1A:6AFB81C5 |
| html-safe-nonce | f12ff3392963f32e4872627f1ce3dd19c405baab21f429a685b586446689e09e |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5MzQ2OjE1RkM5MzpDQkIwQjI6MTFEQkMxQTo2QUZCODFDNSIsInZpc2l0b3JfaWQiOiI3MzYxMzE1Mzk4Njk3NTgzMDQ1IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 3942381efeefe9712f9d29ec1033c3c923343830c62f0808bebcabb978487bcc |
| hovercard-subject-tag | issue:6399402393 |
| 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/simstudioai/sim/10066/issue_layout |
| twitter:image | https://opengraph.githubassets.com/0e9023323e4b7a166af647d445ccf11de21511dbc751219c8b10c4a529f98dfa/simstudioai/sim/issues/10066 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/0e9023323e4b7a166af647d445ccf11de21511dbc751219c8b10c4a529f98dfa/simstudioai/sim/issues/10066 |
| og:image:alt | Describe the bug On Windows, bun run content:generate in apps/docs (and so bun run type-check, and the repo's pre-push hook) fails with: error: Navigation /meta.json references missing page ./intro... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | mofopeadegoke |
| hostname | github.com |
| expected-hostname | github.com |
| None | ef32892d4269fb87b55e81cc4ba8d86e0f16aa28446ffbf46cba8be5179ab188 |
| turbo-cache-control | no-preview |
| go-import | github.com/simstudioai/sim git https://github.com/simstudioai/sim.git |
| octolytics-dimension-user_id | 199344406 |
| octolytics-dimension-user_login | simstudioai |
| octolytics-dimension-repository_id | 912559512 |
| octolytics-dimension-repository_nwo | simstudioai/sim |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 912559512 |
| octolytics-dimension-repository_network_root_nwo | simstudioai/sim |
| 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 | bc3703b4dcbe820d1284ef63c88b001c850be25e |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width