Skip to content

feat: add guide for splitting STEP assemblies into separate part files - #89

Merged
devaraj3 merged 1 commit into
mainfrom
feature/landing-page-performance
Jul 26, 2026
Merged

feat: add guide for splitting STEP assemblies into separate part files#89
devaraj3 merged 1 commit into
mainfrom
feature/landing-page-performance

Conversation

@devaraj3

Copy link
Copy Markdown
Owner

What changed

  • New guide page: src/pages/guides/SplitStepAssembly.tsx — a real, server-rendered page (same pattern as Landing) targeting "how to split a STEP assembly into separate part files," a validated real pain point with no existing free-online answer
  • Routing: added /guides/split-step-assembly to the routes array in src/main.tsx
  • Discovery: added the new URL to public/sitemap.xml and a new "Guides" section in public/llms.txt
  • Scroll fix: the page previously couldn't scroll, inherited from global overflow: hidden styles meant for the full-screen viewer/landing hero. Fixed by scoping a body.guide-page class (set via this page's <Head>) and overriding overflow/height only for that class — / and /viewer are unaffected
  • FAQPage structured data: added a second JSON-LD block (schema.org FAQPage) matching the visible FAQ content word-for-word, so Google can render it as an expandable rich result
  • Visual redesign: switched this page specifically to a light theme (dark theme on / and /viewer untouched) with a modern, skimmable layout — card-style "why you'd need this" items, numbered step cards, accordion-style FAQ, generous spacing/line-height, max-width readable column
  • Screenshot: added a real annotated screenshot of the disassemble/export flow with descriptive alt text, in public/guides/split-step-assembly-demo.png
  • Internal linking: added a "← Back to CAD Viewer" link at the top of the guide, and a link to the guide from the bottom of src/pages/Landing.tsx
  • External linking: SolidWorks, Siemens NX, and reaConverter mentions now link out to their official sites
  • Page-specific social tags: added og:title, og:description, og:url, og:type, and Twitter title/description specific to this page (previously it would've inherited the homepage's generic social preview)

Why

  • Targets a real, underserved search intent (confirmed via research — existing forum posts show people struggling with this exact task, with no free online tool addressing it directly)
  • Fixes a genuine usability bug (page couldn't scroll) caught during manual testing before this ever reached production
  • FAQ schema and page-specific OG tags are on-page SEO/sharing improvements that were missing from the initial implementation
  • Internal/external linking and the screenshot address real gaps flagged during review — better UX, more trust, and a small additional discovery surface (Google Image Search) for a low cost

Validation

  • Manually tested in npm run preview: page scrolls correctly end-to-end
  • Confirmed internal links (breadcrumb back home, and homepage → guide link) navigate correctly
  • npm run lint
  • npm run typecheck
  • npm run build (confirm dist/guides/split-step-assembly.html contains full server-rendered content, both JSON-LD blocks, and the image reference)
  • Live check after deploy: view-source shows real content + both JSON-LD blocks; fresh incognito direct visit to /guides/split-step-assembly loads correctly; screenshot image actually renders (not broken)

Notes

  • / and /viewer are functionally and visually untouched — all theme/layout changes are scoped to this route only
  • After this merges and deploys, submit the URL via Google Search Console's URL Inspection → Request Indexing, same as done for the homepage
  • No further scope planned for this page beyond this PR — treating it as done once validated live

@vercel

vercel Bot commented Jul 26, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
cad-viewer Ready Ready Preview, Comment Jul 26, 2026 12:25pm

@devaraj3
devaraj3 merged commit 974a8d1 into main Jul 26, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant