docs(site): redesign homepage for portable workspaces

[skevetter]

The homepage's generic feature grid and animated hero made it difficult to see how Devsy Desktop, the CLI, providers, and editors fit together. Lead with portable developer workspaces, an authentic running-workspace terminal frame, a provider chooser, clear installation links, verified compatibility, and the runnable CLI quickstart.

Use restrained purple accents, responsive typography and layouts, visible keyboard focus, a skip link, Escape-to-close mobile navigation, and reduced-motion handling. Keep existing branding, navigation destinations, services copy, Netlify form behavior, analytics integration, and legal text. Organize the existing markup into small components and a mobile-navigation hook. No dependencies or runtime/provider code change.

Closes #1440

Validation:

• Production Next.js build and TypeScript check passed; 115 static routes generated. Documentation link check: 0 errors.
• Relevant pre-commit hooks, secret checks, and git diff --check passed. Sites are excluded from repository Biome hooks; supplemental lint passed with the inherited fragment-anchor false positive excluded.
• Browser checks at 320, 375, 390, 768, 992, 1024, 1280, and 1440px showed no horizontal overflow. Verified navigation, installation CTA, mobile Escape/focus restoration, skip link, required form fields, light/dark contrast, and reduced motion.
• Final CodeRabbit review: zero findings. CodeScene: 10.0 with no findings, against baseline 7.34. Independent source review found no actionable findings. Rebuilt homepage markup exactly matches the visually accepted design.

Desktop/mobile screenshots and a production-export loopback preview were provided for visual inspection. Full-page captures await the lazy provider image's decode. Real form submission, production analytics delivery, remote CI, and production performance have not been verified.

The product captures originate from the repository's June 2026 assets. The terminal PNG exactly preserves a decoded GIF frame; the provider image uses only a CSS display crop. The hero is about 186 KiB with explicit dimensions/high fetch priority; the provider screenshot is lazy-loaded. No claim of fresh/latest-release captures is made.

Coordinate the logo replacement in #1212: existing logo markup is preserved here, but that PR needs refreshed patch context after this source extraction. Merge and deployment require separate approval.

Summary by CodeRabbit

• New Features
  • Added a responsive navigation menu that collapses on smaller screens and supports keyboard interaction.
  • Added clearer sections covering workspace definitions, editors, providers, lifecycle controls, agent workspaces, and services.
  • Added a skip link and accessible labels for page sections, navigation, and forms.
• Improvements
  • Refreshed the homepage layout, typography, imagery, and light and dark themes.
  • Updated mobile layouts and spacing for smaller screens, and improved focus visibility and reduced-motion support.

[netlify]

✅ Deploy Preview for devsydev ready!

Name	Link
🔨 Latest commit	5569b41
🔍 Latest deploy log	https://app.netlify.com/projects/devsydev/deploys/6ac88b3c1e467b0007f79b97
😎 Deploy Preview	https://deploy-preview-1443--devsydev.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: Organization UI
• Review profile: CHILL
• Plan: Advanced
• Run ID: c5642601-1193-40e8-adee-cae2f53a91df

📥 Commits

Reviewing files that changed from the base of the PR and between 2e7708d and 5569b41.

⛔ Files ignored due to path filters (1)

• sites/docs-devsy-sh/public/docs/media/workspace-terminal-demo.png is excluded by !**/*.png

📒 Files selected for processing (2)

• sites/docs-devsy-sh/app/(home)/home.css
• sites/docs-devsy-sh/app/(home)/page.tsx

Included review availability: This review used your included allowance. Your plan provides up to 2 included reviews per hour; 1 remain after this review.

---

📝 Walkthrough

Walkthrough

The homepage is reorganized into separate sections with workspace-focused content, accessible navigation, and responsive light and dark styling.

Changes

Homepage redesign

Layer / File(s)	Summary
Homepage shell and navigation sites/docs-devsy-sh/app/(home)/page.tsx, sites/docs-devsy-sh/app/(home)/home.css	The page adds a skip link and extracted header. Mobile navigation closes on Escape, link selection, and desktop-width changes; Escape returns focus to the toggle. Styles scope page tokens and add focus and reduced-motion states.
Workspace content and responsive layouts sites/docs-devsy-sh/app/(home)/page.tsx, sites/docs-devsy-sh/app/(home)/home.css	The hero, compatibility details, features, agents, providers, and workflow use updated content and product imagery. Styles add section layouts and responsive grids.
Services, contact, and footer sites/docs-devsy-sh/app/(home)/page.tsx, sites/docs-devsy-sh/app/(home)/home.css	Services, contact, download, and footer content are organized into separate components. The contact form fields and site links remain, with updated section and form layouts.

Priority: ⬇️ Low

Estimated code review effort: 3 (Moderate) | ~25 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 5569b

The homepage redesign has no identified issue that needs to be resolved before merge; normal validation and approval still apply.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage		Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 13 functions across 1 files. (1 skipped: 1…	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check		Check skipped - CodeRabbit’s high-level summary is enabled.
Title check		The title clearly and concisely describes the main change: a documentation site homepage redesign focused on portable workspaces.
Linked Issues check		Issue #1440 requires a homepage redesign in sites/docs-devsy-sh that leads with portable workspaces, Devsy Desktop and CLI, providers, editors/backends, installation, and product examples. The revie…
Out of Scope Changes check		The reviewed diff is limited to the homepage component and homepage-scoped CSS. The changes support issue #1440 through layout, content presentation, accessibility, responsive behavior, and validation…

Full details: Docstring Coverage

Explanation

Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 13 functions across 1 files. (1 skipped: 1 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches

✨ Simplify code

• Commit to this branch
• Create a new PR

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[netlify]

✅ Deploy Preview for images-devsy-sh canceled.

Name	Link
🔨 Latest commit	5569b41
🔍 Latest deploy log	https://app.netlify.com/projects/images-devsy-sh/deploys/6ac88b3c43f7880008cc72df

[mergify]

This pull request does not currently match the merge queue conditions, so it cannot be queued from here. The box comes back if it matches again.

[skevetter]

@greptileai please review this pull request at the current head, 5569b41.

[greptile-apps]

Confidence Score: 5/5

[Low impact] The PR appears safe to merge, subject to the separately required approval.

Summary

The homepage now leads with portable workspaces, product screenshots, editor compatibility, and a CLI quickstart.

• The homepage shows how one workspace travels across tools and providers.
• The homepage walks visitors from a workspace definition to a running project.
• The mobile menu closes with Escape and returns focus to its toggle.
• The redesigned homepage still leads from services to contact and installation.

No actionable issues were found at 5569b41a928a3b92a96245bd4989f072970fdf84. Builds and browser checks were not rerun. The attached images could not be visually inspected because image input is unsupported here.

skevetter explicitly deferred the logo replacement to #1212 and production form, analytics, and performance verification.

_{Reviews (1) · Last reviewed commit: "docs(site): redesign homepage for portab..." · Reviewed by Greptile}