> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stardeck.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Refining and Polishing

> Iterate on your app until it's exactly what you want

## Keep the Conversation Going

Building your app is an iterative process. After the initial build, you'll likely want to make changes—and that's expected. Just keep talking to the agent.

**Request changes naturally:**

* "Make the header stick to the top when I scroll"
* "The hero section should be taller with more padding"
* "Can you use a warmer color palette?"
* "Add a testimonials section after the features"
* "The contact form needs a phone number field"

The agent understands context. You don't need to re-explain your whole app—just describe what you want changed.

## Types of Refinements

### Design Adjustments

Fine-tune the visual appearance:

* Colors, fonts, and spacing
* Layout and positioning
* Image sizes and placement
* Responsive behavior on mobile
* Animations and transitions

**Example prompts:**

* "Make the buttons rounder with more padding"
* "Use a larger font size for headings"
* "Add more whitespace between sections"

### Content Changes

Update text and media:

* Headlines and body copy
* Images and icons
* Links and navigation labels
* Form field labels and placeholders

**Example prompts:**

* "Change the tagline to 'Fresh baked daily since 1985'"
* "Replace the hero image with this one" (upload new image)
* "The About page needs more detail about our history"

### Feature Additions

Add new functionality:

* New pages or sections
* Forms and interactive elements
* User authentication
* Payment processing
* Email notifications

**Example prompts:**

* "Add a gallery page for our work samples"
* "I need a newsletter signup form in the footer"
* "Add a FAQ section with expandable questions"

### Structural Changes

Reorganize how your app works:

* Navigation structure
* Page hierarchy
* User flows
* Data relationships

**Example prompts:**

* "Move the pricing page under Services in the nav"
* "Split the Services page into individual pages for each service"
* "Add a dashboard that customers see after logging in"

## Testing as You Go

The live preview lets you test your app in real-time. Use it to catch issues early.

<AccordionGroup>
  <Accordion title="Navigate every page">
    Click through all pages and sections. Check that links work and content displays correctly.
  </Accordion>

  <Accordion title="Test on mobile">
    Switch to the mobile viewport in the preview toolbar. Verify layouts adapt properly to smaller screens.
  </Accordion>

  <Accordion title="Try all interactions">
    Submit forms, click buttons, use any interactive features. Make sure they work as expected.
  </Accordion>

  <Accordion title="Check edge cases">
    What happens with long text? Missing images? Empty states? Test unusual scenarios.
  </Accordion>
</AccordionGroup>

When you find issues, describe them to the agent:

* "The menu doesn't close after clicking a link on mobile"
* "The form submits but I don't see a confirmation message"
* "The images are stretched on the gallery page"

For the workflows your business depends on—checkout, booking, orders—you don't have to re-check them by hand every time. Ask the agent to [cover them with automated tests](/testing), and they'll run on every deploy from then on. Better yet, [describe the tests before the agent builds a feature](/test-driven-development) so you agree on what "done" means up front.

## Tips for Effective Refinement

### Be Specific

The more precise you are, the better the result:

| Vague                 | Specific                                                   |
| --------------------- | ---------------------------------------------------------- |
| "Make it look better" | "Add more whitespace and use a softer color palette"       |
| "Fix the layout"      | "The sidebar should be fixed while the content scrolls"    |
| "It feels off"        | "The font is too small and the buttons need more contrast" |

### Share Visual References

If you have a specific look in mind, show it:

* Screenshot a website you like
* Share a design mockup
* Upload an example image

The agent can see images and understand what you're going for.

### Iterate in Stages

Don't try to fix everything at once. Focus on one area at a time:

1. Get the structure right first
2. Then refine the design
3. Then polish the details

### Ask the Agent for Help

Not sure what's missing? Ask:

* "What would make this page more engaging?"
* "How do other sites in this industry handle this?"
* "What's the best way to display this content?"

***

<Card title="Next: Going Live" icon="arrow-right" href="/getting-started/going-live">
  Learn how to publish your app and manage it long-term
</Card>