Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.figr.design/llms.txt

Use this file to discover all available pages before exploring further.

​
Click to Refine

Transform AI-generated designs with precise, contextual edits. Figr’s click-to-refine system lets you adjust any element while maintaining design system consistency and product context.

​
How Click-to-Refine Works

1

Element Selection

Click any design element for instant refinement options:
Interface showing contextual editing options when clicking on a button element
What you can refine:
Visual elements:
- Colors and backgrounds
- Typography and text content
- Spacing and sizing
- Borders and shadows
- Images and icons

Interactive elements:
- Button states and styling
- Form inputs and validation
- Navigation behaviors
- Link destinations and styling
- Interactive feedback

Layout elements:
- Component positioning
- Grid and alignment
- Responsive behavior
- Content hierarchy
- Whitespace distribution
2

Contextual Suggestions

Smart refinement options based on element context:
Context-aware button options:
Style variations:
- Primary → Secondary button style
- Size: Small → Medium → Large
- Shape: Square → Rounded → Pill
- State: Default → Hover → Disabled

Content adjustments:
- Text: "Submit" → "Save Changes"
- Icon: Add checkmark or arrow
- Loading: Add spinner state
- Confirmation: Add success state

Behavioral changes:
- Action: Form submit → Page navigation
- Validation: Add form validation trigger
- Feedback: Success message display
3

Design System Compliance

Maintain consistency while editing:
System validation:
- Color palette compliance
- Typography scale adherence
- Spacing system alignment
- Component pattern consistency
- Brand guideline compliance

Suggestions when off-system:
"Custom color #ff6b35 detected"
→ "Use brand orange: #f59e0b instead?"
→ "Add to design system as new accent color?"

System-compliant options:

Color selection:
- Brand palette priorities
- Accessibility-compliant combinations
- Semantic color meanings
- Dark mode considerations

Typography choices:
- Hierarchy-appropriate sizes
- Weight combinations that work
- Line height optimization
- Reading experience improvements

​
Editing Modes

Instant refinements for common changes:

One-Click Fixes

Common quick adjustments:
  • Make button primary/secondary
  • Increase/decrease text size
  • Add/remove element spacing
  • Change color to brand palette
  • Toggle between light/dark variants

Smart Suggestions

AI-powered improvements:
  • “Make this more accessible”
  • “Optimize for mobile”
  • “Improve visual hierarchy”
  • “Match existing patterns”
  • “Enhance call-to-action”

​
Context-Aware Refinements

1

User Context Application

Edits informed by your user research:
Editing suggestions based on user data:

"Users often miss this button"
→ Increase size and contrast
→ Add icon for better recognition
→ Move to more prominent location

"Mobile users struggle with this form"
→ Larger touch targets
→ Simplified input methods
→ Better error messaging

"Users expect this action here"
→ Relocate to standard position
→ Use familiar interaction pattern
→ Add supporting context

Automatic accessibility enhancements:

Color contrast: Suggest WCAG-compliant alternatives
Touch targets: Ensure 44px minimum size
Focus indicators: Add visible focus states
Screen readers: Improve alt text and labels
Keyboard navigation: Enhance tab order
2

Technical Context Integration

Edits that consider implementation reality:
Performance-aware suggestions:

Image optimization:
"Large image detected" → "Compress or use WebP format?"

Animation efficiency:
"Complex animation" → "Use CSS transforms for better performance?"

Layout optimization:
"Nested flexbox" → "Consider CSS Grid for this layout?"
3

Brand Context Maintenance

Keep edits aligned with brand guidelines:
Brand consistency checks:

Color usage:
"Off-brand color detected"
→ Show nearest brand-compliant alternatives
→ Explain color meaning and usage

Typography hierarchy:
"Heading level inconsistent"
→ Suggest proper hierarchy level
→ Show content structure implications

Component patterns:
"Custom component created"
→ Check against existing patterns
→ Suggest standardization opportunities

​
Advanced Refinement Features

Describe changes in plain English:
Interface showing natural language input for design changes
Example commands:
Content changes:
"Make this heading larger and blue"
"Change button text to 'Get Started'"
"Add an icon to this button"
"Make this text easier to read"

Layout adjustments:
"Move this button to the right"
"Add more space between these elements"
"Make this section full width"
"Stack these elements on mobile"

Style modifications:
"Make this look more like our other buttons"
"Increase the contrast for accessibility"
"Round the corners more"
"Add a subtle shadow"

​
Best Practices for Effective Refinement

Systematic Editing

Organized refinement approach:✅ Start with content and hierarchy ✅ Refine layout and spacing ✅ Adjust visual styling last ✅ Test refinements on different devices ✅ Validate against design system

User-Centered Refinements

Keep user needs central:✅ Consider accessibility in every edit ✅ Test changes with real users ✅ Maintain familiar interaction patterns ✅ Optimize for primary user tasks ✅ Document refinement reasoning

​
Common Refinement Scenarios

Problem: Low click-through rates on CTA button

Refinements applied:
- Color: Changed to high-contrast brand primary
- Size: Increased to improve visibility
- Text: Made more action-oriented
- Position: Moved above the fold
- Context: Added supporting benefit text

Result: 23% improvement in conversion

Problem: Desktop design difficult to use on mobile

Refinements applied:
- Touch targets: Increased to 44px minimum
- Navigation: Simplified to essential items
- Text: Increased size for readability
- Spacing: Optimized for thumb navigation
- Forms: Streamlined input requirements

Result: 35% reduction in mobile bounce rate

Problem: Design fails accessibility audit

Refinements applied:
- Contrast: Improved color contrast ratios
- Focus: Added visible focus indicators
- Labels: Enhanced form input labels
- Structure: Improved heading hierarchy
- Alt text: Added descriptive image alt text

Result: WCAG 2.1 AA compliance achieved

Explore Micro-Improvements

Learn how to make small but impactful refinements that significantly enhance user experience.Micro Improvements →