Repository navigation
feat(docs): rebuild documentation with the shared Sim design system - #9459
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
574d3ec to
4cf2622
Compare
emir-karabeg
changed the title
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
There was a problem hiding this comment.
Review completed against the latest diff
Note: This PR contains a large number of files. cubic selects up to 200 of the highest-priority eligible files for this review, so some files may not have been reviewed.
You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.
Turn on auto-fix | Re-trigger cubic
|
@cubic-dev-ai review this PR |
@waleedlatif1 I have started the AI code review. It will take a few minutes to complete. |
There was a problem hiding this comment.
All reported issues were addressed across 330 files
Note: This PR contains a large number of files. cubic selects up to 200 of the highest-priority eligible files for this review, so some files may not have been reviewed.
Requires human review: Auto-approval blocked because this review re-detected 2 unresolved issues already reported by Cubic.
You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.
Turn on auto-fix | Re-trigger cubic
|
@cubic-dev-ai review this PR |
@waleedlatif1 I have started the AI code review. It will take a few minutes to complete. |
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
There was a problem hiding this comment.
All reported issues were addressed across 330 files
Note: This PR contains a large number of files. cubic selects up to 200 of the highest-priority eligible files for this review, so some files may not have been reviewed.
Requires human review: Auto-approval blocked because this review re-detected 1 unresolved issue already reported by Cubic.
You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.
Turn on auto-fix | Re-trigger cubic
|
@cubic-dev-ai review this PR |
@waleedlatif1 I have started the AI code review. It will take a few minutes to complete. |
There was a problem hiding this comment.
No issues found across 330 files
Confidence score: 5/5
- Automated review surfaced no issues in the provided summaries.
- No files require special attention.
Note: This PR contains a large number of files. cubic selects up to 200 of the highest-priority eligible files for this review, so some files may not have been reviewed.
You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.
Turn on auto-fix | Re-trigger cubic
|
@cubic-dev-ai review this PR |
@waleedlatif1 I have started the AI code review. It will take a few minutes to complete. |
There was a problem hiding this comment.
No issues found across 330 files
Confidence score: 5/5
- Automated review surfaced no issues in the provided summaries.
- No files require special attention.
Note: This PR contains a large number of files. cubic selects up to 200 of the highest-priority eligible files for this review, so some files may not have been reviewed.
You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.
Turn on auto-fix | Re-trigger cubic
Summary
Replaces Fumadocs with a Sim-owned Next.js documentation site, one compiled catalog, and centrally managed reading/navigation components. Preserves the approved light/dark design, platform screenshot backgrounds and rounding, persistent sidebar, existing routes and machine interfaces. The catalog supplies HTML, Markdown, navigation, search, metadata, JSON discovery and public read-only MCP.
The production-readiness pass independently compared main and staging, audited the Fumadocs responsibility transfer, traced platform consumers, reproduced defects, implemented fixes, ran
/cleanup, and measured immutable production builds in CI. Full audit, parity/consumer matrices, measurements, captures and release checklist.Corrections
Main baseline:
a52fc509b5b8a18df519ff0781f00c8d45711164. Latest incorporated staging:3175daab84bfc2d7dfc8d924d55313190c280476. Intentional newer product content is retained. The 489 platform VFS identities remain compatible. Ordinary builds do not regenerate historical migration evidence.Measured results
Comparison: audit-start
f06b2d6d535b5cd0a4a80c851e54cbdd7aef189d→ final sourcef54d9f5a69cb0b3f79dd8503eccacbbc3459694e. Three trials per profile/route; medians below, with final-head ranges below and the earlier source66faa48raw observations retained in the report. Production builds, pinned Chromium/Playwright/Lighthouse; mobile network and CPU are throttled.All 300 navigation/interaction observations and 42 Lighthouse runs completed. All 84 ordinary navigations preserved the shared shell without document reloads; all six history checks restored scroll. Accessibility/best practices scored 100 throughout. Performance ≥90 in 35/42; Workflow SEO 92 in six runs because genuine product links read “Start.” Heavy mobile navigation has a 1.88 s median but a 2.28 s slow trial; mobile LCP/performance targets remain partially unmet. Ordinary JavaScript is roughly flat; Workflow renderer code remains absent from ordinary-page requests. These are lab results, not field CWV or a universal speed claim.
Validation
Final head
f54d9f5a69cb0b3f79dd8503eccacbbc3459694eincorporates staging3175daab84bfc2d7dfc8d924d55313190c280476. The preceding check caught seven expected-asset mismatches after staging changed three Search screenshots and the account-connection guide. Independent Git/Fumadocs reconstruction confirms unchanged page/heading/fence/operation counts; exact byte-preservation assertions remain intact. Failure/refresh evidence.Final-head confirmation
Exact source:
f54d9f5a69cb0b3f79dd8503eccacbbc3459694e. Production benchmark 41122450924: 300/300 interaction observations, 42/42 Lighthouse reports. Same pinned profiles and three repetitions as the retained earlier comparison; Node 24.22.1/Bun 1.4.4. Times below are medians (min–max) in milliseconds, n=3./introduction/getting-started/files/editor/search/find-content/integrations/cloudflare/api-reference/logs/getLog/workflows/introduction/getting-started/files/editor/search/find-content/integrations/cloudflare/api-reference/logs/getLog/workflows/introduction/getting-started/files/editor/search/find-content/integrations/cloudflare/api-reference/logs/getLog/workflows/introduction/getting-started/files/editor/search/find-content/integrations/cloudflare/api-reference/logs/getLog/workflowsThese are medians/ranges, n=3. Most normal desktop controls meet the approximate 100 ms median target; Workflow inspector does not. First query startup remains visible in the 2,324 ms desktop outlier. The cold pre-hydration shortcut remains unavailable in the three mobile observations; readiness-gated controls passed.
All 42 accessibility/best-practice scores are 100; SEO is 100 in 36 and 92 in six Workflow runs. Performance ≥90 in 35/42. Mobile misses are Cloudflare (3), Files (2), Search (1) and Workflow (1). Maximum CLS remains 0.08676. The Files/Search/Workflow reports show large simulated-LCP swings with the same reported paragraph insight node; observed FCP/LCP boundaries differ by microseconds or a few milliseconds in some trials. This suggests simulation timing/dependency sensitivity, but does not establish the exact cause or dismiss the budget misses. No new reproducible source defect was demonstrated. These are not field measurements.
All 84 ordinary navigations preserved the shell without reloading; all 30 consecutive moves avoided reloads; all six history trials restored 500→500px. Introduction image bodies remain 43,334B desktop/76,340B phone. The updated Search screenshot increases its 1080w/q90 body 8,956→18,436B, and mobile Search image bodies 57,084→66,564B. That increase is real; the reports do not prove it caused the score variation. Ordinary JS remains 790,903 decoded bytes (14 requests; 246,370 transferred including headers); Workflow remains 1,848,583 decoded (18 requests; 641,074 transferred). Cloudflare retains all 152 tables/7,838 rows and 6,417,366 decoded HTML bytes (480,825 gzip).
The final docs run 41122392480 tested merge
844b118a34d3e328b941f0aa56034ecee572f61d: all 2,996 corpus, 12 negotiation, 18 interface, 16 header, 20 PostgreSQL, 2 platform-fixture, 40 sample and 22 generator checks passed. Chromium 74 passed; WebKit 71 passed/3 unsupported. Both generator passes left zero changed files. The in-flight navigation transferred one 258,967B page body plus 348B tree metadata. Final root CI 41122392658 passed all 39 required jobs. The non-blocking security audit still reports 42 advisories (1 critical/15 high/19 moderate/7 low).Raw reports and captures are in those CI artifacts (14-day retention; preview build 3 days). The earlier source
66faa48observations remain committed in the audit report with their original provenance. This confirmation preserves current-head medians, ranges, individual performance scores and validation provenance in the PR without rewriting historical measurements.Release assessment
Ready for staging review; not cleared for production release or first index publication. The following production release requirements remain separate from the staging merge:
Hold the automatic main index publisher before production promotion until the matching docs deployment and explicit index backup are verified. Publication is atomic per page, not across the entire catalog. The workflow does not create a backup and checks out moving main. Rollback requires the paired docs deployment/index snapshot; legacy snapshots need legacy reader/citation checks rather than the new freshness checker.
Current canonicals remain
https://docs.sim.ai. Thesim.ai/docscutover is deferred; the exact routing/asset/protocol/citation/rollback checklist is maintained. No production index, routing, domain, deployment settings or security protections were changed. The exact final production artifact is running locally on port 3001; the updated Search screenshot was inspected in the shared expanded viewer, preserving its scenery and rounded frame.Captures
Expanded image · API without JavaScript · Mobile interaction recording
Final interaction QA
Revision
d7ae1ebd7ainsets the mobile search hover surface while retaining its 44px target, aligns API example pickers with the shared docs menus, preserves keyboard selection and focus restoration, removes dark-mode TOC overflow, protects IME composition in search, and refreshes the index when serialized workflow examples change.Three independent cleanup passes reviewed the changes; the picker accessibility ID relationship was corrected before push. Focused Biome and whitespace checks pass. Full builds, repository gates, Chromium/WebKit regression checks and production benchmarks run in CI; this revision is not considered cleared until those checks and both review bots finish. All cofounder commits are preserved.