Landing page section spec
This spec describes the section contract forapps/landing/src/app/page.tsx.
The landing page should explain Clay as an opportunity platform built around intentions, personalities, consent, and action.
It should not drift into a passive chatbot, resume parser, dating app, or generic marketplace.
The current page has five main content sections: hero, problem, solution, experience, and business
model / market. The header and footer are supporting page chrome.
On this page
- The five-step narrative arc
- The global design direction
- Section contracts for header, hero, problem, solution, experience, market, and footer
- The current known gaps
- Edit rules when changing the page
Narrative arc
State the thesis
Recommendations should understand what someone is trying to become, not only what they clicked,
liked, bought, followed, or swiped.
Name the failure
Existing platforms know activity, but miss timing, readiness, personality, and the reason behind
behavior.
Explain Clay's mechanism
Clay builds a living model of intention and personality, then translates that understanding into
opportunity fit.
Make the experience tangible
The user should feel checked on, heard, understood, and guided toward fewer but better actions.
Global design direction
Clay’s landing design should feel human, tactile, and decisive. Use the existing visual system: warmpaper (cream), deep ink (almost-black), acid-lime for momentum and readiness, electric-purple for personality and opportunity paths, tomato-orange for human attention and expressive action, clay-pink for support and warmth, and warm-taupe for grounding and supportive context (see design language for canonical token names). Use the active theme accent for consent and safety, never color alone.
Use the “plasticine” direction from the landing design system as a metaphor: personal context is moldable and living, while recommendations should feel crisp and useful. Avoid a page made only of repeated cards. Important sections should have distinct visual jobs.
See Design language for the canonical token meanings, component behavior, and image-generation boundary.
Section contracts
Site header
| Field | Spec |
|---|---|
| Source | apps/landing/src/components/landing/sections/site-header.tsx |
| Role | Persistent orientation and trust chrome. |
| User question | ”Where am I, and what can I inspect?” |
| Product primitive | Action. |
| Current pattern | Sticky paper-toned bar with a code-native Clay mark, desktop anchor navigation, a Consent anchor, and a “See the model” CTA. |
- Add visible focus states for links and CTA.
- Consider active-section state once the page has enough scroll depth to warrant it.
- Keep the mobile header simple, but make the primary action comfortably tappable.
- The header still stays intentionally lightweight on mobile. If the page grows, consider a compact menu instead of adding more persistent chrome.
Hero
| Field | Spec |
|---|---|
| Source | apps/landing/src/components/landing/sections/hero-section.tsx |
| Section id | top |
| Role | First-position thesis. |
| User question | ”What is Clay’s big idea?” |
| Product primitive | Intention and opportunity. |
| Current pattern | Cream-paper editorial hero with oversized thesis, supporting copy, action CTAs, and a mascot-led Layer 1 visual. |
- Add a short supporting line if the hero needs more immediate clarity about “opportunity platform.”
- Use the mascot scene as the primary visual anchor. Keep UI chips and copy around it explicit so the mascot never carries consent, readiness, or fit meaning by itself.
- Keep the first viewport focused; do not crowd the thesis with implementation detail.
- The hero depends on the mascot scene staying legible and not reading as a toy-first brand. If the asset changes, preserve equal mascot profile importance and explicit UI labels.
Problem
| Field | Spec |
|---|---|
| Source | apps/landing/src/components/landing/sections/problem-section.tsx |
| Section id | problem |
| Role | Establish why generic discovery often produces weak opportunity fit. |
| User question | ”Why does this need to exist?” |
| Product primitive | Intention, personality, and opportunity. |
| Current pattern | Intro copy, five observed-behavior versus missed-intent cards, and a dark summary slab. |
- Keep the platform cards as a comparison pattern: observed behavior versus missed intent.
- Use an editorial map or staggered layout if the five equal cards feel too generic.
- Keep the dark summary as the emotional landing point of the section.
- Consent is introduced later in the page, so this section should stay focused on the failure of activity-based inference.
Solution
| Field | Spec |
|---|---|
| Source | apps/landing/src/components/landing/sections/solution-section.tsx |
| Section id | solution |
| Role | Define Clay’s operating model. |
| User question | ”How does Clay solve it?” |
| Product primitive | Intention, personality, opportunity, consent, and action. |
| Current pattern | Two-column explanation, three numbered process cards, signal chips, and an anchored consent boundary panel. |
- Treat the three cards as a fit pipeline: intention capture, personality learning, action.
- Make the signal chips feel like permissioned context tokens, not generic tags.
- Use the active theme accent deliberately where the design is communicating trust, consent, or safety, and pair it with explicit labels and reversible controls.
- The consent panel is now visible, but it still summarizes policy rather than letting users exercise reversible controls. Product flows should handle the actual controls.
Experience
| Field | Spec |
|---|---|
| Source | apps/landing/src/components/landing/sections/experience-section.tsx |
| Section id | experience |
| Role | Make Clay feel lived and usable. |
| User question | ”What would using Clay feel like?” |
| Product primitive | Intention, personality, action, and opportunity. |
| Current pattern | Feeling journey cards, an opportunity-surface panel, and six plasticine use-case tiles. |
- Progress bars may animate on entry, but they should feel directional rather than falsely quantitative.
- Keep code-native plasticine artifacts readable and verify contrast on desktop and mobile.
- Keep broad opportunity examples visible: community, local plans, self-understanding, projects, jobs, events, and collaborators.
- Some examples are still lifestyle-led. Keep adding work, project, community, and partner examples as the product surface matures.
Business model and market
| Field | Spec |
|---|---|
| Source | apps/landing/src/components/landing/sections/business-model-section.tsx |
| Section id | market |
| Role | Convert the product logic into business and investor logic. |
| User question | ”Can this become a business?” |
| Product primitive | Opportunity, consent, and action. |
| Current pattern | Business lane cards, pricing model cards, permissioned handoff flow, market signal links, dark partner panel, and research cards. |
- Keep the content grouped into lanes: user value, partner value, market proof.
- Give research links stronger link affordance and keyboard focus treatment.
- Preserve the permissioned handoff visualization: user gives permission, Clay translates context, partner improves the moment, Clay learns from the outcome.
- This remains the longest section. If it feels heavy in rendered review, reduce the number of visible proof cards before adding new material.
Site footer
| Field | Spec |
|---|---|
| Source | apps/landing/src/components/landing/sections/site-footer.tsx |
| Role | Quiet brand close and outbound contact path. |
| User question | ”What is the final takeaway, and where do I go next?” |
| Product primitive | Opportunity. |
| Current pattern | Code-native Clay lockup, tagline, user-flow CTA, partner CTA, and outbound contact CTA. |
- Keep the close simple.
- Make the CTA destination clearer if it remains external.
- Preserve separate CTAs for user interest, partner interest, and contact.
- The external contact path is still founder-oriented, so keep the preceding CTAs Clay-specific.
Known gaps
Consent now has a visible boundary
The landing page now links to an explicit consent panel. Future product flows should add real
reversible permission controls rather than only descriptive copy.
Opportunity breadth is visible
The experience section now shows six surfaces. Keep expanding work, project, community, and
partner examples so lifestyle use cases do not dominate the story.
Card sameness should be reduced
Several sections rely on similar rounded cards. Preserve cards for repeated items, but give
major sections distinct structures and visual rhythm.
Actions should be clearer
The page has investor and external contact CTAs, but it does not yet define separate next
actions for users, partners, and investors.
Edit rules
- Keep Clay framed as an opportunity platform, not a chatbot or dating app.
- Keep public copy benefit-first and plain; technical stack details belong outside the landing hero.
- Preserve the arc: thesis, problem, solution, experience, market.
- When code behavior or section meaning changes, update this spec in the same change.
- Before claiming a visual iteration is done, verify desktop and mobile screenshots for text fit, contrast, artifact framing, and section rhythm.
Related
Design language
The canonical token meanings, component behavior, and image-generation boundary.
Themes
The Acid Lime, Editorial, and Dark Plum theme packs and when each is used.
Mascot
Clay the mascot — anatomy, expressions, accessories, and rendering rules.
Components
The reusable visual components the landing page is built from.

