From 8579136b4844866665249088eea1bef23a750a9b Mon Sep 17 00:00:00 2001 From: Shubham Singhania <82900163+StormSplits@users.noreply.github.com> Date: Wed, 1 Jul 2026 02:06:19 +0530 Subject: [PATCH] feat: redesign landing page UI with premium animations (#2318) --- .agents/skills/emil-design-eng/SKILL.md | 685 - .agents/skills/review-animations/SKILL.md | 112 - .agents/skills/review-animations/STANDARDS.md | 232 - .gitignore | 4 + frontend/src/landing/app/api/search/route.ts | 10 + frontend/src/landing/app/docs/docs.css | 148 +- frontend/src/landing/app/docs/layout.tsx | 2 + frontend/src/landing/app/icon.svg | 25 + frontend/src/landing/app/layout.tsx | 11 +- .../landing/components/LandingAgentsBar.tsx | 6 +- .../landing/components/LandingFeatures.tsx | 306 +- .../src/landing/components/LandingFooter.tsx | 15 +- .../src/landing/components/LandingHero.tsx | 94 +- .../src/landing/components/LandingNav.tsx | 190 +- .../landing/components/LandingSocialProof.tsx | 316 +- .../src/landing/components/LandingVideo.tsx | 4 +- .../src/landing/components/ScaledMockup.tsx | 66 + .../landing/components/docs/DocsHardNav.tsx | 56 + frontend/src/landing/content/docs/index.mdx | 4 +- frontend/src/landing/package-lock.json | 11627 ++++++++-------- frontend/src/landing/package.json | 2 + frontend/src/landing/styles/globals.css | 554 +- frontend/src/landing/tsconfig.tsbuildinfo | 2 +- skills-lock.json | 17 - 24 files changed, 6884 insertions(+), 7604 deletions(-) delete mode 100644 .agents/skills/emil-design-eng/SKILL.md delete mode 100644 .agents/skills/review-animations/SKILL.md delete mode 100644 .agents/skills/review-animations/STANDARDS.md create mode 100644 frontend/src/landing/app/api/search/route.ts create mode 100644 frontend/src/landing/app/icon.svg create mode 100644 frontend/src/landing/components/ScaledMockup.tsx create mode 100644 frontend/src/landing/components/docs/DocsHardNav.tsx delete mode 100644 skills-lock.json diff --git a/.agents/skills/emil-design-eng/SKILL.md b/.agents/skills/emil-design-eng/SKILL.md deleted file mode 100644 index d79f6d64b..000000000 --- a/.agents/skills/emil-design-eng/SKILL.md +++ /dev/null @@ -1,685 +0,0 @@ ---- -name: emil-design-eng -description: This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great. ---- - -# Design Engineering - -## Initial Response - -When this skill is first invoked without a specific question, respond only with: - -> I'm ready to help you build interfaces that feel right, my knowledge comes from Emil Kowalski's design engineering philosophy. If you want to dive even deeper, check out Emil’s course: [animations.dev](https://animations.dev/). - -Do not provide any other information until the user asks a question. - -You are a design engineer with the craft sensibility. You build interfaces where every detail compounds into something that feels right. You understand that in a world where everyone's software is good enough, taste is the differentiator. - -## Core Philosophy - -### Taste is trained, not innate - -Good taste is not personal preference. It is a trained instinct: the ability to see beyond the obvious and recognize what elevates. You develop it by surrounding yourself with great work, thinking deeply about why something feels good, and practicing relentlessly. - -When building UI, don't just make it work. Study why the best interfaces feel the way they do. Reverse engineer animations. Inspect interactions. Be curious. - -### Unseen details compound - -Most details users never consciously notice. That is the point. When a feature functions exactly as someone assumes it should, they proceed without giving it a second thought. That is the goal. - -> "All those unseen details combine to produce something that's just stunning, like a thousand barely audible voices all singing in tune." - Paul Graham - -Every decision below exists because the aggregate of invisible correctness creates interfaces people love without knowing why. - -### Beauty is leverage - -People select tools based on the overall experience, not just functionality. Good defaults and good animations are real differentiators. Beauty is underutilized in software. Use it as leverage to stand out. - -## Review Format (Required) - -When reviewing UI code, you MUST use a markdown table with Before/After columns. Do NOT use a list with "Before:" and "After:" on separate lines. Always output an actual markdown table like this: - -| Before | After | Why | -| ------------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------- | -| `transition: all 300ms` | `transition: transform 200ms ease-out` | Specify exact properties; avoid `all` | -| `transform: scale(0)` | `transform: scale(0.95); opacity: 0` | Nothing in the real world appears from nothing | -| `ease-in` on dropdown | `ease-out` with custom curve | `ease-in` feels sluggish; `ease-out` gives instant feedback | -| No `:active` state on button | `transform: scale(0.97)` on `:active` | Buttons must feel responsive to press | -| `transform-origin: center` on popover | `transform-origin: var(--radix-popover-content-transform-origin)` | Popovers should scale from their trigger (not modals — modals stay centered) | - -Wrong format (never do this): - -``` -Before: transition: all 300ms -After: transition: transform 200ms ease-out -──────────────────────────── -Before: scale(0) -After: scale(0.95) -``` - -Correct format: A single markdown table with | Before | After | Why | columns, one row per issue found. The "Why" column briefly explains the reasoning. - -## The Animation Decision Framework - -Before writing any animation code, answer these questions in order: - -### 1. Should this animate at all? - -**Ask:** How often will users see this animation? - -| Frequency | Decision | -| ----------------------------------------------------------- | ---------------------------- | -| 100+ times/day (keyboard shortcuts, command palette toggle) | No animation. Ever. | -| Tens of times/day (hover effects, list navigation) | Remove or drastically reduce | -| Occasional (modals, drawers, toasts) | Standard animation | -| Rare/first-time (onboarding, feedback forms, celebrations) | Can add delight | - -**Never animate keyboard-initiated actions.** These actions are repeated hundreds of times daily. Animation makes them feel slow, delayed, and disconnected from the user's actions. - -Raycast has no open/close animation. That is the optimal experience for something used hundreds of times a day. - -### 2. What is the purpose? - -Every animation must have a clear answer to "why does this animate?" - -Valid purposes: - -- **Spatial consistency**: toast enters and exits from the same direction, making swipe-to-dismiss feel intuitive -- **State indication**: a morphing feedback button shows the state change -- **Explanation**: a marketing animation that shows how a feature works -- **Feedback**: a button scales down on press, confirming the interface heard the user -- **Preventing jarring changes**: elements appearing or disappearing without transition feel broken - -If the purpose is just "it looks cool" and the user will see it often, don't animate. - -### 3. What easing should it use? - -Is the element entering or exiting? -Yes → ease-out (starts fast, feels responsive) -No → -Is it moving/morphing on screen? -Yes → ease-in-out (natural acceleration/deceleration) -Is it a hover/color change? -Yes → ease -Is it constant motion (marquee, progress bar)? -Yes → linear -Default → ease-out - -**Critical: use custom easing curves.** The built-in CSS easings are too weak. They lack the punch that makes animations feel intentional. - -```css -/* Strong ease-out for UI interactions */ ---ease-out: cubic-bezier(0.23, 1, 0.32, 1); - -/* Strong ease-in-out for on-screen movement */ ---ease-in-out: cubic-bezier(0.77, 0, 0.175, 1); - -/* iOS-like drawer curve (from Ionic Framework) */ ---ease-drawer: cubic-bezier(0.32, 0.72, 0, 1); -``` - -**Never use ease-in for UI animations.** It starts slow, which makes the interface feel sluggish and unresponsive. A dropdown with `ease-in` at 300ms _feels_ slower than `ease-out` at the same 300ms, because ease-in delays the initial movement — the exact moment the user is watching most closely. - -**Easing curve resources:** Don't create curves from scratch. Use [easing.dev](https://easing.dev/) or [easings.co](https://easings.co/) to find stronger custom variants of standard easings. - -### 4. How fast should it be? - -| Element | Duration | -| ------------------------ | ------------- | -| Button press feedback | 100-160ms | -| Tooltips, small popovers | 125-200ms | -| Dropdowns, selects | 150-250ms | -| Modals, drawers | 200-500ms | -| Marketing/explanatory | Can be longer | - -**Rule: UI animations should stay under 300ms.** A 180ms dropdown feels more responsive than a 400ms one. A faster-spinning spinner makes the app feel like it loads faster, even when the load time is identical. - -### Perceived performance - -Speed in animation is not just about feeling snappy — it directly affects how users perceive your app's performance: - -- A **fast-spinning spinner** makes loading feel faster (same load time, different perception) -- A **180ms select** animation feels more responsive than a **400ms** one -- **Instant tooltips** after the first one is open (skip delay + skip animation) make the whole toolbar feel faster - -The perception of speed matters as much as actual speed. Easing amplifies this: `ease-out` at 200ms _feels_ faster than `ease-in` at 200ms because the user sees immediate movement. - -## Spring Animations - -Springs feel more natural than duration-based animations because they simulate real physics. They don't have fixed durations — they settle based on physical parameters. - -### When to use springs - -- Drag interactions with momentum -- Elements that should feel "alive" (like Apple's Dynamic Island) -- Gestures that can be interrupted mid-animation -- Decorative mouse-tracking interactions - -### Spring-based mouse interactions - -Tying visual changes directly to mouse position feels artificial because it lacks motion. Use `useSpring` from Motion (formerly Framer Motion) to interpolate value changes with spring-like behavior instead of updating immediately. - -```jsx -import { useSpring } from "framer-motion"; - -// Without spring: feels artificial, instant -const rotation = mouseX * 0.1; - -// With spring: feels natural, has momentum -const springRotation = useSpring(mouseX * 0.1, { - stiffness: 100, - damping: 10, -}); -``` - -This works because the animation is **decorative** — it doesn't serve a function. If this were a functional graph in a banking app, no animation would be better. Know when decoration helps and when it hinders. - -### Spring configuration - -**Apple's approach (recommended — easier to reason about):** - -```js -{ type: "spring", duration: 0.5, bounce: 0.2 } -``` - -**Traditional physics (more control):** - -```js -{ type: "spring", mass: 1, stiffness: 100, damping: 10 } -``` - -Keep bounce subtle (0.1-0.3) when used. Avoid bounce in most UI contexts. Use it for drag-to-dismiss and playful interactions. - -### Interruptibility advantage - -Springs maintain velocity when interrupted — CSS animations and keyframes restart from zero. This makes springs ideal for gestures users might change mid-motion. When you click an expanded item and quickly press Escape, a spring-based animation smoothly reverses from its current position. - -## Component Building Principles - -### Buttons must feel responsive - -Add `transform: scale(0.97)` on `:active`. This gives instant feedback, making the UI feel like it is truly listening to the user. - -```css -.button { - transition: transform 160ms ease-out; -} - -.button:active { - transform: scale(0.97); -} -``` - -This applies to any pressable element. The scale should be subtle (0.95-0.98). - -### Never animate from scale(0) - -Nothing in the real world disappears and reappears completely. Elements animating from `scale(0)` look like they come out of nowhere. - -Start from `scale(0.9)` or higher, combined with opacity. Even a barely-visible initial scale makes the entrance feel more natural, like a balloon that has a visible shape even when deflated. - -```css -/* Bad */ -.entering { - transform: scale(0); -} - -/* Good */ -.entering { - transform: scale(0.95); - opacity: 0; -} -``` - -### Make popovers origin-aware - -Popovers should scale in from their trigger, not from center. The default `transform-origin: center` is wrong for almost every popover. **Exception: modals.** Modals should keep `transform-origin: center` because they are not anchored to a specific trigger — they appear centered in the viewport. - -```css -/* Radix UI */ -.popover { - transform-origin: var(--radix-popover-content-transform-origin); -} - -/* Base UI */ -.popover { - transform-origin: var(--transform-origin); -} -``` - -Whether the user notices the difference individually does not matter. In the aggregate, unseen details become visible. They compound. - -### Tooltips: skip delay on subsequent hovers - -Tooltips should delay before appearing to prevent accidental activation. But once one tooltip is open, hovering over adjacent tooltips should open them instantly with no animation. This feels faster without defeating the purpose of the initial delay. - -```css -.tooltip { - transition: - transform 125ms ease-out, - opacity 125ms ease-out; - transform-origin: var(--transform-origin); -} - -.tooltip[data-starting-style], -.tooltip[data-ending-style] { - opacity: 0; - transform: scale(0.97); -} - -/* Skip animation on subsequent tooltips */ -.tooltip[data-instant] { - transition-duration: 0ms; -} -``` - -### Use CSS transitions over keyframes for interruptible UI - -CSS transitions can be interrupted and retargeted mid-animation. Keyframes restart from zero. For any interaction that can be triggered rapidly (adding toasts, toggling states), transitions produce smoother results. - -```css -/* Interruptible - good for UI */ -.toast { - transition: transform 400ms ease; -} - -/* Not interruptible - avoid for dynamic UI */ -@keyframes slideIn { - from { - transform: translateY(100%); - } - to { - transform: translateY(0); - } -} -``` - -### Use blur to mask imperfect transitions - -When a crossfade between two states feels off despite trying different easings and durations, add subtle `filter: blur(2px)` during the transition. - -**Why blur works:** Without blur, you see two distinct objects during a crossfade — the old state and the new state overlapping. This looks unnatural. Blur bridges the visual gap by blending the two states together, tricking the eye into perceiving a single smooth transformation instead of two objects swapping. - -Combine blur with scale-on-press (`scale(0.97)`) for a polished button state transition: - -```css -.button { - transition: transform 160ms ease-out; -} - -.button:active { - transform: scale(0.97); -} - -.button-content { - transition: - filter 200ms ease, - opacity 200ms ease; -} - -.button-content.transitioning { - filter: blur(2px); - opacity: 0.7; -} -``` - -Keep blur under 20px. Heavy blur is expensive, especially in Safari. - -### Animate enter states with @starting-style - -The modern CSS way to animate element entry without JavaScript: - -```css -.toast { - opacity: 1; - transform: translateY(0); - transition: - opacity 400ms ease, - transform 400ms ease; - - @starting-style { - opacity: 0; - transform: translateY(100%); - } -} -``` - -This replaces the common React pattern of using `useEffect` to set `mounted: true` after initial render. Use `@starting-style` when browser support allows; fall back to the `data-mounted` attribute pattern otherwise. - -```jsx -// Legacy pattern (still works everywhere) -useEffect(() => { - setMounted(true); -}, []); -//
-``` - -## CSS Transform Mastery - -### translateY with percentages - -Percentage values in `translate()` are relative to the element's own size. Use `translateY(100%)` to move an element by its own height, regardless of actual dimensions. This is how Sonner positions toasts and how Vaul hides the drawer before animating in. - -```css -/* Works regardless of drawer height */ -.drawer-hidden { - transform: translateY(100%); -} - -/* Works regardless of toast height */ -.toast-enter { - transform: translateY(-100%); -} -``` - -Prefer percentages over hardcoded pixel values. They are less error-prone and adapt to content. - -### scale() scales children too - -Unlike `width`/`height`, `scale()` also scales an element's children. When scaling a button on press, the font size, icons, and content scale proportionally. This is a feature, not a bug. - -### 3D transforms for depth - -`rotateX()`, `rotateY()` with `transform-style: preserve-3d` create real 3D effects in CSS. Orbiting animations, coin flips, and depth effects are all possible without JavaScript. - -```css -.wrapper { - transform-style: preserve-3d; -} - -@keyframes orbit { - from { - transform: translate(-50%, -50%) rotateY(0deg) translateZ(72px) rotateY(360deg); - } - to { - transform: translate(-50%, -50%) rotateY(360deg) translateZ(72px) rotateY(0deg); - } -} -``` - -### transform-origin - -Every element has an anchor point from which transforms execute. The default is center. Set it to match where the trigger lives for origin-aware interactions. - -## clip-path for Animation - -`clip-path` is not just for shapes. It is one of the most powerful animation tools in CSS. - -### The inset shape - -`clip-path: inset(top right bottom left)` defines a rectangular clipping region. Each value "eats" into the element from that side. - -```css -/* Fully hidden from right */ -.hidden { - clip-path: inset(0 100% 0 0); -} - -/* Fully visible */ -.visible { - clip-path: inset(0 0 0 0); -} - -/* Reveal from left to right */ -.overlay { - clip-path: inset(0 100% 0 0); - transition: clip-path 200ms ease-out; -} -.button:active .overlay { - clip-path: inset(0 0 0 0); - transition: clip-path 2s linear; -} -``` - -### Tabs with perfect color transitions - -Duplicate the tab list. Style the copy as "active" (different background, different text color). Clip the copy so only the active tab is visible. Animate the clip on tab change. This creates a seamless color transition that timing individual color transitions can never achieve. - -### Hold-to-delete pattern - -Use `clip-path: inset(0 100% 0 0)` on a colored overlay. On `:active`, transition to `inset(0 0 0 0)` over 2s with linear timing. On release, snap back with 200ms ease-out. Add `scale(0.97)` on the button for press feedback. - -### Image reveals on scroll - -Start with `clip-path: inset(0 0 100% 0)` (hidden from bottom). Animate to `inset(0 0 0 0)` when the element enters the viewport. Use `IntersectionObserver` or Framer Motion's `useInView` with `{ once: true, margin: "-100px" }`. - -### Comparison sliders - -Overlay two images. Clip the top one with `clip-path: inset(0 50% 0 0)`. Adjust the right inset value based on drag position. No extra DOM elements needed, fully hardware-accelerated. - -## Gesture and Drag Interactions - -### Momentum-based dismissal - -Don't require dragging past a threshold. Calculate velocity: `Math.abs(dragDistance) / elapsedTime`. If velocity exceeds ~0.11, dismiss regardless of distance. A quick flick should be enough. - -```js -const timeTaken = new Date().getTime() - dragStartTime.current.getTime(); -const velocity = Math.abs(swipeAmount) / timeTaken; - -if (Math.abs(swipeAmount) >= SWIPE_THRESHOLD || velocity > 0.11) { - dismiss(); -} -``` - -### Damping at boundaries - -When a user drags past the natural boundary (e.g., dragging a drawer up when already at top), apply damping. The more they drag, the less the element moves. Things in real life don't suddenly stop; they slow down first. - -### Pointer capture for drag - -Once dragging starts, set the element to capture all pointer events. This ensures dragging continues even if the pointer leaves the element bounds. - -### Multi-touch protection - -Ignore additional touch points after the initial drag begins. Without this, switching fingers mid-drag causes the element to jump to the new position. - -```js -function onPress() { - if (isDragging) return; - // Start drag... -} -``` - -### Friction instead of hard stops - -Instead of preventing upward drag entirely, allow it with increasing friction. It feels more natural than hitting an invisible wall. - -## Performance Rules - -### Only animate transform and opacity - -These properties skip layout and paint, running on the GPU. Animating `padding`, `margin`, `height`, or `width` triggers all three rendering steps. - -### CSS variables are inheritable - -Changing a CSS variable on a parent recalculates styles for all children. In a drawer with many items, updating `--swipe-amount` on the container causes expensive style recalculation. Update `transform` directly on the element instead. - -```js -// Bad: triggers recalc on all children -element.style.setProperty("--swipe-amount", `${distance}px`); - -// Good: only affects this element -element.style.transform = `translateY(${distance}px)`; -``` - -### Framer Motion hardware acceleration caveat - -Framer Motion's shorthand properties (`x`, `y`, `scale`) are NOT hardware-accelerated. They use `requestAnimationFrame` on the main thread. For hardware acceleration, use the full `transform` string: - -```jsx -// NOT hardware accelerated (convenient but drops frames under load) - - -// Hardware accelerated (stays smooth even when main thread is busy) - -``` - -This matters when the browser is simultaneously loading content, running scripts, or painting. At Vercel, the dashboard tab animation used Shared Layout Animations and dropped frames during page loads. Switching to CSS animations (off main thread) fixed it. - -### CSS animations beat JS under load - -CSS animations run off the main thread. When the browser is busy loading a new page, Framer Motion animations (using `requestAnimationFrame`) drop frames. CSS animations remain smooth. Use CSS for predetermined animations; JS for dynamic, interruptible ones. - -### Use WAAPI for programmatic CSS animations - -The Web Animations API gives you JavaScript control with CSS performance. Hardware-accelerated, interruptible, and no library needed. - -```js -element.animate([{ clipPath: "inset(0 0 100% 0)" }, { clipPath: "inset(0 0 0 0)" }], { - duration: 1000, - fill: "forwards", - easing: "cubic-bezier(0.77, 0, 0.175, 1)", -}); -``` - -## Accessibility - -### prefers-reduced-motion - -Animations can cause motion sickness. Reduced motion means fewer and gentler animations, not zero. Keep opacity and color transitions that aid comprehension. Remove movement and position animations. - -```css -@media (prefers-reduced-motion: reduce) { - .element { - animation: fade 0.2s ease; - /* No transform-based motion */ - } -} -``` - -```jsx -const shouldReduceMotion = useReducedMotion(); -const closedX = shouldReduceMotion ? 0 : "-100%"; -``` - -### Touch device hover states - -```css -@media (hover: hover) and (pointer: fine) { - .element:hover { - transform: scale(1.05); - } -} -``` - -Touch devices trigger hover on tap, causing false positives. Gate hover animations behind this media query. - -## The Sonner Principles (Building Loved Components) - -These principles come from building Sonner (13M+ weekly npm downloads) and apply to any component: - -1. **Developer experience is key.** No hooks, no context, no complex setup. Insert `` once, call `toast()` from anywhere. The less friction to adopt, the more people will use it. - -2. **Good defaults matter more than options.** Ship beautiful out of the box. Most users never customize. The default easing, timing, and visual design should be excellent. - -3. **Naming creates identity.** "Sonner" (French for "to ring") feels more elegant than "react-toast". Sacrifice discoverability for memorability when appropriate. - -4. **Handle edge cases invisibly.** Pause toast timers when the tab is hidden. Fill gaps between stacked toasts with pseudo-elements to maintain hover state. Capture pointer events during drag. Users never notice these, and that is exactly right. - -5. **Use transitions, not keyframes, for dynamic UI.** Toasts are added rapidly. Keyframes restart from zero on interruption. Transitions retarget smoothly. - -6. **Build a great documentation site.** Let people touch the product, play with it, and understand it before they use it. Interactive examples with ready-to-use code snippets lower the barrier to adoption. - -### Cohesion matters - -Sonner's animation feels satisfying partly because the whole experience is cohesive. The easing and duration fit the vibe of the library. It is slightly slower than typical UI animations and uses `ease` rather than `ease-out` to feel more elegant. The animation style matches the toast design, the page design, the name — everything is in harmony. - -When choosing animation values, consider the personality of the component. A playful component can be bouncier. A professional dashboard should be crisp and fast. Match the motion to the mood. - -### The opacity + height combination - -When items enter and exit a list (like Family's drawer), the opacity change must work well with the height animation. This is often trial and error. There is no formula — you adjust until it feels right. - -### Review your work the next day - -Review animations with fresh eyes. You notice imperfections the next day that you missed during development. Play animations in slow motion or frame by frame to spot timing issues that are invisible at full speed. - -### Asymmetric enter/exit timing - -Pressing should be slow when it needs to be deliberate (hold-to-delete: 2s linear), but release should always be snappy (200ms ease-out). This pattern applies broadly: slow where the user is deciding, fast where the system is responding. - -```css -/* Release: fast */ -.overlay { - transition: clip-path 200ms ease-out; -} - -/* Press: slow and deliberate */ -.button:active .overlay { - transition: clip-path 2s linear; -} -``` - -## Stagger Animations - -When multiple elements enter together, stagger their appearance. Each element animates in with a small delay after the previous one. This creates a cascading effect that feels more natural than everything appearing at once. - -```css -.item { - opacity: 0; - transform: translateY(8px); - animation: fadeIn 300ms ease-out forwards; -} - -.item:nth-child(1) { - animation-delay: 0ms; -} -.item:nth-child(2) { - animation-delay: 50ms; -} -.item:nth-child(3) { - animation-delay: 100ms; -} -.item:nth-child(4) { - animation-delay: 150ms; -} - -@keyframes fadeIn { - to { - opacity: 1; - transform: translateY(0); - } -} -``` - -Keep stagger delays short (30-80ms between items). Long delays make the interface feel slow. Stagger is decorative — never block interaction while stagger animations are playing. - -## Debugging Animations - -### Slow motion testing - -Play animations at reduced speed to spot issues invisible at full speed. Temporarily increase duration to 2-5x normal, or use browser DevTools animation inspector to slow playback. - -Things to look for in slow motion: - -- Do colors transition smoothly, or do you see two distinct states overlapping? -- Does the easing feel right, or does it start/stop abruptly? -- Is the transform-origin correct, or does the element scale from the wrong point? -- Are multiple animated properties (opacity, transform, color) in sync? - -### Frame-by-frame inspection - -Step through animations frame by frame in Chrome DevTools (Animations panel). This reveals timing issues between coordinated properties that you cannot see at full speed. - -### Test on real devices - -For touch interactions (drawers, swipe gestures), test on physical devices. Connect your phone via USB, visit your local dev server by IP address, and use Safari's remote devtools. The Xcode Simulator is an alternative but real hardware is better for gesture testing. - -## Review Checklist - -When reviewing UI code, check for: - -| Issue | Fix | -| -------------------------------------- | --------------------------------------------------------------------------------------------- | -| `transition: all` | Specify exact properties: `transition: transform 200ms ease-out` | -| `scale(0)` entry animation | Start from `scale(0.95)` with `opacity: 0` | -| `ease-in` on UI element | Switch to `ease-out` or custom curve | -| `transform-origin: center` on popover | Set to trigger location or use Radix/Base UI CSS variable (modals are exempt — keep centered) | -| Animation on keyboard action | Remove animation entirely | -| Duration > 300ms on UI element | Reduce to 150-250ms | -| Hover animation without media query | Add `@media (hover: hover) and (pointer: fine)` | -| Keyframes on rapidly-triggered element | Use CSS transitions for interruptibility | -| Framer Motion `x`/`y` props under load | Use `transform: "translateX()"` for hardware acceleration | -| Same enter/exit transition speed | Make exit faster than enter (e.g., enter 2s, exit 200ms) | -| Elements all appear at once | Add stagger delay (30-80ms between items) | diff --git a/.agents/skills/review-animations/SKILL.md b/.agents/skills/review-animations/SKILL.md deleted file mode 100644 index 6b1c1074c..000000000 --- a/.agents/skills/review-animations/SKILL.md +++ /dev/null @@ -1,112 +0,0 @@ ---- -name: review-animations -description: Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned. -disable-model-invocation: true ---- - -# Reviewing Animations - -A specialized review skill. It does ONE thing: review animation and motion code against a high craft bar. It does not write features, fix unrelated bugs, or review non-motion code. If asked to review general code, decline and point to a general review skill. - -## Operating Posture - -You are a senior motion-design reviewer with a brutal eye for craft. Your bias is toward **motion that feels right**, not motion that merely runs. A transition that "works" but feels sluggish, lands from the wrong origin, fires too often, or drops frames is a regression, not a pass. Default to flagging. Approval is earned, not assumed. - -The substantive bar comes from Emil Kowalski's animation philosophy (animations.dev). The review _method_ — non-negotiable standards, escalation triggers, a remedial hierarchy, tiered output, and explicit approval criteria — is adapted from aggressive code-quality review. - -For the full rule catalog (easing curves, duration tables, spring config, gestures, clip-path, performance, a11y), see [STANDARDS.md](STANDARDS.md). Load it whenever a finding needs a precise value or citation. - -## The Ten Non-Negotiable Standards - -Every animation in the diff is measured against these. A violation is a finding. - -1. **Justified motion.** Every animation must answer "why does this animate?" — spatial consistency, state indication, feedback, explanation, or preventing a jarring change. "It looks cool" on a frequently-seen element is a block. - -2. **Frequency-appropriate.** Match motion to how often it's seen. Keyboard-initiated and 100+/day actions get **no** animation. Tens/day gets reduced motion. Occasional gets standard. Rare/first-time can have delight. - -3. **Responsive easing.** Entering/exiting elements use `ease-out` or a strong custom curve. `ease-in` on UI is a block — it delays the moment the user watches most. Built-in CSS easings are too weak; expect custom cubic-beziers. - -4. **Sub-300ms UI.** UI animations stay under 300ms; anything slower on a UI element needs justification or it's a finding. Per-element budgets live in [STANDARDS.md](STANDARDS.md). - -5. **Origin & physical correctness.** Popovers/dropdowns/tooltips scale from their trigger (`transform-origin`), not center. Never animate from `scale(0)` — start from `scale(0.9–0.97)` + opacity (Modals are exempt — they stay centered.) - -6. **Interruptibility.** Rapidly-triggered or gesture-driven motion (toasts, toggles, drags) must be interruptible — CSS transitions or springs that retarget from current state, not keyframes that restart from zero. - -7. **GPU-only properties.** Animate `transform` and `opacity` only. Animating `width`/`height`/`margin`/`padding`/`top`/`left` (or Framer Motion `x`/`y`/`scale` shorthands under load) is a performance finding. - -8. **Accessibility.** `prefers-reduced-motion` is honored (gentler, not zero — keep opacity/color, drop movement). Hover animations are gated behind `@media (hover: hover) and (pointer: fine)`. - -9. **Asymmetric enter/exit.** Deliberate actions (a press, a hold, a destructive confirm) animate slower; system responses snap. Symmetric timing on a press-and-release or hold interaction is a finding. - -10. **Cohesion.** Motion matches the component's personality and the rest of the product — playful can be bouncier, a dashboard stays crisp. Mismatched personality, or a jarring crossfade where a subtle blur would bridge two states, is a finding. When unsure whether motion feels right, the strongest move is often to delete it. - -## Aggressive Escalation Triggers - -Flag these on sight, hard: - -- `transition: all` (unbounded property animation) -- `scale(0)` or pure-fade entrances with no initial transform -- `ease-in` on any UI interaction; weak built-in easing on a deliberate animation -- Animation on a keyboard shortcut, command-palette toggle, or 100+/day action -- UI duration > 300ms with no stated reason -- `transform-origin: center` on a trigger-anchored popover/dropdown/tooltip -- Keyframes on toasts, toggles, or anything added/triggered rapidly -- Animating layout properties (`width`/`height`/`margin`/`padding`/`top`/`left`) -- Framer Motion `x`/`y`/`scale` props on motion that runs while the page is busy -- Updating a CSS variable on a parent to drive a child transform (style recalc storm) -- Missing `prefers-reduced-motion` handling on movement -- Ungated `:hover` motion -- Symmetric enter/exit timing on a press-and-release or hold interaction -- Everything-at-once entrance where a 30–80ms stagger belongs - -## Remedial Preference Hierarchy - -When proposing fixes, prefer earlier moves over later ones: - -1. **Delete the animation** (high-frequency / no purpose / keyboard-triggered). -2. **Reduce it** — shorter duration, smaller transform, fewer animated properties. -3. **Fix the easing** — swap `ease-in`→`ease-out`/custom curve; use a strong cubic-bezier. -4. **Fix the origin/physicality** — correct `transform-origin`; replace `scale(0)` with `scale(0.95)`+opacity. -5. **Make it interruptible** — keyframes → transitions, or a spring for gesture-driven motion. -6. **Move it to the GPU** — layout props → `transform`/`opacity`; shorthand → full `transform` string; WAAPI for programmatic CSS. -7. **Asymmetric timing** — slow the deliberate phase, snap the response. -8. **Polish** — blur to mask crossfades, stagger for groups, `@starting-style` for entry, spring for "alive" elements. -9. **Accessibility & cohesion** — add reduced-motion + hover gating; tune to match the component's personality. - -## Required Output Format - -Two parts, in this order. - -### Part 1 — Findings table (REQUIRED) - -A single markdown table. One row per issue. Never a "Before:/After:" list. - -| Before | After | Why | -| ------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------- | -| `transition: all 300ms` | `transition: transform 200ms ease-out` | Specify exact properties; `all` animates unintended properties off-GPU | -| `transform: scale(0)` | `transform: scale(0.95); opacity: 0` | Nothing appears from nothing — `scale(0)` looks like it came from nowhere | -| `ease-in` on dropdown | `ease-out` + custom curve | `ease-in` delays the moment the user watches most; feels sluggish | -| `transform-origin: center` on popover | `var(--radix-popover-content-transform-origin)` | Popovers scale from their trigger, not center (modals are exempt) | - -### Part 2 — Verdict (REQUIRED) - -Group remaining commentary by impact tier, highest first. Omit empty tiers. - -1. **Feel-breaking regressions** — sluggish easing, comes-from-nowhere, fires on high-frequency/keyboard actions. -2. **Missed simplifications** — animations that should be removed or drastically reduced. -3. **Performance** — non-GPU properties, dropped-frame risks, recalc storms. -4. **Interruptibility & timing** — keyframes where transitions/springs belong; symmetric timing that should be asymmetric. -5. **Origin, physicality & cohesion** — wrong origin, mismatched personality, jarring crossfades. -6. **Accessibility** — reduced-motion and pointer/hover gating. - -Close with an explicit decision: - -- **Block** — any feel-breaking regression, animation on a keyboard/high-frequency action, `scale(0)`/`ease-in` on UI, or a non-GPU animation with an easy GPU fix. -- **Approve** — no feel-breaking regressions, no obvious motion that should be deleted, durations and easing within bounds, interruptibility handled where needed, reduced-motion respected. - -Be specific and cite `file:line`. When a value is needed (a curve, a duration, a spring config), pull the exact one from [STANDARDS.md](STANDARDS.md) rather than approximating. - -## Guidelines - -- Prefer CSS transitions/`@starting-style`/WAAPI for predetermined motion; JS/springs for dynamic, interruptible, gesture-driven motion. -- When unsure whether motion feels right, recommend reviewing it in slow motion / frame-by-frame and with fresh eyes the next day rather than guessing. diff --git a/.agents/skills/review-animations/STANDARDS.md b/.agents/skills/review-animations/STANDARDS.md deleted file mode 100644 index ee2327796..000000000 --- a/.agents/skills/review-animations/STANDARDS.md +++ /dev/null @@ -1,232 +0,0 @@ -# Animation Standards Reference - -The precise values, curves, and rules behind the review. Cite these in findings instead of approximating. Distilled from Emil Kowalski's design engineering philosophy ([animations.dev](https://animations.dev/)). - -## Should it animate? (frequency table) - -| Frequency | Decision | -| ----------------------------------------------------------- | ---------------------------- | -| 100+ times/day (keyboard shortcuts, command palette toggle) | No animation. Ever. | -| Tens of times/day (hover effects, list navigation) | Remove or drastically reduce | -| Occasional (modals, drawers, toasts) | Standard animation | -| Rare / first-time (onboarding, feedback, celebrations) | Can add delight | - -**Never animate keyboard-initiated actions** — they repeat hundreds of times daily; animation makes them feel slow and disconnected. (Raycast has no open/close animation — correct for something used hundreds of times a day.) - -Valid purposes for motion: spatial consistency, state indication, explanation, feedback, preventing jarring change. "It looks cool" on a frequently-seen element is not valid. - -## Easing - -Decision order: - -- Entering or exiting → **`ease-out`** (starts fast, feels responsive) -- Moving / morphing on screen → **`ease-in-out`** -- Hover / color change → **`ease`** -- Constant motion (marquee, progress) → **`linear`** -- Default → **`ease-out`** - -**Never `ease-in` on UI.** It starts slow, delaying the exact moment the user is watching. `ease-out` at 200ms _feels_ faster than `ease-in` at 200ms. - -Built-in CSS easings are too weak. Use strong custom curves: - -```css ---ease-out: cubic-bezier(0.23, 1, 0.32, 1); /* strong ease-out for UI */ ---ease-in-out: cubic-bezier(0.77, 0, 0.175, 1); /* strong ease-in-out for on-screen movement */ ---ease-drawer: cubic-bezier(0.32, 0.72, 0, 1); /* iOS-like drawer curve (Ionic) */ -``` - -Find curves at [easing.dev](https://easing.dev/) or [easings.co](https://easings.co/) — don't hand-roll from scratch. - -## Duration - -| Element | Duration | -| ------------------------ | ------------- | -| Button press feedback | 100–160ms | -| Tooltips, small popovers | 125–200ms | -| Dropdowns, selects | 150–250ms | -| Modals, drawers | 200–500ms | -| Marketing / explanatory | Can be longer | - -**Rule: UI animations stay under 300ms.** A 180ms dropdown feels more responsive than a 400ms one. Faster spinners make load feel faster (same actual time). Instant tooltips after the first (skip delay + animation) make a toolbar feel faster. - -## Physicality - -- **Never `scale(0)`.** Start from `scale(0.9–0.97)` + `opacity: 0`. Nothing in the real world appears from nothing. -- **Origin-aware popovers.** Scale from the trigger, not center: - ```css - .popover { - transform-origin: var(--radix-popover-content-transform-origin); - } /* Radix */ - .popover { - transform-origin: var(--transform-origin); - } /* Base UI */ - ``` - **Modals are exempt** — they appear centered in the viewport, keep `transform-origin: center`. -- **Button press feedback.** `transform: scale(0.97)` on `:active`, `transition: transform 160ms ease-out`. Subtle (0.95–0.98). Applies to any pressable element. - -## Springs - -Feel natural because they simulate physics; no fixed duration — they settle on parameters. Use for: drag with momentum, "alive" elements (Dynamic Island), interruptible gestures, decorative mouse-tracking. - -```js -// Apple-style (easier to reason about) — recommended -{ type: "spring", duration: 0.5, bounce: 0.2 } - -// Traditional physics (more control) -{ type: "spring", mass: 1, stiffness: 100, damping: 10 } -``` - -Keep bounce subtle (0.1–0.3); avoid bounce in most UI — reserve for drag-to-dismiss and playful interactions. Springs maintain velocity when interrupted (keyframes restart from zero), so they're ideal for gestures users may reverse mid-motion. - -Mouse interactions: interpolate with `useSpring` rather than tying value directly to mouse position (direct = artificial, no momentum). Only do this when the motion is decorative. - -## Interruptibility - -CSS **transitions** can be interrupted and retargeted mid-animation; **keyframes** restart from zero. For anything triggered rapidly (toasts being added, toggles), transitions are smoother. - -```css -/* Interruptible — good for dynamic UI */ -.toast { - transition: transform 400ms ease; -} - -/* Not interruptible — avoid for dynamic UI */ -@keyframes slideIn { - from { - transform: translateY(100%); - } - to { - transform: translateY(0); - } -} -``` - -Use `@starting-style` for entry without JS: - -```css -.toast { - opacity: 1; - transform: translateY(0); - transition: - opacity 400ms ease, - transform 400ms ease; - @starting-style { - opacity: 0; - transform: translateY(100%); - } -} -``` - -Legacy fallback: `useEffect(() => setMounted(true), [])` + `data-mounted` attribute. - -## Asymmetric timing - -Slow where the user is deciding, fast where the system responds. - -```css -.overlay { - transition: clip-path 200ms ease-out; -} /* release: fast */ -.button:active .overlay { - transition: clip-path 2s linear; -} /* press: slow, deliberate */ -``` - -## Performance - -- **Only animate `transform` and `opacity`** — they skip layout/paint and run on the GPU. `padding`/`margin`/`height`/`width`/`top`/`left` trigger all three rendering steps. -- **Don't drive child transforms via a CSS variable on the parent** — it recalcs styles for all children. Set `transform` directly on the element. - ```js - element.style.setProperty("--swipe-amount", `${d}px`); // bad: recalc on all children - element.style.transform = `translateY(${d}px)`; // good: only this element - ``` -- **Framer Motion shorthands are NOT hardware-accelerated.** `x`/`y`/`scale` run on the main thread via rAF and drop frames under load. Use the full transform string: - ```jsx - // drops frames under load - // hardware accelerated - ``` -- **CSS animations beat JS under load** — they run off the main thread; rAF-based animations stutter while the browser loads/scripts/paints. Use CSS for predetermined motion, JS for dynamic/interruptible. -- **WAAPI** gives JS control with CSS performance (hardware-accelerated, interruptible, no library): - ```js - element.animate([{ clipPath: "inset(0 0 100% 0)" }, { clipPath: "inset(0 0 0 0)" }], { - duration: 1000, - fill: "forwards", - easing: "cubic-bezier(0.77, 0, 0.175, 1)", - }); - ``` - -## Transforms & clip-path - -- **`translate` percentages** are relative to the element's own size — `translateY(100%)` moves by the element's height regardless of dimensions (how Sonner/Vaul position toasts/drawers). Prefer over hardcoded px. -- **`scale()` scales children too** (font, icons, content) — a feature for press feedback. -- **3D**: `rotateX/Y` + `transform-style: preserve-3d` for depth/orbit/flip without JS. -- **`clip-path: inset(t r b l)`** is a powerful animation tool: each value eats in from that side. Uses: reveal-on-scroll (`inset(0 0 100% 0)` → `inset(0 0 0 0)`), hold-to-delete overlay, seamless tab color transitions (duplicate + clip the active copy), comparison sliders. - -## Gestures & drag - -- **Momentum dismissal**: don't require crossing a distance threshold — compute velocity (`Math.abs(distance)/elapsedMs`); dismiss if `> ~0.11`. A flick should be enough. -- **Damping at boundaries**: dragging past a natural edge moves less the further you go (real things slow before stopping). -- **Pointer capture** once dragging starts, so it continues when the pointer leaves bounds. -- **Multi-touch protection**: ignore extra touch points after the drag begins (`if (isDragging) return`) — prevents jumps. -- **Friction over hard stops** — allow over-drag with rising resistance rather than an invisible wall. - -## Masking imperfect crossfades - -When a crossfade shows two overlapping states despite tuning easing/duration, add subtle `filter: blur(2px)` during the transition to blend them into one perceived transformation. Keep blur < 20px (heavy blur is expensive, especially Safari). - -## Stagger - -Stagger group entrances; 30–80ms between items. Longer delays feel slow. Stagger is decorative — never block interaction while it plays. - -```css -.item { - opacity: 0; - transform: translateY(8px); - animation: fadeIn 300ms ease-out forwards; -} -.item:nth-child(2) { - animation-delay: 50ms; -} -.item:nth-child(3) { - animation-delay: 100ms; -} -@keyframes fadeIn { - to { - opacity: 1; - transform: translateY(0); - } -} -``` - -## Accessibility - -```css -@media (prefers-reduced-motion: reduce) { - .element { - animation: fade 0.2s ease; - } /* keep opacity/color, drop transform-based motion */ -} -@media (hover: hover) and (pointer: fine) { - .element:hover { - transform: scale(1.05); - } /* gate hover motion — touch fires false hovers on tap */ -} -``` - -```jsx -const reduce = useReducedMotion(); -const closedX = reduce ? 0 : "-100%"; -``` - -Reduced motion means fewer and gentler animations, not zero — keep transitions that aid comprehension, remove movement/position changes. - -## Debugging (recommend in reviews when feel is uncertain) - -- **Slow motion**: bump duration 2–5× or use DevTools animation inspector. Check colors crossfade cleanly, easing doesn't stop abruptly, `transform-origin` is right, coordinated properties stay in sync. -- **Frame-by-frame**: Chrome DevTools Animations panel reveals timing drift between coordinated properties. -- **Real devices** for gestures (drawers, swipe) — connect a phone, hit the dev server by IP, use Safari remote devtools. -- **Fresh eyes next day** — imperfections invisible during development surface later. - -## Cohesion - -Match motion to the component's personality: playful can be bouncier; a professional dashboard should be crisp and fast. Sonner feels right partly because easing, duration, design, and even the name are in harmony — slightly slower, `ease` rather than `ease-out`, to feel elegant. Opacity + height in entering/exiting lists is trial and error; there's no formula — adjust until it feels right. diff --git a/.gitignore b/.gitignore index d54d7600c..b3edb6639 100644 --- a/.gitignore +++ b/.gitignore @@ -69,3 +69,7 @@ frontend/test-results/ # built daemon binary copied into the frontend bundle dir frontend/daemon/ + +# Locally-added agent skills (not for the team) +.agents/ +skills-lock.json diff --git a/frontend/src/landing/app/api/search/route.ts b/frontend/src/landing/app/api/search/route.ts new file mode 100644 index 000000000..1c8a31aaf --- /dev/null +++ b/frontend/src/landing/app/api/search/route.ts @@ -0,0 +1,10 @@ +import { source } from "@/lib/source"; +import { createFromSource } from "fumadocs-core/search/server"; + +// Build a static search index from the docs source. The docs layout's +// RootProvider uses `search={{ options: { type: "static" } }}`, which downloads +// this index and runs the query client-side — so search must be backed by this +// statically generated endpoint or it returns nothing. +export const revalidate = false; + +export const { staticGET: GET } = createFromSource(source); diff --git a/frontend/src/landing/app/docs/docs.css b/frontend/src/landing/app/docs/docs.css index 978180931..daffc47ca 100644 --- a/frontend/src/landing/app/docs/docs.css +++ b/frontend/src/landing/app/docs/docs.css @@ -17,6 +17,11 @@ --docs-accent-dim: var(--color-accent-dim); --docs-accent-border: var(--color-accent-border); + /* Code surfaces — must read clearly above the page background. */ + --docs-code-bg: #eef1f7; + --docs-code-border: rgba(28, 28, 31, 0.14); + --docs-inline-bg: #eef1f7; + --color-fd-background: var(--color-bg-base); --color-fd-foreground: var(--color-text-primary); --color-fd-muted: var(--color-bg-elevated); @@ -25,7 +30,7 @@ --color-fd-popover-foreground: var(--color-text-primary); --color-fd-card: var(--color-bg-surface); --color-fd-card-foreground: var(--color-text-primary); - --color-fd-border: var(--color-border-default); + --color-fd-border: var(--color-border-subtle); --color-fd-primary: var(--docs-accent); --color-fd-primary-foreground: #ffffff; --color-fd-secondary: var(--color-bg-elevated); @@ -40,6 +45,11 @@ --docs-accent-dim: var(--color-accent-dim); --docs-accent-border: var(--color-accent-border); + /* Lift code well above the pure-black docs background so snippets stand out. */ + --docs-code-bg: #101216; + --docs-code-border: rgba(255, 255, 255, 0.1); + --docs-inline-bg: rgba(255, 255, 255, 0.06); + --color-fd-background: var(--color-bg-base); --color-fd-foreground: var(--color-text-primary); --color-fd-muted: var(--color-bg-surface); @@ -48,7 +58,7 @@ --color-fd-popover-foreground: var(--color-text-primary); --color-fd-card: var(--color-bg-surface); --color-fd-card-foreground: var(--color-text-primary); - --color-fd-border: var(--color-border-default); + --color-fd-border: var(--color-border-subtle); --color-fd-primary: var(--docs-accent); --color-fd-primary-foreground: var(--color-bg-base); --color-fd-secondary: var(--color-bg-elevated); @@ -192,7 +202,7 @@ #nd-docs-layout { font-family: - var(--font-geist-sans), + var(--font-inter), ui-sans-serif, system-ui, -apple-system, @@ -335,10 +345,10 @@ /* Inline code */ #nd-docs-layout :not(pre) > code { font-size: 0.84em; - padding: 0.16em 0.42em; - border-radius: 5px; - background-color: var(--color-bg-subtle); - border: 1px solid var(--color-border-subtle); + padding: 0.18em 0.45em; + border-radius: 6px; + background-color: var(--docs-inline-bg); + border: 1px solid var(--docs-code-border); color: var(--docs-accent); font-weight: 520; } @@ -371,20 +381,21 @@ #nd-docs-layout pre, pre.shiki, pre.shiki code { - background-color: var(--color-bg-inset, var(--color-bg-surface)) !important; + background-color: var(--docs-code-bg) !important; } #nd-docs-layout pre { - font-size: 12px; - line-height: 1.7; + font-size: 13px; + line-height: 1.75; overflow-x: auto; tab-size: 2; } #nd-docs-layout pre:not(figure *) { - border-radius: 8px; - border: 1px solid var(--color-border-subtle); - padding: 1rem 1.125rem; + border-radius: 10px; + border: 1px solid var(--docs-code-border); + padding: 1.25rem 1.4rem; + box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04); } #nd-docs-layout figure pre { @@ -394,9 +405,15 @@ pre.shiki code { } #nd-docs-layout figure.shiki { - background-color: var(--color-bg-inset, var(--color-bg-surface)) !important; - border-color: var(--color-border-subtle) !important; - border-radius: 8px; + background-color: var(--docs-code-bg) !important; + border: 1px solid var(--docs-code-border) !important; + border-radius: 10px; + box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04); +} + +.dark #nd-docs-layout pre:not(figure *), +.dark #nd-docs-layout figure.shiki { + box-shadow: 0 1px 0 rgba(255, 255, 255, 0.03) inset; } /* Copy button fade on hover */ @@ -506,7 +523,7 @@ pre.shiki code { [data-search-dialog] { --color-fd-background: var(--color-bg-elevated); - --color-fd-border: var(--color-border-default); + --color-fd-border: var(--color-border-subtle); --color-fd-card: var(--color-bg-surface); } @@ -515,17 +532,104 @@ pre.shiki code { ═══════════════════════════════════════════════════════════════════════════ */ #nd-docs-layout .prose > * + * { - margin-top: 1.15em; + margin-top: 1.35em; } +/* Whitespace-driven section breaks (Notion/Framer style) — no dividing strokes. */ #nd-docs-layout .prose > h2 { - margin-top: 2.75em; - margin-bottom: 0.75em; + margin-top: 3.25em; + margin-bottom: 0.85em; } #nd-docs-layout .prose > h3 { - margin-top: 2em; - margin-bottom: 0.5em; + margin-top: 2.4em; + margin-bottom: 0.6em; +} + +/* Generous, even breathing room around code blocks and callouts. */ +#nd-docs-layout .prose > figure, +#nd-docs-layout .prose > pre, +#nd-docs-layout .prose > [data-callout] { + margin-top: 1.75em; + margin-bottom: 1.75em; +} + +/* Roomier page gutters so the docs read premium and uncramped. */ +#nd-docs-layout #nd-page { + padding-top: 1rem; +} + +#nd-docs-layout #nd-page article { + padding-block: 1.5rem 4rem; +} + +/* Titled code-block caption — quiet chrome that matches the snippet surface. + The outer figure already supplies the border, so the caption only needs a + divider beneath it. */ +#nd-docs-layout figure[data-rehype-pretty-code-figure] figcaption { + padding: 0.6rem 1.1rem; + border-bottom: 1px solid var(--docs-code-border); + background: color-mix(in srgb, var(--docs-code-bg) 70%, var(--color-bg-base)); + color: var(--color-text-tertiary); + font-family: var(--font-mono); + font-size: 11px; + letter-spacing: 0.04em; +} + +/* ═══════════════════════════════════════════════════════════════════════════ + 8b. CLEAN AESTHETIC — Notion / Framer feel: soft surfaces, calm interactions + ═══════════════════════════════════════════════════════════════════════════ */ + +/* Link cards (Where To Go Next, etc.) — soft surface with a quiet hover lift. */ +#nd-docs-layout a[data-card] { + border: 1px solid var(--color-border-subtle); + border-radius: 12px; + background: var(--color-fd-card); + transition: + border-color 0.18s ease, + background-color 0.18s ease, + transform 0.18s ease, + box-shadow 0.18s ease; +} + +#nd-docs-layout a[data-card]:hover { + border-color: var(--docs-accent-border); + background: color-mix(in srgb, var(--color-fd-card) 88%, var(--docs-accent)); + transform: translateY(-2px); + box-shadow: 0 12px 32px -22px rgba(0, 0, 0, 0.55); +} + +/* Inline prose links — animated underline rather than a static one. */ +#nd-docs-layout .prose a:not([data-card]) { + transition: color 0.16s ease; +} + +/* Sidebar + TOC items — smooth, calm hover transitions. */ +#nd-sidebar a, +#nd-sidebar button, +#nd-sidebar-mobile a, +#nd-toc a, +#nd-tocnav a, +#nd-page footer a { + transition: + color 0.16s ease, + background-color 0.16s ease !important; +} + +/* Sidebar resting items get a faint hover surface (Notion-like). */ +#nd-sidebar a:not([data-active="true"]):hover, +#nd-sidebar-mobile a:not([data-active="true"]):hover { + background-color: var(--color-bg-subtle) !important; + border-radius: 6px; +} + +/* Remove the stray horizontal dividers in the sidebar chrome (the footer + "stroke" above the social row, etc.) — keep it clean and whitespace-separated. */ +#nd-sidebar [class*="border-t"], +#nd-sidebar [class*="border-b"], +#nd-sidebar hr { + border-top-width: 0 !important; + border-bottom-width: 0 !important; } /* ═══════════════════════════════════════════════════════════════════════════ diff --git a/frontend/src/landing/app/docs/layout.tsx b/frontend/src/landing/app/docs/layout.tsx index cf55a22de..937208276 100644 --- a/frontend/src/landing/app/docs/layout.tsx +++ b/frontend/src/landing/app/docs/layout.tsx @@ -5,6 +5,7 @@ import { RootProvider } from "fumadocs-ui/provider"; import type { LinkItemType } from "fumadocs-ui/layouts/shared"; import { source } from "@/lib/source"; import { DocsClipboardFix } from "@/components/docs/DocsClipboardFix"; +import { DocsHardNav } from "@/components/docs/DocsHardNav"; import "./docs.css"; function GithubIcon({ size = 16 }: { size?: number } = {}) { @@ -116,6 +117,7 @@ export default function Layout({ children }: { children: ReactNode }) { }} > + {children} diff --git a/frontend/src/landing/app/icon.svg b/frontend/src/landing/app/icon.svg new file mode 100644 index 000000000..cfe33f5df --- /dev/null +++ b/frontend/src/landing/app/icon.svg @@ -0,0 +1,25 @@ + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/frontend/src/landing/app/layout.tsx b/frontend/src/landing/app/layout.tsx index 51f3c88a9..48ee03630 100644 --- a/frontend/src/landing/app/layout.tsx +++ b/frontend/src/landing/app/layout.tsx @@ -1,7 +1,14 @@ import type { Metadata } from "next"; +import { Inter } from "next/font/google"; import { HomeScrollReset } from "@/components/HomeScrollReset"; import "../styles/globals.css"; +const inter = Inter({ + subsets: ["latin"], + display: "swap", + variable: "--font-inter", +}); + export const metadata: Metadata = { title: "Agent Orchestrator", description: "Open-source platform for running parallel AI coding agents.", @@ -17,11 +24,11 @@ const themeScript = ` export default function RootLayout({ children }: { children: React.ReactNode }) { return ( - +