Efecto — Design Web Pages with AI
Efecto is a real-time web design tool that AI agents control programmatically. You create a session, the user opens a URL in their browser, and you push design commands that render instantly. Every node maps to a real HTML element styled with Tailwind CSS — web-native, semantic, and pixel-accurate.
Setup
This skill requires the Efecto MCP server. Check if it's available by looking for tools like create_session, add_section, or get_document in your tool list.
If Efecto tools are NOT available, install the MCP server:
Claude Code
claude mcp add efecto -- npx -y @efectoapp/mcp
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"efecto": {
"command": "npx",
"args": ["-y", "@efectoapp/mcp"]
}
}
}
Windsurf / VS Code / Other MCP Clients
{
"mcpServers": {
"efecto": {
"command": "npx",
"args": ["-y", "@efectoapp/mcp"]
}
}
}
Once installed, you'll have access to 68 MCP tools, including image search and native animation authoring. The MCP server connects your agent to the Efecto design canvas at efecto.app.
How Sessions Work
Agent ──POST /execute──> Server ──SSE──> Browser (renders live)
Agent <──poll/response── Server <──POST── Browser (returns results)
- You create a session via the MCP server or REST API
- The user opens the returned Efecto URL in their browser
- You push tool calls — each one executes in the browser and returns a result
- The user sees every change live as you build the design
Sessions expire after 2 hours of inactivity. The browser must be connected before tool calls can execute. If you restart or lose the MCP process, call attach_session with the user's current Efecto URL instead of creating a duplicate session.
Quick Start — Build a Page in 7 Steps
Step 1: Create a Session
create_session
label: "Landing page design"
Returns { sessionId, documentId, designUrl }. Tell the user to open the URL. The session ID is stored automatically — all subsequent tools use it.
If the user already has an Efecto URL with ?session=..., resume it:
attach_session
designUrl: "https://efecto.app/design/<file-id>/untitled?session=<session-id>"
Do not call create_session again to "reconnect". Use attach_session for an existing URL. A second create_session call refuses to overwrite a paired session unless you pass force: true.
Step 2: Wait for Browser Connection
wait_for_connection
Blocks until the browser opens the URL and pairs (default 120s). Returns immediately if already paired.
To inspect routing state at any time:
session_status # legacy single-session shape (sessionId, paired, browserConnected, knownSessions)
session_status { all: true } # list shape — all sessions in this MCP process with isActive / paired flags
Step 3: Create an Artboard
create_artboard
name: "Homepage"
width: 1440
height: 900
backgroundColor: "#ffffff"
className: "flex flex-col"
Returns the artboard ID. Always set className to "flex flex-col" so children stack vertically.
Step 4: Add Sections with JSX
add_section
parentId: "<artboard-id>"
jsx: '<nav name="Primary Navigation" className="flex items-center justify-between px-16 py-5 bg-white w-full">
<h2 name="Brand Name" className="text-xl font-bold text-gray-900">Acme</h2>
<div name="Navigation Links" className="flex items-center gap-8">
<a name="Features Link" className="text-sm text-gray-600" href="#">Features</a>
<a name="Pricing Link" className="text-sm text-gray-600" href="#">Pricing</a>
<button name="Get Started Button" className="px-4 py-2 text-sm font-medium text-white bg-gray-900 rounded-lg">Get Started</button>
</div>
</nav>'
This is the most efficient way to build complex layouts — one JSX string per section.
Step 5: Read Current State
get_document
Returns JSX-like markup with data-id attributes on every node. Use these IDs for updates.
Step 6: Fine-Tune with Updates
batch_update
updates: [
{ nodeId: "abc", className: "text-2xl font-extrabold text-gray-900" },
{ nodeId: "def", textContent: "Updated heading text" }
]
Step 7: Iterate
Repeat Steps 4-6 to add more sections, adjust styling, and refine the design. The user sees every change in real time.
The Design Tools
Reading State
| Tool |
Purpose |
get_selection |
Returns currently selected nodes/artboards with JSX subtrees |
get_document |
Returns document as JSX. Scoped modes (preferred on large docs): outline: true (one-line summary per top-level child), artboardId (single artboard), maxDepth (cap descent; 0 = artboard header only, 1 = top-level children only). Response includes an approx-token count. |
list_artboards |
Lists all artboards with IDs, names, dimensions |
find_nodes |
Search nodes by name, text content, type, or className. Returns IDs without subtree — use this to locate before calling get_node_tree. |
get_node_tree |
Serializes one node/artboard subtree only — drill in after outline or find_nodes. |
Creating Content
| Tool |
Purpose |
create_artboard |
Creates a new artboard (screen/frame) |
add_section |
Adds complex layouts from JSX markup (preferred) |
add_node |
Adds a single node to a parent |
Modifying Content
| Tool |
Purpose |
update_node |
Updates any node property (className, textContent, tag, style, src, link, elementId, etc.) |
update_class |
Shortcut: replaces only className on a node |
update_artboard |
Updates artboard properties (name, size, background, className, timelineDuration) |
batch_update |
Updates multiple nodes in one call (bulk styling) |
replace_section |
Replaces a node and its children with new JSX |
Animation
| Tool |
Purpose |
list_animation_presets |
Lists native Efecto animation presets with ids, categories, defaults, and supported controls |
apply_animation_plan |
Applies a validated multi-layer animation plan in one call |
clear_animations |
Clears native animations from nodes, the selection, an artboard, or the whole document |
Organizing Structure
| Tool |
Purpose |
move_node |
Reparents or reorders a node |
duplicate_node |
Deep-clones a node with fresh IDs |
duplicate_artboard |
Deep-clones an artboard for variations |
group_nodes |
Wraps selected nodes in a frame container |
ungroup_node |
Unwraps a group, moving children to parent |
reorder_node |
Brings to front or sends to back (z-order) |
Display & Selection
| Tool |
Purpose |
select_nodes |
Highlights nodes for the user to see |
set_visibility |
Shows/hides nodes (like Figma eye icon) |
delete_nodes |
Deletes nodes and their children |
delete_artboard |
Deletes an artboard and all contents |
Alignment & Distribution
| Tool |
Purpose |
align_nodes |
Aligns multiple nodes (left/center/right/top/middle/bottom) |
distribute_nodes |
Distributes nodes evenly (horizontal/vertical) |
History
| Tool |
Purpose |
undo |
Undoes the last action (Cmd+Z) |
redo |
Redoes the last undone action (Cmd+Shift+Z) |
Viewport & Document
| Tool |
Purpose |
zoom_to_artboard |
Zooms viewport to show a specific artboard |
zoom_to_fit |
Zooms to fit all artboards in the viewport |
set_viewport |
Sets viewport zoom level and/or pan position |
rename_document |
Renames the document |
new_document |
Creates a new blank document (replaces current) |
Canvas & Reading
| Tool |
Purpose |
move_artboard |
Repositions an artboard on the canvas for multi-screen flows |
deselect_all |
Clears the current node selection |
get_node_tree |
Returns JSX for one node/artboard subtree (faster than full document) |
Fill & Export
| Tool |
Purpose |
set_fill |
Sets the fill (background) of a node or artboard — solid color, gradient, or image. Handles dual-write automatically. |
export_image |
Exports an artboard or node as an image (PNG, JPEG, WebP, SVG). Returns base64 data URL. |
Theme
| Tool |
Purpose |
get_theme |
Returns the current theme tokens (colors, fonts, radii) and active mode |
set_theme |
Sets theme tokens — colors, fonts, border radii. Accepts partial updates. |
set_theme_mode |
Switches between light/dark/custom modes |
reset_theme |
Resets theme to defaults |
Design Validation
| Tool |
Purpose |
audit_design |
Audits design against professional quality rules: typography (scale, weight contrast, sizing), color (neutral consistency, pure black, low-contrast combos), spacing (4pt grid, touch targets), and AI slop detection (monotonous layouts). Pass artboardId for one artboard or omit for all. |
repair_design |
Applies safe, deterministic fixes across the document (or one artboard) in one pass: missing w-full, missing flex, arbitrary Tailwind values → inline styles, pure black → zinc-950, touch-target bumps, placeholder images, empty text defaults. Pass dryRun: true to preview. |
Image Search
| Tool |
Purpose |
search_images |
Search for free stock images (Lummi). No session required. Returns URLs to use with add_node or set_fill. |
Native Animation — Animate Existing Designs
Efecto has a native layer animation system. Do not use Tailwind animate-*, transition-*, or duration-* classes as the animation authoring path.
Workflow for "animate this":
- Inspect the target with
get_selection, get_document, get_node_tree, or list_artboards.
- Call
list_animation_presets to see supported preset IDs and settings.
- Pick the meaningful layers: hero image, headline, supporting copy, CTA, cards, icons, or product visuals. Avoid animating every nested child.
- Call
apply_animation_plan with timed entries. Use mode: "replace" for a new motion system or mode: "append" to add exit/outro animations.
- Set
timelineDuration with update_artboard when the artboard needs a deliberate playback end.
- Use
select_nodes to highlight the changed layers.
Timing defaults:
- Small UI elements: 0.18-0.35s.
- Hero/slide elements: 0.35-0.6s.
- Sibling stagger: 0.04-0.12s.
- Entrances:
ease-out.
- Exits:
ease-in.
Preset guidance:
fade-in: subtle supporting content.
slide-in: directional reveals, usually 16-48px.
scale-in: cards, product shots, badges, modals.
blur-in: cinematic/editorial reveals.
tilt-in, spin-in, bounce-in, pop-spark: playful or promotional moments.
mask-in, fade-mask-in, slide-mask-in, scale-mask-in: high-impact hero, frame, or title reveals. Use maskStyle: "linear" for clean wipes, "diagonal" for editorial energy, and "iris" for spotlit reveals. Use maskDirection for edge movement and maskOrigin for iris origin.
mask-reveal, iris-reveal: legacy combo aliases that still work, but prefer the explicit mask presets above.
- Exit presets (
fade-out, slide-out, scale-out, etc.) should leave enough reading time before they begin.
Text nodes can use appearBy: "word" or "line" for headline reveals. Use "char" only for kinetic title moments; non-text nodes must use "block".
Example:
apply_animation_plan
mode: "replace"
animations: [
{ nodeId: "<headline-id>", presetId: "fade-in", offset: 0, settings: { duration: 0.55, easing: "ease-out", appearBy: "word" } },
{ nodeId: "<hero-image-id>", presetId: "scale-in", offset: 0.08, settings: { duration: 0.5, easing: "ease-out", scaleFrom: 0.96 } },
{ nodeId: "<cta-id>", presetId: "slide-in", offset: 0.28, settings: { duration: 0.35, easing: "ease-out", direction: "up", distance: 20 } }
]
Images — Search and Use Real Photos
Efecto includes a built-in image search powered by Lummi — a library of free, high-quality stock photos, illustrations, and 3D renders. Use this instead of placeholder images to make designs look polished and real.
The search_images Tool
This tool works without a session — call it anytime, even before creating a session.
search_images
query: "mountain landscape"
orientation: "horizontal"
limit: 4
Returns a list of images with url, thumbnail, alt, width, height, photographer, and orientation.
Filters
| Filter |
Values |
When to Use |
query |
Any search term |
Always — describe what you need ("team working", "abstract gradient", "coffee shop") |
orientation |
horizontal, vertical, square |
Match the layout: horizontal for hero banners, vertical for mobile/stories, square for cards |
type |
photo, illustration, 3d |
Default returns all. Use "photo" for realistic imagery, "illustration" for stylized graphics |
luminance |
dark, neutral, bright |
Match the design mood: "dark" for dark-themed pages, "bright" for light/airy designs |
limit |
1–20 (default: 6) |
Keep low (3–6) to avoid overwhelming context |
Workflow: Search → Apply
Step 1: Search for images
search_images
query: "modern office workspace"
orientation: "horizontal"
luminance: "bright"
limit: 3
Step 2a: Add as an image node
add_node
parentId: "<section-id>"
type: "image"
src: "<url-from-search>"
alt: "Modern office workspace"
className: "w-full h-[400px] rounded-2xl object-cover"
Step 2b: Set as background fill
set_fill
targetId: "<section-id>"
fill: { type: "image", url: "<url-from-search>", size: "cover", position: "center" }
Step 2c: Use in JSX (add_section)
add_section
parentId: "<artboard-id>"
jsx: '<section className="flex items-center gap-16 px-16 py-24 w-full">
<div className="flex flex-col gap-6 grow">
<h1 className="text-5xl font-bold text-gray-900">Our Story</h1>
<p className="text-lg text-gray-500">Building the future of design.</p>
</div>
<img src="<url-from-search>" alt="Team at work" className="w-[560px] h-[380px] rounded-2xl object-cover" />
</section>'
Tips
- Search before designing. Find images first, then build the layout around them. This produces better compositions than adding images as afterthoughts.
- Match orientation to layout. Horizontal images for hero sections, vertical for sidebar/mobile, square for grid cards.
- Use luminance filter. For dark-themed designs, search
luminance: "dark" to get images that blend naturally with dark backgrounds.
- Set
object-cover on image nodes so they fill their container without distortion.
- Prefer real images over placeholders. Instead of
<div className="w-full h-[400px] bg-gray-100 rounded-2xl" />, search for a relevant image and use it.
Shader Nodes & Visual Effects
Shader nodes are a powerful node type that combines generative visuals, image/video processing, and visual effects (ASCII, dither, halftone, glitch, art filters). They render via WebGL and can be placed anywhere in the design like any other node.
Creating a Shader Node
Use add_node with type: "shader":
add_node
parentId: "<artboard-id>"
type: "shader"
shaderType: "meshGradient"
className: "w-full h-[400px] rounded-2xl"
Input Sources
| Input Type |
Description |
Key Properties |
shader (default) |
Generative WebGL visuals |
shaderType, shaderSettings |
image |
Process an image through effects |
mediaInput: { mediaUrl, mediaType: "image", objectFit } |
video |
Process a video through effects |
mediaInput: { mediaUrl, mediaType: "video" } |
fill |
Solid color through effects |
fillColor: "#hex" |
Generative Shader Types (11)
| Shader |
Description |
Best For |
meshGradient |
Smooth organic color blending |
Hero backgrounds, ambient visuals |
dotGrid |
Animated dot grid pattern |
Tech/data aesthetics |
voronoi |
Cell-based organic pattern |
Abstract textures |
liquidMetal |
Metallic fluid simulation |
Premium/luxury visuals |
chrome |
Chrome reflection effect |
Bold, reflective accents |
pulsar |
Radial pulsing energy |
Dynamic, attention-grabbing |
blackHole |
Gravitational distortion |
Dramatic dark visuals |
glass |
Frosted glass refraction |
Subtle, elegant overlays |
spiral |
Spiraling motion pattern |
Hypnotic, playful |
particles |
Floating particle system |
Ambient, atmospheric |
fireworks |
Exploding particle bursts |
Celebration, energy |
Visual Effects (28)
Apply effects on top of any input source. Set effectId and effectEnabled: true:
add_node
parentId: "<section-id>"
type: "shader"
inputType: "image"
mediaInput: { mediaUrl: "<image-url>", mediaType: "image", objectFit: "cover" }
effectId: "ascii-standard"
effectEnabled: true
className: "w-full h-[500px] rounded-2xl"
| Category |
Effect IDs |
Description |
| ASCII |
ascii-standard, ascii-dense, ascii-minimal, ascii-blocks, ascii-braille, ascii-technical, ascii-matrix, ascii-hatching |
Convert visuals to ASCII character art |
| Dither |
dither-floyd-steinberg, dither-atkinson, dither-stucki, dither-sierra, dither-sierra-lite, dither-burkes, dither-jarvis-judice-ninke, dither-two-row-sierra, color-separation |
Retro dithering patterns |
| Halftone |
halftone-mono, halftone-cmyk |
Print-style dot patterns (mono or CMYK) |
| Glitch |
glitch-vhs, glitch-digital, glitch-weird, glitch-chromatic |
Digital corruption and distortion |
| Art |
art-kuwahara, art-crosshatch, art-lineart, art-engraving, art-stipple |
Painterly and sketch-style filters |
Post-Process Stack
Layer additional effects with postProcesses: scanlines, vignette, bloom, grain, noise, pixelate, wave, rgb-glitch, brightness-contrast, color-tint, sepia, grid, dot-screen, light-beams, warp, motion-blur, chromatic-aberration, curvature.
postProcesses: [
{ type: "grain", enabled: true, settings: { intensity: 0.3 } },
{ type: "vignette", enabled: true, settings: { intensity: 0.5 } }
]
Common Recipes
ASCII art hero from an image:
search_images query: "city skyline" orientation: "horizontal" limit: 1
add_node
parentId: "<artboard-id>"
type: "shader"
inputType: "image"
mediaInput: { mediaUrl: "<url>", mediaType: "image", objectFit: "cover" }
effectId: "ascii-standard"
effectEnabled: true
className: "w-full h-[500px]"
Generative gradient background:
add_node
parentId: "<artboard-id>"
type: "shader"
shaderType: "meshGradient"
className: "w-full h-[600px]"
Halftone effect on a photo:
add_node
parentId: "<section-id>"
type: "shader"
inputType: "image"
mediaInput: { mediaUrl: "<url>", mediaType: "image", objectFit: "cover" }
effectId: "halftone-mono"
effectEnabled: true
className: "w-[400px] h-[400px] rounded-2xl"
Node Types & HTML Tags
Every node maps 1:1 to an HTML element. The type determines behavior; the tag determines which HTML element renders.
| Type |
Default Tag |
All Valid Tags |
Content Property |
| frame |
div |
div, section, article, aside, main, nav, header, footer, ul, ol, li, figure, figcaption, form, table, thead, tbody, tr, th, td |
(none — pure container) |
| text |
p |
p, span, h1, h2, h3, h4, h5, h6, blockquote, label, li |
textContent |
| image |
img |
img |
src, alt, objectFit |
| button |
button |
button, a, div |
textContent, variant |
| link |
a |
a, button, div, span |
textContent, href, target |
| icon |
svg |
svg |
iconName (kebab-case), iconLibrary, iconWeight |
| input |
input |
input, textarea, select |
placeholder, inputType, label |
| video |
video |
video |
src, poster, autoPlay, loop, muted |
| shader |
(WebGL) |
— |
shaderType, inputType, effectId, effectEnabled, effectSettings, postProcesses |
| component |
div |
div |
componentId, overrides |
Tag Determines Type in JSX
When writing JSX for add_section, the HTML tag determines the node type:
<div> -> frame <img> -> image
<section> -> frame <button> -> button
<nav> -> frame <a> -> link
<header> -> frame <input> -> input
<footer> -> frame <video> -> video
<h1>-<h6> -> text <svg> -> icon
<p> -> text <i> -> icon
<span> -> text <Icon> -> icon
<HeartIcon> -> icon (name resolved from tag)
The add_section JSX Format
This is the primary way to build layouts. Write standard JSX with HTML tags and Tailwind className attributes.
Format Rules
- Use HTML tags — div, section, nav, h1, p, img, button, a, etc.
- Style with className — Tailwind CSS classes only
- Text goes between tags —
<h1 className="...">Hello</h1>
- Images are self-closing —
<img src="https://..." alt="..." className="..." />
- Use
data-id only when referencing existing nodes (from get_document)
- No React-specific syntax — no
onClick, useState, fragments, or components
- Icons use
<svg> with the icon attribute — <svg icon="arrow-right" className="w-5 h-5 text-gray-600" />
Example: Complete Section
<section className="flex flex-col items-center gap-12 px-16 py-24 bg-white w-full">
<div className="flex flex-col items-center gap-4 max-w-2xl">
<span className="text-sm font-semibold text-blue-600 uppercase tracking-widest">Why Choose Us</span>
<h2 className="text-4xl font-bold text-gray-900 text-center">Everything you need to scale</h2>
<p className="text-lg text-gray-500 text-center">Built for modern teams that move fast and ship faster.</p>
</div>
<div className="flex gap-8 w-full max-w-5xl">
<div className="flex flex-col gap-3 p-8 bg-gray-50 rounded-2xl grow">
<svg icon="lightning" className="w-8 h-8 text-blue-600" />
<h3 className="text-lg font-semibold text-gray-900">Lightning Fast</h3>
<p className="text-sm text-gray-500">Deploy in seconds, not hours. Our edge network ensures sub-50ms latency worldwide.</p>
</div>
<div className="flex flex-col gap-3 p-8 bg-gray-50 rounded-2xl grow">
<svg icon="shield-check" className="w-8 h-8 text-blue-600" />
<h3 className="text-lg font-semibold text-gray-900">Enterprise Security</h3>
<p className="text-sm text-gray-500">SOC 2 certified with end-to-end encryption. Your data stays yours.</p>
</div>
<div className="flex flex-col gap-3 p-8 bg-gray-50 rounded-2xl grow">
<svg icon="headset" className="w-8 h-8 text-blue-600" />
<h3 className="text-lg font-semibold text-gray-900">24/7 Support</h3>
<p className="text-sm text-gray-500">Our team is always on. Get answers in minutes, not days.</p>
</div>
</div>
</section>
Icons
Efecto supports 4 icon libraries with ~9,400 icons total. Icons render as SVG and inherit color from currentColor.
How to Write Icons in JSX
The canonical format:
<svg icon="arrow-right" className="w-5 h-5 text-gray-600" />
icon — Icon name in kebab-case (e.g. arrow-right, magnifying-glass, google-logo)
className — Size via w-* / h-*, color via text-* classes
iconLibrary — Optional: phosphor (default), lucide, heroicons, radix
iconWeight — Optional: thin, light, regular (default), bold, fill, duotone (Phosphor only)
Common Icon Names (Phosphor — default library)
| Category |
Icons |
| Arrows |
arrow-right, arrow-left, arrow-up, arrow-down, caret-right, caret-down |
| Actions |
check, x, plus, minus, magnifying-glass, funnel, pencil, trash |
| UI |
gear, sliders, dots-three, list, squares-four, sidebar |
| Social |
google-logo, apple-logo, github-logo, x-logo, linkedin-logo, discord-logo, facebook-logo, instagram-logo, youtube-logo |
| Objects |
envelope, lock, eye, eye-slash, star, heart, user, users, house, lightning, fire, rocket |
| Media |
image, camera, play, pause, microphone, speaker-high |
| Commerce |
shopping-cart, credit-card, currency-dollar, receipt, package |
Icon Sizing Guide
w-3 h-3 /* 12px — tiny, inline indicators */
w-4 h-4 /* 16px — inline with small text */
w-5 h-5 /* 20px — standard UI icon */
w-6 h-6 /* 24px — default, comfortable */
w-8 h-8 /* 32px — feature icons, cards */
w-10 h-10 /* 40px — hero feature icons */
w-12 h-12 /* 48px — large decorative */
w-16 h-16 /* 64px — hero section centerpiece */
Icon Patterns in Sections
Feature card with icon:
<div className="flex flex-col gap-3 p-8 bg-gray-50 rounded-2xl grow">
<svg icon="lightning" className="w-8 h-8 text-blue-600" />
<h3 className="text-lg font-semibold text-gray-900">Lightning Fast</h3>
<p className="text-sm text-gray-500">Deploy in seconds, not hours.</p>
</div>
Button with icon (icons are siblings, not children):
<div className="flex items-center gap-2 bg-gray-900 text-white px-5 py-2.5 rounded-lg">
<span className="text-sm font-medium">Get Started</span>
<svg icon="arrow-right" className="w-4 h-4" />
</div>
Social icons row:
<div className="flex items-center gap-4">
<svg icon="x-logo" className="w-5 h-5 text-gray-400" />
<svg icon="github-logo" className="w-5 h-5 text-gray-400" />
<svg icon="linkedin-logo" className="w-5 h-5 text-gray-400" />
<svg icon="discord-logo" className="w-5 h-5 text-gray-400" />
</div>
Input with icon:
<div className="flex items-center gap-2 border border-gray-200 rounded-lg px-3 py-2 bg-white">
<svg icon="magnifying-glass" className="w-4 h-4 text-gray-400" />
<input placeholder="Search..." className="text-sm text-gray-900 grow" />
</div>
Using a different library (Lucide):
<svg icon="check" iconLibrary="lucide" className="w-5 h-5 text-green-600" />
Using a weight variant (Phosphor bold):
<svg icon="star" iconWeight="fill" className="w-5 h-5 text-yellow-500" />
Tailwind CSS Patterns That Work
Layout
flex /* Horizontal flex row */
flex flex-col /* Vertical flex column */
items-center /* Center cross-axis */
items-start /* Align to start */
justify-between /* Space between children */
justify-center /* Center main-axis */
gap-2 gap-4 gap-8 /* Gap between flex children */
grow /* Fill remaining space (DO NOT use flex-1) */
Spacing
p-4 p-6 p-8 p-12 /* Padding all sides */
px-6 py-4 /* Horizontal / vertical padding */
pt-8 pb-16 /* Top / bottom padding */
mx-auto /* Center horizontally */
Sizing
w-full /* Full width of parent */
w-auto /* Width from content */
w-fit /* Shrink-wrap width */
w-[600px] /* Fixed pixel width */
max-w-2xl max-w-5xl /* Maximum width constraints */
min-h-screen /* Minimum full viewport height */
h-[400px] /* Fixed pixel height */
Typography
text-xs text-sm text-base text-lg text-xl text-2xl text-3xl text-4xl text-5xl text-6xl text-7xl text-8xl text-9xl
font-light font-normal font-medium font-semibold font-bold font-extrabold font-black
leading-tight leading-snug leading-normal leading-relaxed
tracking-tight tracking-normal tracking-wide tracking-widest
text-left text-center text-right
uppercase lowercase capitalize
Theme-Aware Colors (Preferred)
Efecto supports a semantic token system. When a theme is active, these classes auto-adapt to light/dark/custom modes:
/* Backgrounds */
bg-background /* Page/artboard background */
bg-card /* Card surfaces */
bg-popover /* Popover/dropdown surfaces */
bg-primary /* Primary action backgrounds */
bg-secondary /* Secondary surfaces */
bg-muted /* Muted/subtle backgrounds */
bg-accent /* Accent highlights */
bg-destructive /* Destructive/error backgrounds */
bg-input /* Input field backgrounds */
/* Text */
text-foreground /* Primary text */
text-primary-foreground /* Text on primary backgrounds */
text-secondary-foreground /* Text on secondary surfaces */
text-muted-foreground /* Muted/secondary text */
text-accent-foreground /* Text on accent backgrounds */
text-card-foreground /* Text on cards */
text-popover-foreground /* Text on popovers */
text-destructive-foreground /* Text on destructive backgrounds */
/* Borders */
border-border /* Default border color */
ring-ring /* Focus ring color */
When to use semantic vs hardcoded colors:
- Semantic (
bg-primary, text-foreground): UI components, buttons, cards, text — anything that should adapt with theme/mode changes
- Hardcoded (
bg-blue-500, text-white): Decorative elements, brand-specific colors, illustrations, gradients
These classes map to CSS custom properties (--background, --primary, etc.) and automatically update when the theme or mode changes. shadcn is the default token system, but these are standard CSS variables — any design system that provides them will work.
Colors (NAMED ONLY)
Use named Tailwind colors. Never use arbitrary hex like bg-[#f9f9f9] — it silently fails at runtime.
/* Backgrounds */
bg-white bg-black bg-gray-50 bg-gray-100 bg-gray-900 bg-neutral-950
bg-blue-50 bg-blue-500 bg-blue-600 bg-indigo-500 bg-purple-500
bg-green-50 bg-green-500 bg-red-50 bg-red-500 bg-amber-50 bg-yellow-400
/* Text */
text-white text-black text-gray-400 text-gray-500 text-gray-600 text-gray-700 text-gray-900
text-blue-600 text-blue-500 text-indigo-600 text-green-600 text-red-600
/* Borders */
border-gray-100 border-gray-200 border-gray-300 border-blue-500
/* If you MUST use a specific hex color, use inline style instead: */
style: { "background-color": "#f9f9f9" }
Borders & Radius
border border-2 /* Border width */
border-gray-200 border-gray-300 /* Border color */
rounded rounded-lg rounded-xl rounded-2xl rounded-full /* Border radius */
Effects
shadow-sm shadow shadow-md shadow-lg shadow-xl
opacity-50 opacity-75
ring-1 ring-2 ring-blue-500 /* Ring / outline */
Gradients
bg-gradient-to-r from-blue-500 to-purple-500
bg-gradient-to-b from-white to-gray-50
bg-gradient-to-br from-indigo-500 via-purple-500 to-pink-500
Fills (Preferred: set_fill tool)
For solid colors, gradients, and image backgrounds, prefer the set_fill tool over manually setting className/style. It handles the dual-write pattern automatically.
# Solid color
set_fill targetId: "<id>" fill: { type: "solid", color: "blue-500" }
# Linear gradient
set_fill targetId: "<id>" fill: { type: "gradient", gradient: { type: "linear", angle: 90, stops: [{ color: "#3b82f6", position: 0 }, { color: "#8b5cf6", position: 1 }] } }
# Radial gradient
set_fill targetId: "<id>" fill: { type: "gradient", gradient: { type: "radial", stops: [{ color: "#3b82f6", position: 0 }, { color: "#1e1b4b", position: 1 }] } }
# Image fill
set_fill targetId: "<id>" fill: { type: "image", url: "https://...", size: "cover", position: "center" }
# Clear fill
set_fill targetId: "<id>"
Works on both nodes and artboards. For artboards, solid fills update backgroundColor for backward compatibility.
Links & Anchors
Any node can be made clickable with the link property on add_node, update_node, or batch_update. Use elementId to make a node an anchor target.
| Link Type |
Use Case |
Required Fields |
url |
External URL |
url, optional target: "_blank" |
page |
Navigate to another artboard |
pageId (artboard ID) |
section |
Scroll to element anchor |
sectionId (matches an elementId) |
email |
mailto link |
email |
phone |
tel link |
phone |
# Make a button link to an external URL
update_node nodeId: "<btn-id>" link: { type: "url", url: "https://example.com", target: "_blank" }
# Mark a section as an anchor target
update_node nodeId: "<section-id>" elementId: "pricing"
# Link a nav item to that anchor
update_node nodeId: "<nav-link-id>" link: { type: "section", sectionId: "pricing" }
# Link to another artboard (page navigation)
update_node nodeId: "<link-id>" link: { type: "page", pageId: "<artboard-id>" }
# Remove a link
update_node nodeId: "<id>" link: null
Works on any node type — frames, text, images, buttons. For published sites, page and section links become real navigation.
Artboard Best Practices
Standard Sizes
| Name |
Width |
Height |
Use Case |
| Desktop |
1440 |
900+ |
Full website pages |
| Desktop (narrow) |
1280 |
800+ |
Content-focused pages |
| Tablet |
768 |
1024 |
Tablet responsive view |
| Mobile |
375 |
812 |
iPhone / mobile view |
Always Start With
create_artboard:
name: "Homepage"
width: 1440
height: 900
backgroundColor: "#ffffff"
className: "flex flex-col"
className: "flex flex-col" is essential — without it, children overlap at (0,0)
backgroundColor is an inline style property, NOT a Tailwind class
- Height grows automatically when content overflows, but set an initial height
Common Section Patterns
Navigation Bar
<nav className="flex items-center justify-between px-16 py-5 bg-white w-full border-b border-gray-100">
<h2 className="text-xl font-bold text-gray-900">Acme</h2>
<div className="flex items-center gap-8">
<a className="text-sm font-medium text-gray-600" href="#">Features</a>
<a className="text-sm font-medium text-gray-600" href="#">Pricing</a>
<a className="text-sm font-medium text-gray-600" href="#">About</a>
<button className="px-5 py-2.5 text-sm font-medium text-white bg-gray-900 rounded-lg">Get Started</button>
</div>
</nav>
Hero Section (Centered)
<section className="flex flex-col items-center justify-center gap-8 px-16 py-32 bg-white w-full">
<div className="flex flex-col items-center gap-6 max-w-3xl">
<span className="px-4 py-1.5 text-xs font-semibold text-blue-700 bg-blue-50 rounded-full uppercase tracking-wider">Now in Beta</span>
<h1 className="text-6xl font-bold text-gray-900 text-center leading-tight">Build beautiful websites at the speed of thought</h1>
<p className="text-xl text-gray-500 text-center">The AI-powered design tool that turns ideas into production-ready pages. No code required.</p>
</div>
<div className="flex items-center gap-4">
<button className="px-8 py-3.5 text-base font-semibold text-white bg-blue-600 rounded-xl">Start Free Trial</button>
<button className="px-8 py-3.5 text-base font-semibold text-gray-700 bg-white border-2 border-gray-200 rounded-xl">Watch Demo</button>
</div>
</section>
Hero Section (Split — Text Left, Image Right)
<section className="flex items-center gap-16 px-16 py-24 bg-white w-full">
<div className="flex flex-col gap-6 grow">
<h1 className="text-5xl font-bold text-gray-900 leading-tight">Ship your next product in record time</h1>
<p className="text-lg text-gray-500">From prototype to production in minutes. Our platform handles the complexity so you can focus on what matters.</p>
<div className="flex items-center gap-4">
<button className="px-6 py-3 text-base font-semibold text-white bg-gray-900 rounded-lg">Get Started</button>
<a className="text-base font-medium text-gray-600" href="#">Learn more</a>
</div>
</div>
<img src="https://placehold.co/600x400" alt="Product screenshot" className="w-[560px] h-[380px] rounded-2xl object-cover bg-gray-100" />
</section>
Feature Grid (3 columns)
<section className="flex flex-col items-center gap-16 px-16 py-24 bg-gray-50 w-full">
<div className="flex flex-col items-center gap-4 max-w-2xl">
<h2 className="text-4xl font-bold text-gray-900 text-center">Powerful features for modern teams</h2>
<p className="text-lg text-gray-500 text-center">Everything you need to design, build, and ship — all in one place.</p>
</div>
<div className="flex gap-8 w-full max-w-6xl">
<div className="flex flex-col gap-4 p-8 bg-white rounded-2xl shadow-sm grow">
<div className="flex items-center justify-center w-12 h-12 bg-blue-100 rounded-xl">
<span className="text-blue-600 text-lg font-bold">1</span>
</div>
<h3 className="text-xl font-semibold text-gray-900">Real-Time Collaboration</h3>
<p className="text-sm text-gray-500 leading-relaxed">Work together with your team in real time. See cursors, selections, and changes as they happen.</p>
</div>
<div className="flex flex-col gap-4 p-8 bg-white rounded-2xl shadow-sm grow">
<div className="flex items-center justify-center w-12 h-12 bg-green-100 rounded-xl">
<span className="text-green-600 text-lg font-bold">2</span>
</div>
<h3 className="text-xl font-semibold text-gray-900">One-Click Deploy</h3>
<p className="text-sm text-gray-500 leading-relaxed">Push to production with a single click. Built-in CI/CD, preview deployments, and rollbacks.</p>
</div>
<div className="flex flex-col gap-4 p-8 bg-white rounded-2xl shadow-sm grow">
<div className="flex items-center justify-center w-12 h-12 bg-purple-100 rounded-xl">
<span className="text-purple-600 text-lg font-bold">3</span>
</div>
<h3 className="text-xl font-semibold text-gray-900">AI Assistant</h3>
<p className="text-sm text-gray-500 leading-relaxed">Built-in AI that understands your codebase. Generate components, fix bugs, and refactor with natural language.</p>
</div>
</div>
</section>
Testimonial / Social Proof
<section className="flex flex-col items-center gap-12 px-16 py-24 bg-white w-full">
<div className="flex flex-col items-center gap-6 max-w-2xl">
<p className="text-2xl text-gray-700 text-center leading-relaxed italic">"This tool completely transformed our workflow. We shipped our redesign in two weeks instead of two months."</p>
<div className="flex items-center gap-4">
<div className="w-12 h-12 bg-gray-200 rounded-full"></div>
<div className="flex flex-col">
<span className="text-sm font-semibold text-gray-900">Sarah Chen</span>
<span className="text-sm text-gray-500">VP of Design, Stripe</span>
</div>
</div>
</div>
<div className="flex items-center gap-12">
<span className="text-sm font-medium text-gray-400">Trusted by</span>
<span className="text-lg font-bold text-gray-300">Stripe</span>
<span className="text-lg font-bold text-gray-300">Vercel</span>
<span className="text-lg font-bold text-gray-300">Linear</span>
<span className="text-lg font-bold text-gray-300">Notion</span>
<span className="text-lg font-bold text-gray-30
…(truncated)
1---2name: efecto-web-design3description: Design web pages and app UIs with Efecto — create sessions, build layouts with JSX and Tailwind CSS, manage artboards, and push real-time design changes via MCP tools. Use when asked to "design a page", "build a landing page", "create a website", "design a dashboard", "make a UI", or any visual design task. Requires Efecto MCP server.4metadata:5 source: https://skillmd.com/skills/pablostanley/efecto-web-design6 mcp-server: efecto7 author: pablostanley8 version: "1.0.0"9 argument-hint: <design-description>10---1112# Efecto — Design Web Pages with AI1314Efecto is a real-time web design tool that AI agents control programmatically. You create a **session**, the user opens a URL in their browser, and you push design commands that render instantly. Every node maps to a real HTML element styled with Tailwind CSS — web-native, semantic, and pixel-accurate.1516---1718## Setup1920This skill requires the **Efecto MCP server**. Check if it's available by looking for tools like `create_session`, `add_section`, or `get_document` in your tool list.2122**If Efecto tools are NOT available, install the MCP server:**2324### Claude Code25```bash26claude mcp add efecto -- npx -y @efectoapp/mcp27```2829### Cursor30Add to `.cursor/mcp.json`:31```json32{33 "mcpServers": {34 "efecto": {35 "command": "npx",36 "args": ["-y", "@efectoapp/mcp"]37 }38 }39}40```4142### Windsurf / VS Code / Other MCP Clients43```json44{45 "mcpServers": {46 "efecto": {47 "command": "npx",48 "args": ["-y", "@efectoapp/mcp"]49 }50 }51}52```5354Once installed, you'll have access to 68 MCP tools, including image search and native animation authoring. The MCP server connects your agent to the Efecto design canvas at [efecto.app](https://efecto.app).5556---5758## How Sessions Work5960```61Agent ──POST /execute──> Server ──SSE──> Browser (renders live)62Agent <──poll/response── Server <──POST── Browser (returns results)63```64651. You create a session via the MCP server or REST API662. The user opens the returned Efecto URL in their browser673. You push tool calls — each one executes in the browser and returns a result684. The user sees every change live as you build the design6970Sessions expire after 2 hours of inactivity. The browser must be connected before tool calls can execute. If you restart or lose the MCP process, call `attach_session` with the user's current Efecto URL instead of creating a duplicate session.7172---7374## Quick Start — Build a Page in 7 Steps7576### Step 1: Create a Session77```78create_session79 label: "Landing page design"80```81Returns `{ sessionId, documentId, designUrl }`. Tell the user to open the URL. The session ID is stored automatically — all subsequent tools use it.8283If the user already has an Efecto URL with `?session=...`, resume it:84```85attach_session86 designUrl: "https://efecto.app/design/<file-id>/untitled?session=<session-id>"87```8889**Do not call `create_session` again to "reconnect".** Use `attach_session` for an existing URL. A second `create_session` call refuses to overwrite a paired session unless you pass `force: true`.9091### Step 2: Wait for Browser Connection92```93wait_for_connection94```95Blocks until the browser opens the URL and pairs (default 120s). Returns immediately if already paired.9697To inspect routing state at any time:98```99session_status # legacy single-session shape (sessionId, paired, browserConnected, knownSessions)100session_status { all: true } # list shape — all sessions in this MCP process with isActive / paired flags101```102103### Step 3: Create an Artboard104```105create_artboard106 name: "Homepage"107 width: 1440108 height: 900109 backgroundColor: "#ffffff"110 className: "flex flex-col"111```112Returns the artboard ID. **Always set className to "flex flex-col"** so children stack vertically.113114### Step 4: Add Sections with JSX115```116add_section117 parentId: "<artboard-id>"118 jsx: '<nav name="Primary Navigation" className="flex items-center justify-between px-16 py-5 bg-white w-full">119 <h2 name="Brand Name" className="text-xl font-bold text-gray-900">Acme</h2>120 <div name="Navigation Links" className="flex items-center gap-8">121 <a name="Features Link" className="text-sm text-gray-600" href="#">Features</a>122 <a name="Pricing Link" className="text-sm text-gray-600" href="#">Pricing</a>123 <button name="Get Started Button" className="px-4 py-2 text-sm font-medium text-white bg-gray-900 rounded-lg">Get Started</button>124 </div>125 </nav>'126```127This is the most efficient way to build complex layouts — one JSX string per section.128129### Step 5: Read Current State130```131get_document132```133Returns JSX-like markup with `data-id` attributes on every node. Use these IDs for updates.134135### Step 6: Fine-Tune with Updates136```137batch_update138 updates: [139 { nodeId: "abc", className: "text-2xl font-extrabold text-gray-900" },140 { nodeId: "def", textContent: "Updated heading text" }141 ]142```143144### Step 7: Iterate145Repeat Steps 4-6 to add more sections, adjust styling, and refine the design. The user sees every change in real time.146147---148149## The Design Tools150151### Reading State152153| Tool | Purpose |154|------|---------|155| `get_selection` | Returns currently selected nodes/artboards with JSX subtrees |156| `get_document` | Returns document as JSX. Scoped modes (preferred on large docs): `outline: true` (one-line summary per top-level child), `artboardId` (single artboard), `maxDepth` (cap descent; 0 = artboard header only, 1 = top-level children only). Response includes an approx-token count. |157| `list_artboards` | Lists all artboards with IDs, names, dimensions |158| `find_nodes` | Search nodes by name, text content, type, or className. Returns IDs without subtree — use this to locate before calling `get_node_tree`. |159| `get_node_tree` | Serializes one node/artboard subtree only — drill in after `outline` or `find_nodes`. |160161### Creating Content162163| Tool | Purpose |164|------|---------|165| `create_artboard` | Creates a new artboard (screen/frame) |166| `add_section` | Adds complex layouts from JSX markup (preferred) |167| `add_node` | Adds a single node to a parent |168169### Modifying Content170171| Tool | Purpose |172|------|---------|173| `update_node` | Updates any node property (className, textContent, tag, style, src, link, elementId, etc.) |174| `update_class` | Shortcut: replaces only className on a node |175| `update_artboard` | Updates artboard properties (name, size, background, className, `timelineDuration`) |176| `batch_update` | Updates multiple nodes in one call (bulk styling) |177| `replace_section` | Replaces a node and its children with new JSX |178179### Animation180181| Tool | Purpose |182|------|---------|183| `list_animation_presets` | Lists native Efecto animation presets with ids, categories, defaults, and supported controls |184| `apply_animation_plan` | Applies a validated multi-layer animation plan in one call |185| `clear_animations` | Clears native animations from nodes, the selection, an artboard, or the whole document |186187### Organizing Structure188189| Tool | Purpose |190|------|---------|191| `move_node` | Reparents or reorders a node |192| `duplicate_node` | Deep-clones a node with fresh IDs |193| `duplicate_artboard` | Deep-clones an artboard for variations |194| `group_nodes` | Wraps selected nodes in a frame container |195| `ungroup_node` | Unwraps a group, moving children to parent |196| `reorder_node` | Brings to front or sends to back (z-order) |197198### Display & Selection199200| Tool | Purpose |201|------|---------|202| `select_nodes` | Highlights nodes for the user to see |203| `set_visibility` | Shows/hides nodes (like Figma eye icon) |204| `delete_nodes` | Deletes nodes and their children |205| `delete_artboard` | Deletes an artboard and all contents |206207### Alignment & Distribution208209| Tool | Purpose |210|------|---------|211| `align_nodes` | Aligns multiple nodes (left/center/right/top/middle/bottom) |212| `distribute_nodes` | Distributes nodes evenly (horizontal/vertical) |213214### History215216| Tool | Purpose |217|------|---------|218| `undo` | Undoes the last action (Cmd+Z) |219| `redo` | Redoes the last undone action (Cmd+Shift+Z) |220221### Viewport & Document222223| Tool | Purpose |224|------|---------|225| `zoom_to_artboard` | Zooms viewport to show a specific artboard |226| `zoom_to_fit` | Zooms to fit all artboards in the viewport |227| `set_viewport` | Sets viewport zoom level and/or pan position |228| `rename_document` | Renames the document |229| `new_document` | Creates a new blank document (replaces current) |230231### Canvas & Reading232233| Tool | Purpose |234|------|---------|235| `move_artboard` | Repositions an artboard on the canvas for multi-screen flows |236| `deselect_all` | Clears the current node selection |237| `get_node_tree` | Returns JSX for one node/artboard subtree (faster than full document) |238239### Fill & Export240241| Tool | Purpose |242|------|---------|243| `set_fill` | Sets the fill (background) of a node or artboard — solid color, gradient, or image. Handles dual-write automatically. |244| `export_image` | Exports an artboard or node as an image (PNG, JPEG, WebP, SVG). Returns base64 data URL. |245246### Theme247248| Tool | Purpose |249|------|---------|250| `get_theme` | Returns the current theme tokens (colors, fonts, radii) and active mode |251| `set_theme` | Sets theme tokens — colors, fonts, border radii. Accepts partial updates. |252| `set_theme_mode` | Switches between light/dark/custom modes |253| `reset_theme` | Resets theme to defaults |254255### Design Validation256257| Tool | Purpose |258|------|---------|259| `audit_design` | Audits design against professional quality rules: typography (scale, weight contrast, sizing), color (neutral consistency, pure black, low-contrast combos), spacing (4pt grid, touch targets), and AI slop detection (monotonous layouts). Pass `artboardId` for one artboard or omit for all. |260| `repair_design` | Applies safe, deterministic fixes across the document (or one artboard) in one pass: missing w-full, missing flex, arbitrary Tailwind values → inline styles, pure black → zinc-950, touch-target bumps, placeholder images, empty text defaults. Pass `dryRun: true` to preview. |261262### Image Search263264| Tool | Purpose |265|------|---------|266| `search_images` | Search for free stock images (Lummi). No session required. Returns URLs to use with `add_node` or `set_fill`. |267268---269270## Native Animation — Animate Existing Designs271272Efecto has a native layer animation system. Do **not** use Tailwind `animate-*`, `transition-*`, or `duration-*` classes as the animation authoring path.273274Workflow for "animate this":2752761. Inspect the target with `get_selection`, `get_document`, `get_node_tree`, or `list_artboards`.2772. Call `list_animation_presets` to see supported preset IDs and settings.2783. Pick the meaningful layers: hero image, headline, supporting copy, CTA, cards, icons, or product visuals. Avoid animating every nested child.2794. Call `apply_animation_plan` with timed entries. Use `mode: "replace"` for a new motion system or `mode: "append"` to add exit/outro animations.2805. Set `timelineDuration` with `update_artboard` when the artboard needs a deliberate playback end.2816. Use `select_nodes` to highlight the changed layers.282283Timing defaults:284285- Small UI elements: 0.18-0.35s.286- Hero/slide elements: 0.35-0.6s.287- Sibling stagger: 0.04-0.12s.288- Entrances: `ease-out`.289- Exits: `ease-in`.290291Preset guidance:292293- `fade-in`: subtle supporting content.294- `slide-in`: directional reveals, usually 16-48px.295- `scale-in`: cards, product shots, badges, modals.296- `blur-in`: cinematic/editorial reveals.297- `tilt-in`, `spin-in`, `bounce-in`, `pop-spark`: playful or promotional moments.298- `mask-in`, `fade-mask-in`, `slide-mask-in`, `scale-mask-in`: high-impact hero, frame, or title reveals. Use `maskStyle: "linear"` for clean wipes, `"diagonal"` for editorial energy, and `"iris"` for spotlit reveals. Use `maskDirection` for edge movement and `maskOrigin` for iris origin.299- `mask-reveal`, `iris-reveal`: legacy combo aliases that still work, but prefer the explicit mask presets above.300- Exit presets (`fade-out`, `slide-out`, `scale-out`, etc.) should leave enough reading time before they begin.301302Text nodes can use `appearBy: "word"` or `"line"` for headline reveals. Use `"char"` only for kinetic title moments; non-text nodes must use `"block"`.303304Example:305306```307apply_animation_plan308 mode: "replace"309 animations: [310 { nodeId: "<headline-id>", presetId: "fade-in", offset: 0, settings: { duration: 0.55, easing: "ease-out", appearBy: "word" } },311 { nodeId: "<hero-image-id>", presetId: "scale-in", offset: 0.08, settings: { duration: 0.5, easing: "ease-out", scaleFrom: 0.96 } },312 { nodeId: "<cta-id>", presetId: "slide-in", offset: 0.28, settings: { duration: 0.35, easing: "ease-out", direction: "up", distance: 20 } }313 ]314```315316---317318## Images — Search and Use Real Photos319320Efecto includes a built-in image search powered by Lummi — a library of free, high-quality stock photos, illustrations, and 3D renders. **Use this instead of placeholder images** to make designs look polished and real.321322### The `search_images` Tool323324This tool works **without a session** — call it anytime, even before creating a session.325326```327search_images328 query: "mountain landscape"329 orientation: "horizontal"330 limit: 4331```332333Returns a list of images with `url`, `thumbnail`, `alt`, `width`, `height`, `photographer`, and `orientation`.334335### Filters336337| Filter | Values | When to Use |338|--------|--------|-------------|339| `query` | Any search term | Always — describe what you need ("team working", "abstract gradient", "coffee shop") |340| `orientation` | `horizontal`, `vertical`, `square` | Match the layout: horizontal for hero banners, vertical for mobile/stories, square for cards |341| `type` | `photo`, `illustration`, `3d` | Default returns all. Use "photo" for realistic imagery, "illustration" for stylized graphics |342| `luminance` | `dark`, `neutral`, `bright` | Match the design mood: "dark" for dark-themed pages, "bright" for light/airy designs |343| `limit` | 1–20 (default: 6) | Keep low (3–6) to avoid overwhelming context |344345### Workflow: Search → Apply346347**Step 1: Search for images**348```349search_images350 query: "modern office workspace"351 orientation: "horizontal"352 luminance: "bright"353 limit: 3354```355356**Step 2a: Add as an image node**357```358add_node359 parentId: "<section-id>"360 type: "image"361 src: "<url-from-search>"362 alt: "Modern office workspace"363 className: "w-full h-[400px] rounded-2xl object-cover"364```365366**Step 2b: Set as background fill**367```368set_fill369 targetId: "<section-id>"370 fill: { type: "image", url: "<url-from-search>", size: "cover", position: "center" }371```372373**Step 2c: Use in JSX (add_section)**374```375add_section376 parentId: "<artboard-id>"377 jsx: '<section className="flex items-center gap-16 px-16 py-24 w-full">378 <div className="flex flex-col gap-6 grow">379 <h1 className="text-5xl font-bold text-gray-900">Our Story</h1>380 <p className="text-lg text-gray-500">Building the future of design.</p>381 </div>382 <img src="<url-from-search>" alt="Team at work" className="w-[560px] h-[380px] rounded-2xl object-cover" />383 </section>'384```385386### Tips387388- **Search before designing.** Find images first, then build the layout around them. This produces better compositions than adding images as afterthoughts.389- **Match orientation to layout.** Horizontal images for hero sections, vertical for sidebar/mobile, square for grid cards.390- **Use luminance filter.** For dark-themed designs, search `luminance: "dark"` to get images that blend naturally with dark backgrounds.391- **Set `object-cover`** on image nodes so they fill their container without distortion.392- **Prefer real images over placeholders.** Instead of `<div className="w-full h-[400px] bg-gray-100 rounded-2xl" />`, search for a relevant image and use it.393394---395396## Shader Nodes & Visual Effects397398Shader nodes are a powerful node type that combines **generative visuals**, **image/video processing**, and **visual effects** (ASCII, dither, halftone, glitch, art filters). They render via WebGL and can be placed anywhere in the design like any other node.399400### Creating a Shader Node401402Use `add_node` with `type: "shader"`:403404```405add_node406 parentId: "<artboard-id>"407 type: "shader"408 shaderType: "meshGradient"409 className: "w-full h-[400px] rounded-2xl"410```411412### Input Sources413414| Input Type | Description | Key Properties |415|-----------|-------------|----------------|416| `shader` (default) | Generative WebGL visuals | `shaderType`, `shaderSettings` |417| `image` | Process an image through effects | `mediaInput: { mediaUrl, mediaType: "image", objectFit }` |418| `video` | Process a video through effects | `mediaInput: { mediaUrl, mediaType: "video" }` |419| `fill` | Solid color through effects | `fillColor: "#hex"` |420421### Generative Shader Types (11)422423| Shader | Description | Best For |424|--------|-------------|----------|425| `meshGradient` | Smooth organic color blending | Hero backgrounds, ambient visuals |426| `dotGrid` | Animated dot grid pattern | Tech/data aesthetics |427| `voronoi` | Cell-based organic pattern | Abstract textures |428| `liquidMetal` | Metallic fluid simulation | Premium/luxury visuals |429| `chrome` | Chrome reflection effect | Bold, reflective accents |430| `pulsar` | Radial pulsing energy | Dynamic, attention-grabbing |431| `blackHole` | Gravitational distortion | Dramatic dark visuals |432| `glass` | Frosted glass refraction | Subtle, elegant overlays |433| `spiral` | Spiraling motion pattern | Hypnotic, playful |434| `particles` | Floating particle system | Ambient, atmospheric |435| `fireworks` | Exploding particle bursts | Celebration, energy |436437### Visual Effects (28)438439Apply effects on top of any input source. Set `effectId` and `effectEnabled: true`:440441```442add_node443 parentId: "<section-id>"444 type: "shader"445 inputType: "image"446 mediaInput: { mediaUrl: "<image-url>", mediaType: "image", objectFit: "cover" }447 effectId: "ascii-standard"448 effectEnabled: true449 className: "w-full h-[500px] rounded-2xl"450```451452| Category | Effect IDs | Description |453|----------|-----------|-------------|454| **ASCII** | `ascii-standard`, `ascii-dense`, `ascii-minimal`, `ascii-blocks`, `ascii-braille`, `ascii-technical`, `ascii-matrix`, `ascii-hatching` | Convert visuals to ASCII character art |455| **Dither** | `dither-floyd-steinberg`, `dither-atkinson`, `dither-stucki`, `dither-sierra`, `dither-sierra-lite`, `dither-burkes`, `dither-jarvis-judice-ninke`, `dither-two-row-sierra`, `color-separation` | Retro dithering patterns |456| **Halftone** | `halftone-mono`, `halftone-cmyk` | Print-style dot patterns (mono or CMYK) |457| **Glitch** | `glitch-vhs`, `glitch-digital`, `glitch-weird`, `glitch-chromatic` | Digital corruption and distortion |458| **Art** | `art-kuwahara`, `art-crosshatch`, `art-lineart`, `art-engraving`, `art-stipple` | Painterly and sketch-style filters |459460### Post-Process Stack461462Layer additional effects with `postProcesses`: `scanlines`, `vignette`, `bloom`, `grain`, `noise`, `pixelate`, `wave`, `rgb-glitch`, `brightness-contrast`, `color-tint`, `sepia`, `grid`, `dot-screen`, `light-beams`, `warp`, `motion-blur`, `chromatic-aberration`, `curvature`.463464```465postProcesses: [466 { type: "grain", enabled: true, settings: { intensity: 0.3 } },467 { type: "vignette", enabled: true, settings: { intensity: 0.5 } }468]469```470471### Common Recipes472473**ASCII art hero from an image:**474```475search_images query: "city skyline" orientation: "horizontal" limit: 1476add_node477 parentId: "<artboard-id>"478 type: "shader"479 inputType: "image"480 mediaInput: { mediaUrl: "<url>", mediaType: "image", objectFit: "cover" }481 effectId: "ascii-standard"482 effectEnabled: true483 className: "w-full h-[500px]"484```485486**Generative gradient background:**487```488add_node489 parentId: "<artboard-id>"490 type: "shader"491 shaderType: "meshGradient"492 className: "w-full h-[600px]"493```494495**Halftone effect on a photo:**496```497add_node498 parentId: "<section-id>"499 type: "shader"500 inputType: "image"501 mediaInput: { mediaUrl: "<url>", mediaType: "image", objectFit: "cover" }502 effectId: "halftone-mono"503 effectEnabled: true504 className: "w-[400px] h-[400px] rounded-2xl"505```506507---508509## Node Types & HTML Tags510511Every node maps 1:1 to an HTML element. The `type` determines behavior; the `tag` determines which HTML element renders.512513| Type | Default Tag | All Valid Tags | Content Property |514|------|-------------|----------------|-----------------|515| **frame** | `div` | div, section, article, aside, main, nav, header, footer, ul, ol, li, figure, figcaption, form, table, thead, tbody, tr, th, td | (none — pure container) |516| **text** | `p` | p, span, h1, h2, h3, h4, h5, h6, blockquote, label, li | `textContent` |517| **image** | `img` | img | `src`, `alt`, `objectFit` |518| **button** | `button` | button, a, div | `textContent`, `variant` |519| **link** | `a` | a, button, div, span | `textContent`, `href`, `target` |520| **icon** | `svg` | svg | `iconName` (kebab-case), `iconLibrary`, `iconWeight` |521| **input** | `input` | input, textarea, select | `placeholder`, `inputType`, `label` |522| **video** | `video` | video | `src`, `poster`, `autoPlay`, `loop`, `muted` |523| **shader** | (WebGL) | — | `shaderType`, `inputType`, `effectId`, `effectEnabled`, `effectSettings`, `postProcesses` |524| **component** | `div` | div | `componentId`, `overrides` |525526### Tag Determines Type in JSX527528When writing JSX for `add_section`, the HTML tag determines the node type:529530```531<div> -> frame <img> -> image532<section> -> frame <button> -> button533<nav> -> frame <a> -> link534<header> -> frame <input> -> input535<footer> -> frame <video> -> video536<h1>-<h6> -> text <svg> -> icon537<p> -> text <i> -> icon538<span> -> text <Icon> -> icon539 <HeartIcon> -> icon (name resolved from tag)540```541542---543544## The `add_section` JSX Format545546This is the primary way to build layouts. Write standard JSX with HTML tags and Tailwind `className` attributes.547548### Format Rules5495501. **Use HTML tags** — div, section, nav, h1, p, img, button, a, etc.5512. **Style with className** — Tailwind CSS classes only5523. **Text goes between tags** — `<h1 className="...">Hello</h1>`5534. **Images are self-closing** — `<img src="https://..." alt="..." className="..." />`5545. **Use `data-id`** only when referencing existing nodes (from `get_document`)5556. **No React-specific syntax** — no `onClick`, `useState`, fragments, or components5567. **Icons use `<svg>` with the `icon` attribute** — `<svg icon="arrow-right" className="w-5 h-5 text-gray-600" />`557558### Example: Complete Section559560```jsx561<section className="flex flex-col items-center gap-12 px-16 py-24 bg-white w-full">562 <div className="flex flex-col items-center gap-4 max-w-2xl">563 <span className="text-sm font-semibold text-blue-600 uppercase tracking-widest">Why Choose Us</span>564 <h2 className="text-4xl font-bold text-gray-900 text-center">Everything you need to scale</h2>565 <p className="text-lg text-gray-500 text-center">Built for modern teams that move fast and ship faster.</p>566 </div>567 <div className="flex gap-8 w-full max-w-5xl">568 <div className="flex flex-col gap-3 p-8 bg-gray-50 rounded-2xl grow">569 <svg icon="lightning" className="w-8 h-8 text-blue-600" />570 <h3 className="text-lg font-semibold text-gray-900">Lightning Fast</h3>571 <p className="text-sm text-gray-500">Deploy in seconds, not hours. Our edge network ensures sub-50ms latency worldwide.</p>572 </div>573 <div className="flex flex-col gap-3 p-8 bg-gray-50 rounded-2xl grow">574 <svg icon="shield-check" className="w-8 h-8 text-blue-600" />575 <h3 className="text-lg font-semibold text-gray-900">Enterprise Security</h3>576 <p className="text-sm text-gray-500">SOC 2 certified with end-to-end encryption. Your data stays yours.</p>577 </div>578 <div className="flex flex-col gap-3 p-8 bg-gray-50 rounded-2xl grow">579 <svg icon="headset" className="w-8 h-8 text-blue-600" />580 <h3 className="text-lg font-semibold text-gray-900">24/7 Support</h3>581 <p className="text-sm text-gray-500">Our team is always on. Get answers in minutes, not days.</p>582 </div>583 </div>584</section>585```586587---588589## Icons590591Efecto supports 4 icon libraries with ~9,400 icons total. Icons render as SVG and inherit color from `currentColor`.592593### How to Write Icons in JSX594595The canonical format:596```jsx597<svg icon="arrow-right" className="w-5 h-5 text-gray-600" />598```599600- **`icon`** — Icon name in **kebab-case** (e.g. `arrow-right`, `magnifying-glass`, `google-logo`)601- **`className`** — Size via `w-*` / `h-*`, color via `text-*` classes602- **`iconLibrary`** — Optional: `phosphor` (default), `lucide`, `heroicons`, `radix`603- **`iconWeight`** — Optional: `thin`, `light`, `regular` (default), `bold`, `fill`, `duotone` (Phosphor only)604605### Common Icon Names (Phosphor — default library)606607| Category | Icons |608|----------|-------|609| **Arrows** | `arrow-right`, `arrow-left`, `arrow-up`, `arrow-down`, `caret-right`, `caret-down` |610| **Actions** | `check`, `x`, `plus`, `minus`, `magnifying-glass`, `funnel`, `pencil`, `trash` |611| **UI** | `gear`, `sliders`, `dots-three`, `list`, `squares-four`, `sidebar` |612| **Social** | `google-logo`, `apple-logo`, `github-logo`, `x-logo`, `linkedin-logo`, `discord-logo`, `facebook-logo`, `instagram-logo`, `youtube-logo` |613| **Objects** | `envelope`, `lock`, `eye`, `eye-slash`, `star`, `heart`, `user`, `users`, `house`, `lightning`, `fire`, `rocket` |614| **Media** | `image`, `camera`, `play`, `pause`, `microphone`, `speaker-high` |615| **Commerce** | `shopping-cart`, `credit-card`, `currency-dollar`, `receipt`, `package` |616617### Icon Sizing Guide618619```620w-3 h-3 /* 12px — tiny, inline indicators */621w-4 h-4 /* 16px — inline with small text */622w-5 h-5 /* 20px — standard UI icon */623w-6 h-6 /* 24px — default, comfortable */624w-8 h-8 /* 32px — feature icons, cards */625w-10 h-10 /* 40px — hero feature icons */626w-12 h-12 /* 48px — large decorative */627w-16 h-16 /* 64px — hero section centerpiece */628```629630### Icon Patterns in Sections631632**Feature card with icon:**633```jsx634<div className="flex flex-col gap-3 p-8 bg-gray-50 rounded-2xl grow">635 <svg icon="lightning" className="w-8 h-8 text-blue-600" />636 <h3 className="text-lg font-semibold text-gray-900">Lightning Fast</h3>637 <p className="text-sm text-gray-500">Deploy in seconds, not hours.</p>638</div>639```640641**Button with icon (icons are siblings, not children):**642```jsx643<div className="flex items-center gap-2 bg-gray-900 text-white px-5 py-2.5 rounded-lg">644 <span className="text-sm font-medium">Get Started</span>645 <svg icon="arrow-right" className="w-4 h-4" />646</div>647```648649**Social icons row:**650```jsx651<div className="flex items-center gap-4">652 <svg icon="x-logo" className="w-5 h-5 text-gray-400" />653 <svg icon="github-logo" className="w-5 h-5 text-gray-400" />654 <svg icon="linkedin-logo" className="w-5 h-5 text-gray-400" />655 <svg icon="discord-logo" className="w-5 h-5 text-gray-400" />656</div>657```658659**Input with icon:**660```jsx661<div className="flex items-center gap-2 border border-gray-200 rounded-lg px-3 py-2 bg-white">662 <svg icon="magnifying-glass" className="w-4 h-4 text-gray-400" />663 <input placeholder="Search..." className="text-sm text-gray-900 grow" />664</div>665```666667**Using a different library (Lucide):**668```jsx669<svg icon="check" iconLibrary="lucide" className="w-5 h-5 text-green-600" />670```671672**Using a weight variant (Phosphor bold):**673```jsx674<svg icon="star" iconWeight="fill" className="w-5 h-5 text-yellow-500" />675```676677---678679## Tailwind CSS Patterns That Work680681### Layout682```683flex /* Horizontal flex row */684flex flex-col /* Vertical flex column */685items-center /* Center cross-axis */686items-start /* Align to start */687justify-between /* Space between children */688justify-center /* Center main-axis */689gap-2 gap-4 gap-8 /* Gap between flex children */690grow /* Fill remaining space (DO NOT use flex-1) */691```692693### Spacing694```695p-4 p-6 p-8 p-12 /* Padding all sides */696px-6 py-4 /* Horizontal / vertical padding */697pt-8 pb-16 /* Top / bottom padding */698mx-auto /* Center horizontally */699```700701### Sizing702```703w-full /* Full width of parent */704w-auto /* Width from content */705w-fit /* Shrink-wrap width */706w-[600px] /* Fixed pixel width */707max-w-2xl max-w-5xl /* Maximum width constraints */708min-h-screen /* Minimum full viewport height */709h-[400px] /* Fixed pixel height */710```711712### Typography713```714text-xs text-sm text-base text-lg text-xl text-2xl text-3xl text-4xl text-5xl text-6xl text-7xl text-8xl text-9xl715font-light font-normal font-medium font-semibold font-bold font-extrabold font-black716leading-tight leading-snug leading-normal leading-relaxed717tracking-tight tracking-normal tracking-wide tracking-widest718text-left text-center text-right719uppercase lowercase capitalize720```721722### Theme-Aware Colors (Preferred)723724Efecto supports a semantic token system. When a theme is active, these classes auto-adapt to light/dark/custom modes:725726```727/* Backgrounds */728bg-background /* Page/artboard background */729bg-card /* Card surfaces */730bg-popover /* Popover/dropdown surfaces */731bg-primary /* Primary action backgrounds */732bg-secondary /* Secondary surfaces */733bg-muted /* Muted/subtle backgrounds */734bg-accent /* Accent highlights */735bg-destructive /* Destructive/error backgrounds */736bg-input /* Input field backgrounds */737738/* Text */739text-foreground /* Primary text */740text-primary-foreground /* Text on primary backgrounds */741text-secondary-foreground /* Text on secondary surfaces */742text-muted-foreground /* Muted/secondary text */743text-accent-foreground /* Text on accent backgrounds */744text-card-foreground /* Text on cards */745text-popover-foreground /* Text on popovers */746text-destructive-foreground /* Text on destructive backgrounds */747748/* Borders */749border-border /* Default border color */750ring-ring /* Focus ring color */751```752753**When to use semantic vs hardcoded colors:**754- **Semantic** (`bg-primary`, `text-foreground`): UI components, buttons, cards, text — anything that should adapt with theme/mode changes755- **Hardcoded** (`bg-blue-500`, `text-white`): Decorative elements, brand-specific colors, illustrations, gradients756757These classes map to CSS custom properties (`--background`, `--primary`, etc.) and automatically update when the theme or mode changes. shadcn is the default token system, but these are standard CSS variables — any design system that provides them will work.758759### Colors (NAMED ONLY)760761Use named Tailwind colors. **Never use arbitrary hex** like `bg-[#f9f9f9]` — it silently fails at runtime.762763```764/* Backgrounds */765bg-white bg-black bg-gray-50 bg-gray-100 bg-gray-900 bg-neutral-950766bg-blue-50 bg-blue-500 bg-blue-600 bg-indigo-500 bg-purple-500767bg-green-50 bg-green-500 bg-red-50 bg-red-500 bg-amber-50 bg-yellow-400768769/* Text */770text-white text-black text-gray-400 text-gray-500 text-gray-600 text-gray-700 text-gray-900771text-blue-600 text-blue-500 text-indigo-600 text-green-600 text-red-600772773/* Borders */774border-gray-100 border-gray-200 border-gray-300 border-blue-500775776/* If you MUST use a specific hex color, use inline style instead: */777style: { "background-color": "#f9f9f9" }778```779780### Borders & Radius781```782border border-2 /* Border width */783border-gray-200 border-gray-300 /* Border color */784rounded rounded-lg rounded-xl rounded-2xl rounded-full /* Border radius */785```786787### Effects788```789shadow-sm shadow shadow-md shadow-lg shadow-xl790opacity-50 opacity-75791ring-1 ring-2 ring-blue-500 /* Ring / outline */792```793794### Gradients795```796bg-gradient-to-r from-blue-500 to-purple-500797bg-gradient-to-b from-white to-gray-50798bg-gradient-to-br from-indigo-500 via-purple-500 to-pink-500799```800801### Fills (Preferred: `set_fill` tool)802803For solid colors, gradients, and image backgrounds, prefer the `set_fill` tool over manually setting className/style. It handles the dual-write pattern automatically.804805```806# Solid color807set_fill targetId: "<id>" fill: { type: "solid", color: "blue-500" }808809# Linear gradient810set_fill targetId: "<id>" fill: { type: "gradient", gradient: { type: "linear", angle: 90, stops: [{ color: "#3b82f6", position: 0 }, { color: "#8b5cf6", position: 1 }] } }811812# Radial gradient813set_fill targetId: "<id>" fill: { type: "gradient", gradient: { type: "radial", stops: [{ color: "#3b82f6", position: 0 }, { color: "#1e1b4b", position: 1 }] } }814815# Image fill816set_fill targetId: "<id>" fill: { type: "image", url: "https://...", size: "cover", position: "center" }817818# Clear fill819set_fill targetId: "<id>"820```821822Works on both nodes and artboards. For artboards, solid fills update `backgroundColor` for backward compatibility.823824### Links & Anchors825826Any node can be made clickable with the `link` property on `add_node`, `update_node`, or `batch_update`. Use `elementId` to make a node an anchor target.827828| Link Type | Use Case | Required Fields |829|-----------|----------|-----------------|830| `url` | External URL | `url`, optional `target: "_blank"` |831| `page` | Navigate to another artboard | `pageId` (artboard ID) |832| `section` | Scroll to element anchor | `sectionId` (matches an `elementId`) |833| `email` | mailto link | `email` |834| `phone` | tel link | `phone` |835836```837# Make a button link to an external URL838update_node nodeId: "<btn-id>" link: { type: "url", url: "https://example.com", target: "_blank" }839840# Mark a section as an anchor target841update_node nodeId: "<section-id>" elementId: "pricing"842843# Link a nav item to that anchor844update_node nodeId: "<nav-link-id>" link: { type: "section", sectionId: "pricing" }845846# Link to another artboard (page navigation)847update_node nodeId: "<link-id>" link: { type: "page", pageId: "<artboard-id>" }848849# Remove a link850update_node nodeId: "<id>" link: null851```852853Works on any node type — frames, text, images, buttons. For published sites, `page` and `section` links become real navigation.854855---856857## Artboard Best Practices858859### Standard Sizes860| Name | Width | Height | Use Case |861|------|-------|--------|----------|862| Desktop | 1440 | 900+ | Full website pages |863| Desktop (narrow) | 1280 | 800+ | Content-focused pages |864| Tablet | 768 | 1024 | Tablet responsive view |865| Mobile | 375 | 812 | iPhone / mobile view |866867### Always Start With868```869create_artboard:870 name: "Homepage"871 width: 1440872 height: 900873 backgroundColor: "#ffffff"874 className: "flex flex-col"875```876877- **`className: "flex flex-col"`** is essential — without it, children overlap at (0,0)878- **`backgroundColor`** is an inline style property, NOT a Tailwind class879- Height grows automatically when content overflows, but set an initial height880881---882883## Common Section Patterns884885### Navigation Bar886887```jsx888<nav className="flex items-center justify-between px-16 py-5 bg-white w-full border-b border-gray-100">889 <h2 className="text-xl font-bold text-gray-900">Acme</h2>890 <div className="flex items-center gap-8">891 <a className="text-sm font-medium text-gray-600" href="#">Features</a>892 <a className="text-sm font-medium text-gray-600" href="#">Pricing</a>893 <a className="text-sm font-medium text-gray-600" href="#">About</a>894 <button className="px-5 py-2.5 text-sm font-medium text-white bg-gray-900 rounded-lg">Get Started</button>895 </div>896</nav>897```898899### Hero Section (Centered)900901```jsx902<section className="flex flex-col items-center justify-center gap-8 px-16 py-32 bg-white w-full">903 <div className="flex flex-col items-center gap-6 max-w-3xl">904 <span className="px-4 py-1.5 text-xs font-semibold text-blue-700 bg-blue-50 rounded-full uppercase tracking-wider">Now in Beta</span>905 <h1 className="text-6xl font-bold text-gray-900 text-center leading-tight">Build beautiful websites at the speed of thought</h1>906 <p className="text-xl text-gray-500 text-center">The AI-powered design tool that turns ideas into production-ready pages. No code required.</p>907 </div>908 <div className="flex items-center gap-4">909 <button className="px-8 py-3.5 text-base font-semibold text-white bg-blue-600 rounded-xl">Start Free Trial</button>910 <button className="px-8 py-3.5 text-base font-semibold text-gray-700 bg-white border-2 border-gray-200 rounded-xl">Watch Demo</button>911 </div>912</section>913```914915### Hero Section (Split — Text Left, Image Right)916917```jsx918<section className="flex items-center gap-16 px-16 py-24 bg-white w-full">919 <div className="flex flex-col gap-6 grow">920 <h1 className="text-5xl font-bold text-gray-900 leading-tight">Ship your next product in record time</h1>921 <p className="text-lg text-gray-500">From prototype to production in minutes. Our platform handles the complexity so you can focus on what matters.</p>922 <div className="flex items-center gap-4">923 <button className="px-6 py-3 text-base font-semibold text-white bg-gray-900 rounded-lg">Get Started</button>924 <a className="text-base font-medium text-gray-600" href="#">Learn more</a>925 </div>926 </div>927 <img src="https://placehold.co/600x400" alt="Product screenshot" className="w-[560px] h-[380px] rounded-2xl object-cover bg-gray-100" />928</section>929```930931### Feature Grid (3 columns)932933```jsx934<section className="flex flex-col items-center gap-16 px-16 py-24 bg-gray-50 w-full">935 <div className="flex flex-col items-center gap-4 max-w-2xl">936 <h2 className="text-4xl font-bold text-gray-900 text-center">Powerful features for modern teams</h2>937 <p className="text-lg text-gray-500 text-center">Everything you need to design, build, and ship — all in one place.</p>938 </div>939 <div className="flex gap-8 w-full max-w-6xl">940 <div className="flex flex-col gap-4 p-8 bg-white rounded-2xl shadow-sm grow">941 <div className="flex items-center justify-center w-12 h-12 bg-blue-100 rounded-xl">942 <span className="text-blue-600 text-lg font-bold">1</span>943 </div>944 <h3 className="text-xl font-semibold text-gray-900">Real-Time Collaboration</h3>945 <p className="text-sm text-gray-500 leading-relaxed">Work together with your team in real time. See cursors, selections, and changes as they happen.</p>946 </div>947 <div className="flex flex-col gap-4 p-8 bg-white rounded-2xl shadow-sm grow">948 <div className="flex items-center justify-center w-12 h-12 bg-green-100 rounded-xl">949 <span className="text-green-600 text-lg font-bold">2</span>950 </div>951 <h3 className="text-xl font-semibold text-gray-900">One-Click Deploy</h3>952 <p className="text-sm text-gray-500 leading-relaxed">Push to production with a single click. Built-in CI/CD, preview deployments, and rollbacks.</p>953 </div>954 <div className="flex flex-col gap-4 p-8 bg-white rounded-2xl shadow-sm grow">955 <div className="flex items-center justify-center w-12 h-12 bg-purple-100 rounded-xl">956 <span className="text-purple-600 text-lg font-bold">3</span>957 </div>958 <h3 className="text-xl font-semibold text-gray-900">AI Assistant</h3>959 <p className="text-sm text-gray-500 leading-relaxed">Built-in AI that understands your codebase. Generate components, fix bugs, and refactor with natural language.</p>960 </div>961 </div>962</section>963```964965### Testimonial / Social Proof966967```jsx968<section className="flex flex-col items-center gap-12 px-16 py-24 bg-white w-full">969 <div className="flex flex-col items-center gap-6 max-w-2xl">970 <p className="text-2xl text-gray-700 text-center leading-relaxed italic">"This tool completely transformed our workflow. We shipped our redesign in two weeks instead of two months."</p>971 <div className="flex items-center gap-4">972 <div className="w-12 h-12 bg-gray-200 rounded-full"></div>973 <div className="flex flex-col">974 <span className="text-sm font-semibold text-gray-900">Sarah Chen</span>975 <span className="text-sm text-gray-500">VP of Design, Stripe</span>976 </div>977 </div>978 </div>979 <div className="flex items-center gap-12">980 <span className="text-sm font-medium text-gray-400">Trusted by</span>981 <span className="text-lg font-bold text-gray-300">Stripe</span>982 <span className="text-lg font-bold text-gray-300">Vercel</span>983 <span className="text-lg font-bold text-gray-300">Linear</span>984 <span className="text-lg font-bold text-gray-300">Notion</span>985 <span className="text-lg font-bold text-gray-300">Figma</span>986 </div>987</section>988```989990### Pricing Cards991992```jsx993<section className="flex flex-col items-center gap-12 px-16 py-24 bg-gray-50 w-full">994 <div className="flex flex-col items-center gap-4">995 <h2 className="text-4xl font-bold text-gray-900">Simple, transparent pricing</h2>996 <p className="text-lg text-gray-500">No surprise fees. Cancel anytime.</p>997 </div>998 <div className="flex gap-8 w-full max-w-4xl">999 <div className="flex flex-col gap-6 p-8 bg-white rounded-2xl border border-gray-200 grow">1000 <div className="flex flex-col gap-2">1001 <h3 className="text-lg font-semibold text-gray-900">Starter</h3>1002 <div className="flex items-baseline gap-1">1003 <span className="text-4xl font-bold text-gray-900">$19</span>1004 <span className="text-sm text-gray-500">/month</span>1005 </div>1006 <p className="text-sm text-gray-500">Perfect for individuals and small projects.</p>1007 </div>1008 <button className="w-full py-3 text-sm font-semibold text-gray-700 bg-gray-100 rounded-lg">Get Started</button>1009 </div>1010 <div className="flex flex-col gap-6 p-8 bg-gray-900 rounded-2xl grow">1011 <div className="flex flex-col gap-2">1012 <h3 className="text-lg font-semibold text-white">Pro</h3>1013 <div className="flex items-baseline gap-1">1014 <span className="text-4xl font-bold text-white">$49</span>1015 <span className="text-sm text-gray-400">/month</span>1016 </div>1017 <p className="text-sm text-gray-400">For growing teams that need more power.</p>1018 </div>1019 <button className="w-full py-3 text-sm font-semibold text-gray-900 bg-white rounded-lg">Get Started</button>1020 </div>1021 <div className="flex flex-col gap-6 p-8 bg-white rounded-2xl border border-gray-200 grow">1022 <div className="flex flex-col gap-2">1023 <h3 className="text-lg font-semibold text-gray-900">Enterprise</h3>1024 <div className="flex items-baseline gap-1">1025 <span className="text-4xl font-bold text-gray-900">$99</span>1026 <span className="text-sm text-gray-500">/month</span>1027 </div>1028 <p className="text-sm text-gray-500">For large organizations with custom needs.</p>1029 </div>1030 <button className="w-full py-3 text-sm font-semibold text-gray-700 bg-gray-100 rounded-lg">Contact Sales</button>1031 </div>1032 </div>1033</section>1034```10351036### CTA (Call to Action)10371038```jsx1039<section className="flex flex-col items-center gap-8 px-16 py-24 bg-gray-900 w-full">1040 <h2 className="text-4xl font-bold text-white text-center">Ready to get started?</h2>1041 <p className="text-lg text-gray-400 text-center max-w-xl">Join thousands of teams already building faster. Start your free trial today.</p>1042 <div className="flex items-center gap-4">1043 <button className="px-8 py-3.5 text-base font-semibold text-gray-900 bg-white rounded-xl">Start Free Trial</button>1044 <button className="px-8 py-3.5 text-base font-semibold text-gray-300 bg-transparent border border-gray-700 rounded-xl">Talk to Sales</button>1045 </div>1046</section>1047```10481049### Footer10501051```jsx1052<footer className="flex items-center justify-between px-16 py-8 bg-white border-t border-gray-100 w-full">1053 <span className="text-sm text-gray-500">2026 Acme Inc. All rights reserved.</span>1054 <div className="flex items-center gap-6">1055 <a className="text-sm text-gray-500" href="#">Privacy</a>1056 <a className="text-sm text-gray-500" href="#">Terms</a>1057 <a className="text-sm text-gray-500" href="#">Contact</a>1058 </div>1059</footer>1060```10611062### Stats / Metrics Row10631064```jsx1065<section className="flex items-center justify-center gap-16 px-16 py-16 bg-blue-600 w-full">1066 <div className="flex flex-col items-center gap-2">1067 <span className="text-4xl font-bold text-white">10K+</span>1068 <span className="text-sm text-blue-200">Active Users</span>1069 </div>1070 <div className="flex flex-col items-center gap-2">1071 <span className="text-4xl font-bold text-white">99.9%</span>1072 <span className="text-sm text-blue-200">Uptime SLA</span>1073 </div>1074 <div className="flex flex-col items-center gap-2">1075 <span className="text-4xl font-bold text-white">50ms</span>1076 <span className="text-sm text-blue-200">Avg Latency</span>1077 </div>1078 <div className="flex flex-col items-center gap-2">1079 <span className="text-4xl font-bold text-white">4.9/5</span>1080 <span className="text-sm text-blue-200">User Rating</span>1081 </div>1082</section>1083```10841085---10861087## Tips, Gotchas, and Best Practices10881089### The Golden Rules109010911. **Always `get_document` first** before modifying an existing design. You need the `data-id` attributes.10922. **Use `get_selection`** when the user asks you to edit or add something "here" — it returns the selected nodes with their JSX subtrees so you can make contextual edits.10933. **Never guess node IDs** — always read them from `get_document`, `get_selection`, or `find_nodes`.10943. **Use `add_section` with JSX** for building structures. It is far more efficient than `add_node` one element at a time.10954. **Use `batch_update`** for multiple small changes. One call instead of many.10965. **Prefer updating over deleting and recreating.** Use `update_node` or `update_class`.10971098### Critical Gotchas10991100**Artboard className must include `flex flex-col`**1101Without it, children overlap at (0,0). This is the #1 mistake.11021103**Artboard backgroundColor is a property, NOT a className**1104```1105WRONG: className: "bg-gray-900 flex flex-col"1106RIGHT: backgroundColor: "#1a1a1a", className: "flex flex-col"1107```11081109**Never use arbitrary hex colors in className**1110Tailwind 4 generates CSS at build time. Dynamic classes like `bg-[#f9f9f9]` have no CSS at runtime and are invisible.1111```1112WRONG: className: "bg-[#f9f9f9] text-[#333333]"1113RIGHT: className: "bg-gray-50 text-gray-700"1114ALSO OK: style: { "background-color": "#f9f9f9", "color": "#333333" }1115```1116Note: The system auto-converts arbitrary hex to inline styles, but prefer named colors.11171118**`flex-1` does not work — use `grow` instead**1119`flex-1` gets classified as unmapped by the Tailwind bridge. Use `grow` for the same effect.11201121**Frame nodes have no textContent**1122Frame types (div, section, nav, header, footer) cannot hold text directly. Use text nodes (h1, p, span) inside them.11231124**Button nodes ignore children**1125The button renderer only uses `textContent`. Do not nest icons or other elements inside buttons — wrap them in a flex container instead:1126```jsx1127<div className="flex items-center gap-2 bg-blue-600 text-white px-5 py-2.5 rounded-lg">1128 <span className="text-sm font-medium">Continue</span>1129 <svg icon="arrow-right" className="w-4 h-4" />1130</div>1131```11321133**Top-level sections need `w-full`**1134The auto-fixer adds this, but always include `w-full` on direct children of the artboard so they span the full width.11351136**Images without `src` get a placeholder**1137If you omit `src`, the system inserts `https://placehold.co/600x400`. Always provide a real src for production designs.11381139### Required Structure and Quality Gate11401141- **Name meaningful layers.** Give every section, layout group, card, text block, control, image, and icon a concise semantic `name` attribute (for example, `<section name="Hero">`, `<div name="Hero Copy">`, `<h1 name="Hero Heading">`). Never ship generic names such as `Frame`, `Text`, or `Icon`; unnamed purely decorative leaves are the only exception.1142- **Declare nested layout.** Every frame with two or more children must explicitly include `flex` or `grid` in `className`, including nested wrappers. Add the matching direction, alignment, gap, and wrapping classes; do not rely on implicit block flow.1143- **Meet WCAG AA contrast.** Normal text must reach 4.5:1 and large text 3:1. Evaluate text against its effective rendered background: use its own background when present, otherwise walk through ancestor frames to the artboard, including opacity/alpha compositing. Resolve semantic theme tokens in the active mode before judging contrast.1144- **Audit until clean.** After building or editing, call `audit_design`. Fix every `contrast-ratio`, `implicit-block-container`, and `generic-layer-name` finding with `batch_update` or `replace_section`, then call `audit_design` again. If you use `repair_design`, inspect its changes and re-audit. Do not declare completion until all three finding types are zero, and use `get_document` to confirm meaningful layers retain semantic names.11451146### Design Tips11471148- **Max-width containers**: Use `max-w-5xl` or `max-w-6xl` centered with content inside for readable text widths1149- **Consistent spacing**: Use the Tailwind spacing scale (4, 6, 8, 12, 16, 24 are common section padding values)1150- **Color hierarchy**: Use gray-900 for headings, gray-500 for body text, gray-400 for secondary text1151- **Section rhythm**: Alternate between white and gray-50 backgrounds for visual separation1152- **Button hierarchy**: Primary = solid dark, Secondary = outline or light background11531154---11551156## Complete Recipe: SaaS Landing Page11571158Build a complete SaaS landing page from scratch — step by step.11591160### Step 1: Create Session and Artboard11611162```1163create_session1164 label: "SaaS Landing Page"1165```11661167If resuming an open Efecto URL, use `attach_session` instead. Wait for browser connection (`wait_for_connection`), then:11681169```1170create_artboard:1171 name: "Landing Page"1172 width: 14401173 height: 9001174 backgroundColor: "#ffffff"1175 className: "flex flex-col"1176```11771178### Step 2: Navigation11791180```1181add_section:1182 parentId: "<artboard-id>"1183 jsx: |1184 <nav className="flex items-center justify-between px-16 py-5 bg-white w-full border-b border-gray-100">1185 <div className="flex items-center gap-2">1186 <div className="w-8 h-8 bg-blue-600 rounded-lg"></div>1187 <h2 className="text-lg font-bold text-gray-900">Launchpad</h2>1188 </div>1189 <div className="flex items-center gap-8">1190 <a className="text-sm font-medium text-gray-600" href="#">Product</a>1191 <a className="text-sm font-medium text-gray-600" href="#">Features</a>1192 <a className="text-sm font-medium text-gray-600" href="#">Pricing</a>1193 <a className="text-sm font-medium text-gray-600" href="#">Docs</a>1194 </div>1195 <div className="flex items-center gap-3">1196 <a className="text-sm font-medium text-gray-600" href="#">Sign In</a>1197 <button className="px-5 py-2 text-sm font-medium text-white bg-blue-600 rounded-lg">Start Free</button>1198 </div>1199 </nav>1200```12011202### Step 3: Hero12031204```1205add_section:1206 parentId: "<artboard-id>"1207 jsx: |1208 <section className="flex flex-col items-center gap-10 px-16 py-32 bg-white w-full">1209 <div className="flex flex-col items-center gap-6 max-w-3xl">1210 <span className="px-4 py-1.5 text-xs font-semibold text-blue-700 bg-blue-50 rounded-full uppercase tracking-wider">New: AI-Powered Workflows</span>1211 <h1 className="text-6xl font-extrabold text-gray-900 text-center leading-tight tracking-tight">Ship products faster than ever before</h1>1212 <p className="text-xl text-gray-500 text-center leading-relaxed">The all-in-one platform for modern product teams. Design, build, test, and deploy from a single dashboard.</p>1213 </div>1214 <div className="flex items-center gap-4">1215 <button className="px-8 py-4 text-base font-semibold text-white bg-blue-600 rounded-xl">Start Free Trial</button>1216 <button className="px-8 py-4 text-base font-semibold text-gray-700 bg-white border-2 border-gray-200 rounded-xl">Watch Demo</button>1217 </div>1218 <p className="text-sm text-gray-400">Free for 14 days. No credit card required.</p>1219 </section>1220```12211222### Step 4: Social Proof Bar12231224```1225add_section:1226 parentId: "<artboard-id>"1227 jsx: |1228 <section className="flex items-center justify-center gap-12 px-16 py-12 bg-gray-50 border-y border-gray-100 w-full">1229 <span className="text-sm text-gray-400">Trusted by leading teams at</span>1230 <span className="text-lg font-bold text-gray-300">Stripe</span>1231 <span className="text-lg font-bold text-gray-300">Vercel</span>1232 <span className="text-lg font-bold text-gray-300">Linear</span>1233 <span className="text-lg font-bold text-gray-300">Notion</span>1234 <span className="text-lg font-bold text-gray-300">Figma</span>1235 </section>1236```12371238### Step 5: Feature Grid12391240```1241add_section:1242 parentId: "<artboard-id>"1243 jsx: |1244 <section className="flex flex-col items-center gap-16 px-16 py-24 bg-white w-full">1245 <div className="flex flex-col items-center gap-4 max-w-2xl">1246 <h2 className="text-4xl font-bold text-gray-900 text-center">Built for speed, designed for scale</h2>1247 <p className="text-lg text-gray-500 text-center">Powerful tools that grow with your team. No compromises.</p>1248 </div>1249 <div className="flex gap-6 w-full max-w-5xl">1250 <div className="flex flex-col gap-4 p-8 bg-gray-50 rounded-2xl grow">1251 <div className="flex items-center justify-center w-12 h-12 bg-blue-100 rounded-xl">1252 <span className="text-blue-600 font-bold">1</span>1253 </div>1254 <h3 className="text-lg font-semibold text-gray-900">Visual Editor</h3>1255 <p className="text-sm text-gray-500 leading-relaxed">Drag-and-drop interface with pixel-perfect precision. Design at the speed of thought.</p>1256 </div>1257 <div className="flex flex-col gap-4 p-8 bg-gray-50 rounded-2xl grow">1258 <div className="flex items-center justify-center w-12 h-12 bg-green-100 rounded-xl">1259 <span className="text-green-600 font-bold">2</span>1260 </div>1261 <h3 className="text-lg font-semibold text-gray-900">Instant Deploy</h3>1262 <p className="text-sm text-gray-500 leading-relaxed">One-click deployment to our global CDN. Preview environments for every branch.</p>1263 </div>1264 <div className="flex flex-col gap-4 p-8 bg-gray-50 rounded-2xl grow">1265 <div className="flex items-center justify-center w-12 h-12 bg-purple-100 rounded-xl">1266 <span className="text-purple-600 font-bold">3</span>1267 </div>1268 <h3 className="text-lg font-semibold text-gray-900">AI Copilot</h3>1269 <p className="text-sm text-gray-500 leading-relaxed">AI that understands your design system. Generate components, layouts, and content automatically.</p>1270 </div>1271 </div>1272 </section>1273```12741275### Step 6: CTA12761277```1278add_section:1279 parentId: "<artboard-id>"1280 jsx: |1281 <section className="flex flex-col items-center gap-8 px-16 py-24 bg-gray-900 w-full">1282 <h2 className="text-4xl font-bold text-white text-center">Start building today</h2>1283 <p className="text-lg text-gray-400 text-center max-w-xl">Join 10,000+ teams already shipping faster with Launchpad. Free trial, no strings attached.</p>1284 <div className="flex items-center gap-4">1285 <button className="px-8 py-4 text-base font-semibold text-gray-900 bg-white rounded-xl">Start Free Trial</button>1286 <button className="px-8 py-4 text-base font-semibold text-gray-300 bg-transparent border border-gray-700 rounded-xl">Talk to Sales</button>1287 </div>1288 </section>1289```12901291### Step 7: Footer12921293```1294add_section:1295 parentId: "<artboard-id>"1296 jsx: |1297 <footer className="flex items-center justify-between px-16 py-8 bg-gray-900 border-t border-gray-800 w-full">1298 <div className="flex items-center gap-2">1299 <div className="w-6 h-6 bg-blue-600 rounded-md"></div>1300 <span className="text-sm font-semibold text-gray-400">Launchpad</span>1301 </div>1302 <span className="text-sm text-gray-500">2026 Launchpad Inc. All rights reserved.</span>1303 <div className="flex items-center gap-6">1304 <a className="text-sm text-gray-500" href="#">Privacy</a>1305 <a className="text-sm text-gray-500" href="#">Terms</a>1306 <a className="text-sm text-gray-500" href="#">Status</a>1307 </div>1308 </footer>1309```13101311### Step 8: Verify and Refine13121313Call `get_document` to verify the structure. Use `batch_update` for any tweaks — adjust colors, spacing, or text content across multiple nodes at once.13141315---13161317## Responsive Design Workflow13181319To create responsive variations:132013211. Build the desktop design (1440px) first13222. Use `duplicate_artboard` to clone it for tablet (768px) and mobile (375px)13233. Use `batch_update` to adjust:1324 - Switch horizontal flex rows to `flex flex-col` for stacking1325 - Reduce padding: `px-16` to `px-6`, `py-24` to `py-16`1326 - Scale down text: `text-6xl` to `text-4xl`, `text-4xl` to `text-2xl`1327 - Change gap values: `gap-8` to `gap-4`1328 - Change grid layouts: 3-column features to 1-column stack13291330---13311332## Dark Mode Design13331334**Preferred: Use the theme system** — it handles light/dark automatically:133513361. Call `set_theme` with a preset (e.g. `presetId: "default"`) — light + dark modes are included13372. Call `set_theme_mode` with `mode: "dark"` — artboards switch to dark tokens13383. Use semantic classes (`bg-background`, `text-foreground`, `bg-card`, etc.) — colors auto-correct for the active mode13394. Switch back with `set_theme_mode` `mode: "light"` at any time13401341**Manual fallback** (for custom non-theme designs without semantic tokens):134213431. Set artboard `backgroundColor: "#0a0a0a"` or `"#111111"`13442. Use inverted color scale:1345 - Headings: `text-white` or `text-gray-100`1346 - Body: `text-gray-400`1347 - Secondary: `text-gray-500`1348 - Backgrounds: `bg-gray-900`, `bg-gray-800`, `bg-neutral-900`1349 - Borders: `border-gray-800`1350 - Cards: `bg-gray-900` with `border border-gray-800`13513. Buttons: `bg-white text-gray-900` for primary, `border border-gray-700 text-gray-300` for secondary13521353---13541355## Theme System13561357Efecto's theme system lets you define design tokens (colors, radius) that power semantic Tailwind classes. Themes support multiple modes (light, dark, or custom) and all artboards update live when you switch.13581359### Theme Tools13601361| Tool | Description |1362|------|-------------|1363| `get_theme` | Returns current theme: id, name, modes, activeMode, and resolved active tokens |1364| `set_theme` | Apply a preset, import CSS, or provide token objects directly |1365| `set_theme_mode` | Switch the active mode (e.g. "light" -> "dark") |1366| `reset_theme` | Remove theme entirely — back to raw Tailwind colors with no semantic tokens |13671368### Apply a Preset13691370```1371set_theme1372 presetId: "blue"1373```13741375Available presets: `default`, `zinc`, `slate`, `rose`, `blue`, `green`, `violet`, `orange`. Each includes light and dark modes.13761377### Switch Mode13781379```1380set_theme_mode1381 mode: "dark"1382```13831384### Bring Your Own Tokens13851386Agents can import design tokens from **any source** — a user's repo `globals.css`, a shadcn theme, Radix colors, Open Props, or hand-crafted values. As long as the CSS uses `--variable-name: value;` declarations, they work.13871388**Import from a CSS file** (e.g. the user's `globals.css`):13891390```1391set_theme1392 css: ":root { --background: #ffffff; --foreground: #0a0a0a; --primary: #e11d48; --primary-foreground: #fff1f2; --secondary: #f5f5f5; --secondary-foreground: #171717; --muted: #f5f5f5; --muted-foreground: #737373; --border: #e5e5e5; --ring: #fb7185; --radius: 0.5rem; } .dark { --background: #0a0a0a; --foreground: #fafafa; --primary: #fb7185; --primary-foreground: #1c1917; --secondary: #262626; --secondary-foreground: #fafafa; --muted: #262626; --muted-foreground: #a3a3a3; --border: #404040; --ring: #e11d48; }"1393```13941395If the user says "use my brand colors" or "match my repo", read their CSS file and pass it via the `css` parameter.13961397**Create tokens from scratch** (for a brand):13981399```1400set_theme1401 modes: {1402 "light": { "primary": "#6d28d9", "primaryForeground": "#f5f3ff", "background": "#fafafa", "foreground": "#1a1a1a" },1403 "dark": { "primary": "#a78bfa", "primaryForeground": "#1a1a1a", "background": "#0a0a0a", "foreground": "#fafafa" }1404 }1405```14061407Missing token keys automatically inherit from defaults.14081409### Build with Tokens14101411Once a theme is active, use semantic classes in your JSX:14121413```jsx1414<div className="bg-background text-foreground">1415 <div className="bg-card border border-border rounded-lg p-6">1416 <h2 className="text-foreground text-xl font-bold">Card Title</h2>1417 <p className="text-muted-foreground">Supporting text</p>1418 <button className="bg-primary text-primary-foreground px-4 py-2 rounded-md">Action</button>1419 </div>1420</div>1421```14221423These classes render correctly in any mode — switch from light to dark and all colors update.14241425### Supported Token Keys14261427| CSS Variable | Token Key | Usage |1428|-------------|-----------|-------|1429| `--background` | `background` | Page background (`bg-background`) |1430| `--foreground` | `foreground` | Primary text (`text-foreground`) |1431| `--card` | `card` | Card surface (`bg-card`) |1432| `--card-foreground` | `cardForeground` | Card text (`text-card-foreground`) |1433| `--popover` | `popover` | Popover surface (`bg-popover`) |1434| `--popover-foreground` | `popoverForeground` | Popover text (`text-popover-foreground`) |1435| `--primary` | `primary` | Primary action (`bg-primary`) |1436| `--primary-foreground` | `primaryForeground` | Text on primary (`text-primary-foreground`) |1437| `--secondary` | `secondary` | Secondary surface (`bg-secondary`) |1438| `--secondary-foreground` | `secondaryForeground` | Text on secondary (`text-secondary-foreground`) |1439| `--muted` | `muted` | Muted surface (`bg-muted`) |1440| `--muted-foreground` | `mutedForeground` | Muted text (`text-muted-foreground`) |1441| `--accent` | `accent` | Accent surface (`bg-accent`) |1442| `--accent-foreground` | `accentForeground` | Text on accent (`text-accent-foreground`) |1443| `--destructive` | `destructive` | Error/danger (`bg-destructive`) |1444| `--destructive-foreground` | `destructiveForeground` | Text on destructive (`text-destructive-foreground`) |1445| `--border` | `border` | Default borders (`border-border`) |1446| `--input` | `input` | Input borders (`bg-input`) |1447| `--ring` | `ring` | Focus rings (`ring-ring`) |1448| `--radius` | `radius` | Border radius base |