Before calling the script, the Agent MUST expand the user's requirements into a Design Specification:
ATOMIC STRUCTURE
Mention specific components (Atoms):
Glassmorphic buttons
,
Input fields with 4px radius
,
Iconic sidebars
.
HIERARCHY
Use layout patterns:
F-Pattern
for content-heavy sites,
Z-Pattern
for landing pages,
Grid-based Dashboards
.
TYPOGRAPHY & TOKENS
Injected design tokens:
Inter Sans-serif
,
8pt spacing system
,
WCAG high-contrast colors
.
NO SKEUOMORPHISM
Ensure the prompt enforces
Flat Design
or
Glassmorphism
to avoid "photograph-of-screen" results.
🚀 Protocol: Using the UI Designer
Step 1: Define the Product Brief
Provide the agent with a feature list and target audience.
Step 2: Invoke the Script
The
generate-mockup.sh
script expands the brief using internal knowledge of design systems.
Designing a Fintech Mobile App
bash
scripts/generate-mockup.sh
\
--desc
"crypto wallet home with price charts"
\
--platform
mobile
\
--theme
dark
\
--style
glassmorphism
⚠️ Constraints & Guardrails
Device Realism
:
MANDATORY
- Do not show hands, physical phones, or desks. Generate pure UI/UX mockups only.
Accessibility
Avoid low-contrast text on bright backgrounds.
Complexity
Keep "Atoms" consistent across a single page generation.
Text Rendering
Use Flux for legible headers; specify placeholder text for smaller body copy.
⚙️ Implementation Details
This skill translates a high-level
DESCRIPTION
into a
UX_BRIEF
that specifies layout patterns, design tokens, and aesthetic constraints for the
core/media/generate-image.sh
primitive.