Sibling skills (local only)
Sibling CloudBase skills ship beside this skill. Use local relative paths such as ../auth-tool-cloudbase/SKILL.md.
If a referenced sibling skill file is missing from this environment, ask the user to install the full CloudBase plugin (or the missing skill). Do not HTTP-fetch remote skill or protocol markdown into the agent context.
Activation Contract
Use this first when
- The request is to decide visual direction, produce a design specification, create a prototype, or make layout, typography, color, and visual hierarchy choices for an interface.
- The implementation should follow a deliberate aesthetic rather than directly coding an already-approved design.
Read before writing code if
- The response must choose typography, color, spacing, layout strategy, or other visual rules before code exists.
- The user asks for "design", "prototype", "look and feel", or "style" rather than straight implementation.
Then also read
- Web implementation ->
../web-development/SKILL.md
- Mini program implementation ->
../miniprogram-development/SKILL.md
Do NOT use for
- Backend-only tasks, database design, or pure API work without interface output.
- Straight implementation of an already-approved UI without new design decisions.
- Generic frontend coding requests where the visual direction is already settled.
Common mistakes / gotchas
- Writing JSX, WXML, or CSS before outputting the design specification.
- Falling back to generic AI layouts instead of an explicit aesthetic direction.
- Jumping into implementation when the design intent is still unclear.
- Ignoring platform constraints after the visual concept is defined.
Minimal checklist
- Read UI Design Activation Checklist before interface generation.
When to use this skill
Use this skill for frontend UI design and interface creation in any project that requires:
- Creating web pages or interfaces
- Creating mini-program pages or interfaces
- Designing frontend components
- Creating prototypes or interfaces
- Handling styling and visual effects
- Any development task involving user interfaces
Do NOT use for:
- Backend logic or API design
- Database schema design (use postgresql-development-cloudbase skill)
- Pure business logic without UI components
How to use this skill (for a coding agent)
MANDATORY: Complete Design Specification First
- Before writing ANY interface code, you MUST explicitly output the design specification
- This includes: Purpose Statement, Aesthetic Direction, Color Palette, Typography, Layout Strategy
- Never skip this step - it's required for quality design
Follow the Design Process
- User Experience Analysis
- Product Interface Planning
- Aesthetic Direction Determination
- High-Fidelity UI Design
- Frontend Prototype Implementation
- Realism Enhancement
Avoid Generic AI Aesthetics
- Never use forbidden colors (purple, violet, indigo, fuchsia, blue-purple gradients)
- Never use forbidden fonts (Inter, Roboto, Arial, Helvetica, system-ui, -apple-system)
- Never use standard centered layouts on persuade surfaces without creative breaking (centered is correct on Operate and Read surfaces — see the scene judgement below)
- Never use emoji as icons - always use professional icon libraries (FontAwesome, Heroicons, etc.)
Run Self-Audit Before Submitting
- Color audit (check for forbidden colors)
- Font audit (check for forbidden fonts)
- Icon audit (verify no emoji icons, using professional icon libraries)
- Layout audit (judged by scene, not one-size-fits-all)
- Measurable checks (contrast, spacing, states, overflow)
- Design specification compliance check
Respect brand or design-system overrides when they are real constraints
- If the project already has approved brand colors, font tokens, or a design system, treat those as higher-priority constraints
- Explicitly document which default UI-design prohibitions are being overridden and why
- Keep the override narrow: preserve the overall quality bar instead of falling back to generic AI styling
- Qualifies: the project ships a
DESIGN.md, a design-token file, or a published brand spec, and you can name the specific token you are honoring
- Does not qualify: "I like this better," or a value adjusted only to slip past a prohibition
UI Design Rules
You are a professional frontend engineer specializing in creating high-fidelity prototypes with distinctive aesthetic styles. Your primary responsibility is to transform user requirements into interface prototypes that are ready for development. These interfaces must not only be functionally complete but also feature memorable visual design.
Design Thinking
⚠️ MANDATORY PRE-DESIGN CHECKLIST (MUST COMPLETE BEFORE ANY CODE)
You MUST explicitly output this analysis before writing ANY interface code:
DESIGN SPECIFICATION
====================
0. Scene: [Persuade / Operate / Read — pick one; it decides every criterion below]
1. Purpose Statement: [2-3 sentences about problem/users/context]
2. Aesthetic Direction: [Choose ONE from list below, FORBIDDEN: "modern", "clean", "simple"]
3. Color Palette: [List 3-5 specific colors with hex codes]
❌ FORBIDDEN COLORS: purple (#800080-#9370DB), violet (#8B00FF-#EE82EE), indigo (#4B0082-#6610F2), fuchsia (#FF00FF-#FF77FF), blue-purple gradients
4. Typography: [Specify exact font names]
❌ FORBIDDEN FONTS: Inter, Roboto, Arial, Helvetica, system-ui, -apple-system
5. Layout Strategy: [the scale: breakpoint count, container width, column count, spacing base; on persuade surfaces only, which line breaks and why]
❌ FORBIDDEN: a persuade surface in a standard centered layout with no breaking at all; starting any page without breakpoint and spacing scales
Aesthetic Direction Options:
- Brutally minimal
- Maximalist chaos
- Retro-futuristic
- Organic/natural
- Luxury/refined
- Playful/toy-like
- Editorial/magazine
- Brutalist/raw
- Art deco/geometric
- Soft/pastel
- Industrial/utilitarian
Key: Choose a clear conceptual direction and execute it with precision. Both minimalism and maximalism work - the key is intentionality, not intensity.
Context-Aware Recommendations
- Education apps: Editorial/Organic/Retro-futuristic (avoid generic blue)
- Productivity apps: Brutalist/Industrial/Luxury
- Social apps: Playful/Maximalist/Soft
- Finance apps: Luxury/Art deco/Brutally minimal
🚨 TRIGGER WORD DETECTOR
If you find yourself typing these words, STOP immediately and re-read this rule:
- "gradient" + "purple/violet/indigo/fuchsia/blue-purple"
- "card" + "centered" + "shadow"
- "Inter" or "Roboto" or "system-ui"
- "modern" or "clean" or "simple" (without specific style direction)
- Emoji characters (🚀, ⭐, ❤️, etc.) as icons
Action: Go back to Design Specification → Choose alternative aesthetic → Proceed
Design Process
User Experience Analysis: First analyze the main functions and user needs of the App, determine core interaction logic.
Product Interface Planning: As a product manager, define key interfaces and ensure information architecture is reasonable.
Aesthetic Direction Determination: Based on design thinking analysis, determine clear aesthetic style and visual language.
High-Fidelity UI Design: As a UI designer, design interfaces that align with real iOS/Android design standards, use modern UI elements to provide excellent visual experience, and reflect the determined aesthetic style.
Frontend Prototype Implementation: Use Tailwind CSS for styling, and must use professional icon libraries (FontAwesome, Heroicons, etc.) - never use emoji as icons. Split code files and maintain clear structure.
Realism Enhancement:
- Use real UI images instead of placeholder images (can be selected from Unsplash, Pexels, Apple official UI resources)
- If video materials are needed, can use Vimeo website for video resources
Downloading Remote Assets (images / icons / fonts)
⚠️ The downloadRemoteFile MCP tool has been removed (high error rate on content-type/SSRF filtering). To download a remote asset into the project, use a shell command instead:
- macOS / Linux:
curl -L --fail -o assets/images/logo.png "https://example.com/logo.png" (add --create-dirs if the parent folder doesn't exist; wget works too)
- Windows (PowerShell):
Invoke-WebRequest -Uri "https://example.com/logo.png" -OutFile "assets\images\logo.png" (or use curl.exe -L -o assets/images/logo.png <url> in cmd/PowerShell 5.1+, which ships with Windows 10 1803+)
Guidance:
- Always use
-L/--location (curl) or -UseBasicParsing (PowerShell) so redirects are followed.
- Prefer HTTPS URLs; avoid private/internal hosts (may be blocked by network policy or rejected for security).
- If the target returns
application/octet-stream, that is fine for binaries — the removed tool's strict whitelist was the problem, not the URL.
Frontend Aesthetics Guidelines
Judge the scene before choosing criteria
The same rules fight each other across three kinds of surface. Name the scene first:
| Scene |
Typical surfaces |
What good layout means here |
| Persuade |
Landing pages, marketing heroes, campaign pages |
A committed visual position; asymmetry, grid-breaking, and deliberate impact are allowed |
| Operate |
Admin panels, forms, consoles, dashboards |
Predictable structure, stable density, standard controls; never make the user re-learn placement |
| Read |
Docs, blogs, help centers |
A linear path the reader can follow, 65–75ch measure, navigation where it is expected |
- Persuade surfaces want to be remembered; Operate and Read surfaces want to be predictable.
- On the latter two, a novel layout is a defect, not an advantage. Asymmetric grid-breaking on a docs page forces every reader to re-orient on every visit.
- One site can host all three; a single page belongs to exactly one.
Typography
- Avoid Generic Fonts: Do not use overly common fonts like Arial, Inter, Roboto, system fonts
- Choose Distinctive Fonts: Select beautiful, unique, and interesting fonts, for example:
- Choose distinctive display fonts paired with refined body fonts
- Consider using distinctive font combinations to elevate the interface's aesthetic level
- Font selection should align with the overall aesthetic direction
Color & Theme
- Unified Aesthetics: Use CSS variables for consistency
- Dominant Colors with Accents: Using dominant colors with sharp accents is more effective than evenly-distributed color schemes
- Theme Consistency: Choose dark or light themes based on aesthetic direction, ensure color choices match the overall style
- Brand Escape Hatch: If a product already mandates a brand palette or typography system, you may use those tokens, but call out the override explicitly in the design specification
Motion Design
- Animation Strategy: Use animations for effects and micro-interactions
- Technology Choice: Prioritize CSS-only solutions for HTML, React projects can use Motion library
- High-Impact Moments: Focus on high-impact moments. One well-orchestrated page load animation (using animation-delay for staggered reveals) creates more delight than scattered micro-interactions
- Interactive Surprises: Use scroll-triggering and hover states to create surprises
Icons
- ❌ FORBIDDEN: Emoji Icons: Never use emoji characters as icons (🚀, ⭐, ❤️, etc.)
- ✅ REQUIRED: Professional Icon Libraries: Must use professional icon libraries such as:
- FontAwesome (recommended for most projects)
- Heroicons (for Tailwind CSS projects)
- Material Icons
- Feather Icons
- Lucide Icons
- Icon Consistency: Use icons from a single library throughout the project for visual consistency
- Icon Styling: Icons should match the overall aesthetic direction and color palette
Grid & Breakpoints
Set the scale before drawing components. The scale is infrastructure, not a per-component decision.
- At most four breakpoints, reused site-wide. Never add a breakpoint because "it got cramped here" — that number carries no meaning outside the head of whoever typed it.
- One container width. Two values coexisting (a custom 1200 plus a framework default 1140) means every style change starts by guessing which one wins.
- Pick structure by scene:
- Persuade: use a column system. Card counts across sections (8/4/3/2) must land on the same columns and share a common divisor; a bespoke
repeat(N, 1fr) per section means there is no grid.
- Operate / Read: skip the column system. What you need is a container, a 65–75ch body measure, and fixed column proportions. Measure is a hard constraint; a column grid here is over-engineering.
- Spacing comes from a scale: 4-based (4/8/12/16/24/32/64), no one-off values.
- Question an equal-card grid before using it: are these items genuinely equivalent? If some were already named in the copy above, the grid is a framework default rather than a decision.
Spatial Composition
Build the grid before breaking it. Breaking without a scale is just placing things by hand.
- Persuade: asymmetry, overlap, diagonal flow, and grid-breaking elements are available. Breaking needs a reason — which line you break, and why that line should give.
- Operate / Read: do not break. Repetition is not a weakness; it is what lets a reader build muscle memory.
- Negative space: either generous enough to form rhythm, or dense enough to carry information. The worst case is every block taking the same spacing value — even a scale-legal 24px, once everything weighs the same, leaves the reader nowhere to land.
Backgrounds & Visual Details
- Atmosphere Creation: Create atmosphere and depth rather than defaulting to solid colors
- Contextual Effects: Add contextual effects and textures that match the overall aesthetic
- Creative Forms: Apply creative forms, such as:
- Gradient meshes
- Noise textures
- Geometric patterns
- Layered transparencies
- Dramatic shadows
- Decorative borders
- Custom cursors
- Grain overlays
Avoid Generic AI Aesthetics
Strictly Prohibit the following generic AI-generated aesthetics:
- Overused font families (Inter, Roboto, Arial, system fonts)
- Cliched color schemes (particularly purple gradients on white backgrounds)
- Predictable layouts and component patterns on persuade surfaces (on Operate and Read surfaces they are the correct answer)
- Cookie-cutter design that lacks context-specific character
- Emoji icons: Never use emoji characters (🚀, ⭐, ❤️, etc.) as icons - always use professional icon libraries
❌ ANTI-PATTERNS (Code Examples to NEVER Use)
// ❌ BAD: Forbidden purple gradient
className="bg-gradient-to-r from-violet-600 to-fuchsia-600"
className="bg-gradient-to-br from-purple-500 to-indigo-600"
// ✅ GOOD: Context-specific alternatives
className="bg-gradient-to-br from-amber-50 via-orange-50 to-rose-50" // Warm editorial
className="bg-gradient-to-tr from-emerald-900 to-teal-700" // Dark organic
className="bg-[#FF6B35] to-[#F7931E]" // Bold retro-futuristic
// ❌ BAD on persuade surfaces: Generic centered card layout
// (on Operate and Read surfaces the centered version is correct — the defect there
// is an undesigned page, not the centering)
<div className="flex items-center justify-center min-h-screen">
<div className="bg-white rounded-lg shadow-lg p-8">
// ✅ GOOD on persuade surfaces: Asymmetric layout with creative positioning
<div className="grid grid-cols-12 min-h-screen">
<div className="col-span-7 col-start-2 pt-24">
// ❌ BAD: System fonts
font-family: 'Inter', system-ui, sans-serif
font-family: 'Roboto', -apple-system, sans-serif
// ✅ GOOD: Distinctive fonts
font-family: 'Playfair Display', serif // Editorial
font-family: 'Space Mono', monospace // Brutalist
font-family: 'DM Serif Display', serif // Luxury
// ❌ BAD: Emoji icons
<span>🚀</span>
<button>⭐ Favorite</button>
// ✅ GOOD: Professional icon libraries
<i className="fas fa-rocket"></i> // FontAwesome
<svg className="w-5 h-5">...</svg> // Heroicons
Creative Implementation Principles
- Creative Interpretation: Interpret requirements creatively, make unexpected choices, make designs feel genuinely designed for the context
- Avoid Repetition: Each design should be different, vary between generations:
- Light and dark themes
- Different fonts
- Different aesthetic styles
- Avoid Convergence: Never converge on common choices (e.g., Space Grotesk)
- Complexity Matching: Match implementation complexity to aesthetic vision:
- Maximalist designs need elaborate code with extensive animations and effects
- Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details
- Elegance comes from executing the vision well
Design Constraints
If not specifically required, provide at most 4 pages. Do not consider generation length and complexity, ensure the application is rich.
Implementation Requirements
All interface prototypes must:
- Production-Grade Quality: Functionally complete and ready for development
- Visual Impact: Visually striking and memorable
- Aesthetic Consistency: Have a clear aesthetic point-of-view, cohesive and unified
- Meticulously Refined: Every detail is carefully polished
🔍 SELF-AUDIT CHECKLIST (Before Submitting Code)
Run these checks on your generated code:
Color Audit:
# Search for forbidden colors in your code
grep -iE "(violet|purple|indigo|fuchsia)" [your-file]
# If found → VIOLATION → Choose alternative from Design Specification
Font Audit:
# Search for forbidden fonts
grep -iE "(Inter|Roboto|system-ui|Arial|-apple-system)" [your-file]
# If found → VIOLATION → Use distinctive font from Design Specification
Icon Audit:
# Search for emoji usage (common emoji patterns)
grep -iE "(🚀|⭐|❤️|👍|🔥|💡|🎉|✨)" [your-file]
# If found → VIOLATION → Replace with FontAwesome or other professional icon library
# Verify icon library is properly imported and used
Layout Audit (judged by scene, not one-size-fits-all):
- Persuade: did you use asymmetry or breaking, and can you name the line you broke and why?
- Operate / Read: predictable structure, stable density, body measure within 65–75ch?
- All scenes: ≤4 breakpoints reused site-wide, a single container width, spacing drawn from the scale?
Measurable Checks (measurable, not felt):
- Contrast: body and placeholder text ≥4.5:1, large text ≥3:1. On colored surfaces, tint secondary text from that hue rather than graying it — gray on color reads muddy and fails.
- Spacing: tight groups tighter, distant groups farther; more space above a heading than below. Read the computed value, not the impression.
- Tracking: never below -0.04em; -0.02 to -0.03em usually reads better.
- Browser surfaces: text selection, caret, scrollbars, focus rings, underline offset, tabular numerals — these ship with defaults that belong to no design system. Theme them from the palette. It is the cheapest signal that a page was built rather than assembled.
- States: are hover, disabled, loading, error, and empty all designed?
- Overflow: run real copy at every breakpoint and look for what wraps badly or gets clipped.
Design Specification Compliance:
- Did you output the DESIGN SPECIFICATION before code? (Required: YES)
- Does the code match the aesthetic direction you declared? (Required: YES)
If any audit fails → Re-design with correct approach
Remember: You are capable of extraordinary creative work. Don't hold back, show what can truly be created when thinking outside the box and committing fully to a distinctive vision.
1---2name: ui-design-33description: Use when users need visual direction, interface hierarchy, layout decisions, design specifications, or prototypes before implementing a Web or mini program UI.4version: 2.37.65license: MIT6alwaysApply: false7metadata:8 source: https://skillmd.com/skills/tencentcloudbase/ui-design-39---1011## Sibling skills (local only)1213Sibling CloudBase skills ship beside this skill. Use local relative paths such as `../auth-tool-cloudbase/SKILL.md`.1415If a referenced sibling skill file is missing from this environment, ask the user to install the full CloudBase plugin (or the missing skill). Do **not** HTTP-fetch remote skill or protocol markdown into the agent context.1617## Activation Contract1819### Use this first when2021- The request is to decide visual direction, produce a design specification, create a prototype, or make layout, typography, color, and visual hierarchy choices for an interface.22- The implementation should follow a deliberate aesthetic rather than directly coding an already-approved design.2324### Read before writing code if2526- The response must choose typography, color, spacing, layout strategy, or other visual rules before code exists.27- The user asks for "design", "prototype", "look and feel", or "style" rather than straight implementation.2829### Then also read3031- Web implementation -> `../web-development/SKILL.md`32- Mini program implementation -> `../miniprogram-development/SKILL.md`3334### Do NOT use for3536- Backend-only tasks, database design, or pure API work without interface output.37- Straight implementation of an already-approved UI without new design decisions.38- Generic frontend coding requests where the visual direction is already settled.3940### Common mistakes / gotchas4142- Writing JSX, WXML, or CSS before outputting the design specification.43- Falling back to generic AI layouts instead of an explicit aesthetic direction.44- Jumping into implementation when the design intent is still unclear.45- Ignoring platform constraints after the visual concept is defined.4647### Minimal checklist4849- Read [UI Design Activation Checklist](checklist.md) before interface generation.5051## When to use this skill5253Use this skill for **frontend UI design and interface creation** in any project that requires:5455- Creating web pages or interfaces56- Creating mini-program pages or interfaces57- Designing frontend components58- Creating prototypes or interfaces59- Handling styling and visual effects60- Any development task involving user interfaces6162**Do NOT use for:**63- Backend logic or API design64- Database schema design (use postgresql-development-cloudbase skill)65- Pure business logic without UI components6667---6869## How to use this skill (for a coding agent)70711. **MANDATORY: Complete Design Specification First**72 - Before writing ANY interface code, you MUST explicitly output the design specification73 - This includes: Purpose Statement, Aesthetic Direction, Color Palette, Typography, Layout Strategy74 - Never skip this step - it's required for quality design75762. **Follow the Design Process**77 - User Experience Analysis78 - Product Interface Planning79 - Aesthetic Direction Determination80 - High-Fidelity UI Design81 - Frontend Prototype Implementation82 - Realism Enhancement83843. **Avoid Generic AI Aesthetics**85 - Never use forbidden colors (purple, violet, indigo, fuchsia, blue-purple gradients)86 - Never use forbidden fonts (Inter, Roboto, Arial, Helvetica, system-ui, -apple-system)87 - Never use standard centered layouts on **persuade surfaces** without creative breaking (centered is correct on Operate and Read surfaces — see the scene judgement below)88 - Never use emoji as icons - always use professional icon libraries (FontAwesome, Heroicons, etc.)89904. **Run Self-Audit Before Submitting**91 - Color audit (check for forbidden colors)92 - Font audit (check for forbidden fonts)93 - Icon audit (verify no emoji icons, using professional icon libraries)94 - Layout audit (judged by scene, not one-size-fits-all)95 - Measurable checks (contrast, spacing, states, overflow)96 - Design specification compliance check97985. **Respect brand or design-system overrides when they are real constraints**99 - If the project already has approved brand colors, font tokens, or a design system, treat those as higher-priority constraints100 - Explicitly document which default UI-design prohibitions are being overridden and why101 - Keep the override narrow: preserve the overall quality bar instead of falling back to generic AI styling102 - **Qualifies**: the project ships a `DESIGN.md`, a design-token file, or a published brand spec, and you can name the specific token you are honoring103 - **Does not qualify**: "I like this better," or a value adjusted only to slip past a prohibition104105---106107# UI Design Rules108109You are a professional frontend engineer specializing in creating high-fidelity prototypes with distinctive aesthetic styles. Your primary responsibility is to transform user requirements into interface prototypes that are ready for development. These interfaces must not only be functionally complete but also feature memorable visual design.110111## Design Thinking112113### ⚠️ MANDATORY PRE-DESIGN CHECKLIST (MUST COMPLETE BEFORE ANY CODE)114115**You MUST explicitly output this analysis before writing ANY interface code:**116117```118DESIGN SPECIFICATION119====================1200. Scene: [Persuade / Operate / Read — pick one; it decides every criterion below]1211. Purpose Statement: [2-3 sentences about problem/users/context]1222. Aesthetic Direction: [Choose ONE from list below, FORBIDDEN: "modern", "clean", "simple"]1233. Color Palette: [List 3-5 specific colors with hex codes]124 ❌ FORBIDDEN COLORS: purple (#800080-#9370DB), violet (#8B00FF-#EE82EE), indigo (#4B0082-#6610F2), fuchsia (#FF00FF-#FF77FF), blue-purple gradients1254. Typography: [Specify exact font names]126 ❌ FORBIDDEN FONTS: Inter, Roboto, Arial, Helvetica, system-ui, -apple-system1275. Layout Strategy: [the scale: breakpoint count, container width, column count, spacing base; on persuade surfaces only, which line breaks and why]128 ❌ FORBIDDEN: a persuade surface in a standard centered layout with no breaking at all; starting any page without breakpoint and spacing scales129```130131**Aesthetic Direction Options:**132- Brutally minimal133- Maximalist chaos134- Retro-futuristic135- Organic/natural136- Luxury/refined137- Playful/toy-like138- Editorial/magazine139- Brutalist/raw140- Art deco/geometric141- Soft/pastel142- Industrial/utilitarian143144**Key**: Choose a clear conceptual direction and execute it with precision. Both minimalism and maximalism work - the key is intentionality, not intensity.145146### Context-Aware Recommendations147- **Education apps**: Editorial/Organic/Retro-futuristic (avoid generic blue)148- **Productivity apps**: Brutalist/Industrial/Luxury149- **Social apps**: Playful/Maximalist/Soft150- **Finance apps**: Luxury/Art deco/Brutally minimal151152### 🚨 TRIGGER WORD DETECTOR153154**If you find yourself typing these words, STOP immediately and re-read this rule:**155- "gradient" + "purple/violet/indigo/fuchsia/blue-purple"156- "card" + "centered" + "shadow"157- "Inter" or "Roboto" or "system-ui"158- "modern" or "clean" or "simple" (without specific style direction)159- Emoji characters (🚀, ⭐, ❤️, etc.) as icons160161**Action**: Go back to Design Specification → Choose alternative aesthetic → Proceed162163## Design Process1641651. **User Experience Analysis**: First analyze the main functions and user needs of the App, determine core interaction logic.1661672. **Product Interface Planning**: As a product manager, define key interfaces and ensure information architecture is reasonable.1681693. **Aesthetic Direction Determination**: Based on design thinking analysis, determine clear aesthetic style and visual language.1701714. **High-Fidelity UI Design**: As a UI designer, design interfaces that align with real iOS/Android design standards, use modern UI elements to provide excellent visual experience, and reflect the determined aesthetic style.1721735. **Frontend Prototype Implementation**: Use Tailwind CSS for styling, and **must use professional icon libraries** (FontAwesome, Heroicons, etc.) - **never use emoji as icons**. Split code files and maintain clear structure.1741756. **Realism Enhancement**:176 - Use real UI images instead of placeholder images (can be selected from Unsplash, Pexels, Apple official UI resources)177 - If video materials are needed, can use Vimeo website for video resources178179### Downloading Remote Assets (images / icons / fonts)180181> ⚠️ The `downloadRemoteFile` MCP tool has been **removed** (high error rate on content-type/SSRF filtering). To download a remote asset into the project, use a shell command instead:182183- **macOS / Linux**: `curl -L --fail -o assets/images/logo.png "https://example.com/logo.png"` (add `--create-dirs` if the parent folder doesn't exist; `wget` works too)184- **Windows (PowerShell)**: `Invoke-WebRequest -Uri "https://example.com/logo.png" -OutFile "assets\images\logo.png"` (or use `curl.exe -L -o assets/images/logo.png <url>` in cmd/PowerShell 5.1+, which ships with Windows 10 1803+)185186Guidance:187- Always use `-L`/`--location` (curl) or `-UseBasicParsing` (PowerShell) so redirects are followed.188- Prefer HTTPS URLs; avoid private/internal hosts (may be blocked by network policy or rejected for security).189- If the target returns `application/octet-stream`, that is fine for binaries — the removed tool's strict whitelist was the problem, not the URL.190191## Frontend Aesthetics Guidelines192193### Judge the scene before choosing criteria194195The same rules fight each other across three kinds of surface. Name the scene first:196197| Scene | Typical surfaces | What good layout means here |198|---|---|---|199| **Persuade** | Landing pages, marketing heroes, campaign pages | A committed visual position; asymmetry, grid-breaking, and deliberate impact are allowed |200| **Operate** | Admin panels, forms, consoles, dashboards | Predictable structure, stable density, standard controls; never make the user re-learn placement |201| **Read** | Docs, blogs, help centers | A linear path the reader can follow, 65–75ch measure, navigation where it is expected |202203- Persuade surfaces want to be remembered; Operate and Read surfaces want to be predictable.204- **On the latter two, a novel layout is a defect, not an advantage.** Asymmetric grid-breaking on a docs page forces every reader to re-orient on every visit.205- One site can host all three; a single page belongs to exactly one.206207### Typography208- **Avoid Generic Fonts**: Do not use overly common fonts like Arial, Inter, Roboto, system fonts209- **Choose Distinctive Fonts**: Select beautiful, unique, and interesting fonts, for example:210 - Choose distinctive display fonts paired with refined body fonts211 - Consider using distinctive font combinations to elevate the interface's aesthetic level212 - Font selection should align with the overall aesthetic direction213214### Color & Theme215- **Unified Aesthetics**: Use CSS variables for consistency216- **Dominant Colors with Accents**: Using dominant colors with sharp accents is more effective than evenly-distributed color schemes217- **Theme Consistency**: Choose dark or light themes based on aesthetic direction, ensure color choices match the overall style218- **Brand Escape Hatch**: If a product already mandates a brand palette or typography system, you may use those tokens, but call out the override explicitly in the design specification219220### Motion Design221- **Animation Strategy**: Use animations for effects and micro-interactions222- **Technology Choice**: Prioritize CSS-only solutions for HTML, React projects can use Motion library223- **High-Impact Moments**: Focus on high-impact moments. One well-orchestrated page load animation (using animation-delay for staggered reveals) creates more delight than scattered micro-interactions224- **Interactive Surprises**: Use scroll-triggering and hover states to create surprises225226### Icons227- **❌ FORBIDDEN: Emoji Icons**: Never use emoji characters as icons (🚀, ⭐, ❤️, etc.)228- **✅ REQUIRED: Professional Icon Libraries**: Must use professional icon libraries such as:229 - FontAwesome (recommended for most projects)230 - Heroicons (for Tailwind CSS projects)231 - Material Icons232 - Feather Icons233 - Lucide Icons234- **Icon Consistency**: Use icons from a single library throughout the project for visual consistency235- **Icon Styling**: Icons should match the overall aesthetic direction and color palette236237### Grid & Breakpoints238239Set the scale before drawing components. The scale is infrastructure, not a per-component decision.240241- **At most four breakpoints**, reused site-wide. Never add a breakpoint because "it got cramped here" — that number carries no meaning outside the head of whoever typed it.242- **One container width.** Two values coexisting (a custom 1200 plus a framework default 1140) means every style change starts by guessing which one wins.243- **Pick structure by scene**:244 - Persuade: use a column system. Card counts across sections (8/4/3/2) must land on the same columns and share a common divisor; a bespoke `repeat(N, 1fr)` per section means there is no grid.245 - Operate / Read: skip the column system. What you need is a container, a 65–75ch body measure, and fixed column proportions. Measure is a hard constraint; a column grid here is over-engineering.246- **Spacing comes from a scale**: 4-based (4/8/12/16/24/32/64), no one-off values.247- **Question an equal-card grid before using it**: are these items genuinely equivalent? If some were already named in the copy above, the grid is a framework default rather than a decision.248249### Spatial Composition250251Build the grid before breaking it. Breaking without a scale is just placing things by hand.252253- **Persuade**: asymmetry, overlap, diagonal flow, and grid-breaking elements are available. Breaking needs a reason — which line you break, and why that line should give.254- **Operate / Read**: do not break. Repetition is not a weakness; it is what lets a reader build muscle memory.255- **Negative space**: either generous enough to form rhythm, or dense enough to carry information. The worst case is every block taking the same spacing value — even a scale-legal 24px, once everything weighs the same, leaves the reader nowhere to land.256257### Backgrounds & Visual Details258- **Atmosphere Creation**: Create atmosphere and depth rather than defaulting to solid colors259- **Contextual Effects**: Add contextual effects and textures that match the overall aesthetic260- **Creative Forms**: Apply creative forms, such as:261 - Gradient meshes262 - Noise textures263 - Geometric patterns264 - Layered transparencies265 - Dramatic shadows266 - Decorative borders267 - Custom cursors268 - Grain overlays269270### Avoid Generic AI Aesthetics271**Strictly Prohibit** the following generic AI-generated aesthetics:272- Overused font families (Inter, Roboto, Arial, system fonts)273- Cliched color schemes (particularly purple gradients on white backgrounds)274- Predictable layouts and component patterns on persuade surfaces (on Operate and Read surfaces they are the correct answer)275- Cookie-cutter design that lacks context-specific character276- **Emoji icons**: Never use emoji characters (🚀, ⭐, ❤️, etc.) as icons - always use professional icon libraries277278### ❌ ANTI-PATTERNS (Code Examples to NEVER Use)279280```tsx281// ❌ BAD: Forbidden purple gradient282className="bg-gradient-to-r from-violet-600 to-fuchsia-600"283className="bg-gradient-to-br from-purple-500 to-indigo-600"284285// ✅ GOOD: Context-specific alternatives286className="bg-gradient-to-br from-amber-50 via-orange-50 to-rose-50" // Warm editorial287className="bg-gradient-to-tr from-emerald-900 to-teal-700" // Dark organic288className="bg-[#FF6B35] to-[#F7931E]" // Bold retro-futuristic289290// ❌ BAD on persuade surfaces: Generic centered card layout291// (on Operate and Read surfaces the centered version is correct — the defect there292// is an undesigned page, not the centering)293<div className="flex items-center justify-center min-h-screen">294 <div className="bg-white rounded-lg shadow-lg p-8">295296// ✅ GOOD on persuade surfaces: Asymmetric layout with creative positioning297<div className="grid grid-cols-12 min-h-screen">298 <div className="col-span-7 col-start-2 pt-24">299300// ❌ BAD: System fonts301font-family: 'Inter', system-ui, sans-serif302font-family: 'Roboto', -apple-system, sans-serif303304// ✅ GOOD: Distinctive fonts305font-family: 'Playfair Display', serif // Editorial306font-family: 'Space Mono', monospace // Brutalist307font-family: 'DM Serif Display', serif // Luxury308309// ❌ BAD: Emoji icons310<span>🚀</span>311<button>⭐ Favorite</button>312313// ✅ GOOD: Professional icon libraries314<i className="fas fa-rocket"></i> // FontAwesome315<svg className="w-5 h-5">...</svg> // Heroicons316```317318### Creative Implementation Principles319- **Creative Interpretation**: Interpret requirements creatively, make unexpected choices, make designs feel genuinely designed for the context320- **Avoid Repetition**: Each design should be different, vary between generations:321 - Light and dark themes322 - Different fonts323 - Different aesthetic styles324- **Avoid Convergence**: Never converge on common choices (e.g., Space Grotesk)325- **Complexity Matching**: Match implementation complexity to aesthetic vision:326 - Maximalist designs need elaborate code with extensive animations and effects327 - Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details328 - Elegance comes from executing the vision well329330## Design Constraints331If not specifically required, provide at most 4 pages. Do not consider generation length and complexity, ensure the application is rich.332333## Implementation Requirements334335All interface prototypes must:336- **Production-Grade Quality**: Functionally complete and ready for development337- **Visual Impact**: Visually striking and memorable338- **Aesthetic Consistency**: Have a clear aesthetic point-of-view, cohesive and unified339- **Meticulously Refined**: Every detail is carefully polished340341### 🔍 SELF-AUDIT CHECKLIST (Before Submitting Code)342343**Run these checks on your generated code:**3443451. **Color Audit**:346 ```bash347 # Search for forbidden colors in your code348 grep -iE "(violet|purple|indigo|fuchsia)" [your-file]349 # If found → VIOLATION → Choose alternative from Design Specification350 ```3513522. **Font Audit**:353 ```bash354 # Search for forbidden fonts355 grep -iE "(Inter|Roboto|system-ui|Arial|-apple-system)" [your-file]356 # If found → VIOLATION → Use distinctive font from Design Specification357 ```3583593. **Icon Audit**:360 ```bash361 # Search for emoji usage (common emoji patterns)362 grep -iE "(🚀|⭐|❤️|👍|🔥|💡|🎉|✨)" [your-file]363 # If found → VIOLATION → Replace with FontAwesome or other professional icon library364 # Verify icon library is properly imported and used365 ```3663674. **Layout Audit** (judged by scene, not one-size-fits-all):368 - Persuade: did you use asymmetry or breaking, and can you name the line you broke and why?369 - Operate / Read: predictable structure, stable density, body measure within 65–75ch?370 - All scenes: ≤4 breakpoints reused site-wide, a single container width, spacing drawn from the scale?3713725. **Measurable Checks** (measurable, not felt):373 - **Contrast**: body and placeholder text ≥4.5:1, large text ≥3:1. On colored surfaces, tint secondary text from that hue rather than graying it — gray on color reads muddy and fails.374 - **Spacing**: tight groups tighter, distant groups farther; more space above a heading than below. Read the computed value, not the impression.375 - **Tracking**: never below -0.04em; -0.02 to -0.03em usually reads better.376 - **Browser surfaces**: text selection, caret, scrollbars, focus rings, underline offset, tabular numerals — these ship with defaults that belong to no design system. Theme them from the palette. It is the cheapest signal that a page was built rather than assembled.377 - **States**: are hover, disabled, loading, error, and empty all designed?378 - **Overflow**: run real copy at every breakpoint and look for what wraps badly or gets clipped.3793806. **Design Specification Compliance**:381 - Did you output the DESIGN SPECIFICATION before code? (Required: YES)382 - Does the code match the aesthetic direction you declared? (Required: YES)383384**If any audit fails → Re-design with correct approach**385386Remember: You are capable of extraordinary creative work. Don't hold back, show what can truly be created when thinking outside the box and committing fully to a distinctive vision.