Skip to content

feat(docs): landing page refresh + /v2 alternative landing page - #26

Open
thecaphimself wants to merge 1 commit into
mainfrom
feat/landing-page
Open

feat(docs): landing page refresh + /v2 alternative landing page#26
thecaphimself wants to merge 1 commit into
mainfrom
feat/landing-page

Conversation

@thecaphimself

@thecaphimself thecaphimself commented Aug 20, 2026

Copy link
Copy Markdown
Member

Summary

Refreshes the official landing page and adds a new alternative landing page at /v2.

Official landing page (/)

  • Rewrite hero description and the site meta description (base.ts)
  • Redesign the use-cases section as a clean editorial index list (no cards/glow)
  • Add a "How It Works" section — "Autonomous execution. Human-defined limits." (5-step flow)
  • Remove em dashes from marketing copy

New landing page (/v2)

Alternative, narrower positioning around bounded autonomy / agent financial permissions (control-plane framing): hero, How It Works, control plane, session keys, Agent Permissions API, bounded autonomy, MCP, three concrete demos (x402 / trading / subscriptions), ecosystem, FAQ, CTA. Industries section intentionally dropped to keep the message narrow.

Notes

  • Local production build passes (vite build).
  • Original / layout/components reused; /v2 lives in src/sections/v2/ so the two pages are independent.
  • CTAs on /v2 currently point to /docs/$ as placeholders — real "View demo" / x402 destinations TBD.

Deploy

Reviewable before going live; merging to main triggers the Vercel production deploy.

🤖 Generated with Claude Code

Greptile Summary

The PR refreshes the primary marketing page and introduces an independently composed /v2 landing page focused on bounded agent permissions.

  • Adds the /v2 route, generated route-tree registration, and a complete set of alternative landing-page sections.
  • Adds a five-step “How It Works” section and redesigns the primary page’s use-case presentation.
  • Updates hero, FAQ, and global SEO copy.

Confidence Score: 4/5

The PR appears safe to merge, with non-blocking cleanup recommended for hydration stability and strict route typing.

The new landing page is structurally registered and composed correctly, while its decorative rail generation can produce server/client rendering differences and its generated route entry bypasses strict type validation.

Files Needing Attention: apps/docs/src/sections/v2/bounded-autonomy.tsx; apps/docs/src/route-tree.gen.ts

Important Files Changed

Filename Overview
apps/docs/src/app/v2.tsx Registers and composes the new alternative landing page from shared and v2-specific sections.
apps/docs/src/sections/v2/bounded-autonomy.tsx Adds the autonomy comparison section, but its module-level random visual data is nondeterministic across SSR and hydration.
apps/docs/src/sections/v2/hero.tsx Adds the alternative positioning, installation action, and acknowledged placeholder demo CTA.
apps/docs/src/sections/how-it-works.tsx Adds a five-step animated explanation of scoped agent execution to the primary landing page.
apps/docs/src/sections/use-cases.tsx Replaces the card grid with an animated editorial index while preserving the use-case content.
apps/docs/src/route-tree.gen.ts Registers /v2 throughout the generated route types but adds an explicit any assertion contrary to repository guidance.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  V[Visitor opens /v2] --> H[Hero]
  H --> W[How It Works]
  W --> P[Control Plane]
  P --> S[Session Keys and Permissions]
  S --> B[Bounded Autonomy]
  B --> D[Demos and Integrations]
  D --> F[FAQ]
  F --> C[Final CTA]
Loading

Reviews (1): Last reviewed commit: "feat(docs): refresh landing hero/meta co..." | Re-trigger Greptile

Greptile also left 2 inline comments on this PR.

Context used:

  • Context used - AGENTS.md (source)

… add /v2 landing page

- Rewrite hero description and site meta description
- Redesign use-cases as an editorial index list
- Add 'How It Works' section to the landing page
- Add /v2 alternative landing page (control-plane positioning)
- Remove em dashes from marketing copy

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment on lines +24 to +32
const slowLines = Array.from({ length: 100 }, () => ({
marginTop: `${Math.random() * 160}px`,
width: `${20 + Math.random() * 40}px`,
}));

const fastLines = Array.from({ length: 100 }, () => ({
marginTop: `${Math.random() * 160}px`,
width: `${20 + Math.random() * 60}px`,
}));

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Nondeterministic hydration styles

The server and browser independently evaluate these module-level Math.random() calls when rendering /v2, producing different inline widths and margins for the rail elements. This violates deterministic hydration and results in hydration diagnostics, stale server-side styles, or a visible layout shift.

id: "/v2",
path: "/v2",
getParentRoute: () => rootRouteImport,
} as any);

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Route type checking bypassed

The new /v2 route configuration is asserted as any, bypassing compile-time validation and allowing incompatible route metadata to pass unchecked. This conflicts with the repository requirement to avoid placeholder any types and preserve strict checks.

Context Used: AGENTS.md (source)

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

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