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

# Design your app

> Use Design mode to shape how your app looks, screen by screen.

export const AiPrompt = ({children}) => {
  return <CodeBlock className="relative block font-sans whitespace-pre-wrap break-words">
      <div className="pr-7">
        {children}
      </div>
    </CodeBlock>;
};

export const designPrompt = "Create five different designs for the game menu, where players choose between Blocks, Snake, Racer, and Pinball, and see the top scores for each.";

How your app looks is as much a part of it as what it does. PixelGames is a Game Boy on a
phone: the cream shell, the olive-green screen, and the chunky buttons are the whole point.
A generic app layout would lose it.

<Steps>
  <Step title="Switch to Design mode">
    Switch to Design mode on the toggle at the top left of your workspace:

    <Frame caption="The Design and Build toggle with Design selected in the PixelGames workspace.">
      <img src="https://mintcdn.com/replit/WuaQIOfW5oxRlxex/images/pixelgames/mobile/design-step-1.png?fit=max&auto=format&n=WuaQIOfW5oxRlxex&q=85&s=8cbcacf95a04c466f273586b54c4acbb" alt="Replit Design canvas with Design selected in the top-left toggle and five PixelGames menu variants" data-path="images/pixelgames/mobile/design-step-1.png" width="1284" height="871" data-path="images/pixelgames/mobile/design-step-1.png" />
    </Frame>
  </Step>

  <Step title="Describe what you want to Agent">
    Describe the result and Agent handles the rest. Ask for several versions at once to find a direction.

    <AiPrompt>
      {designPrompt}
    </AiPrompt>
  </Step>

  <Step title="Compare the versions">
    Agent lays them out side by side on the canvas, so you judge them as whole screens rather
    than one at a time.
  </Step>

  <Step title="Pick one and see where to take it">
    Select a design, then use the suggestions that appear next to it to try other variations.

    <Frame caption="A selected design, with suggested next steps beside it.">
      <img src="https://mintcdn.com/replit/WuaQIOfW5oxRlxex/images/pixelgames/mobile/design-step-2.png?fit=max&auto=format&n=WuaQIOfW5oxRlxex&q=85&s=dba067f0c15dde736af003a7fd768185" alt="A selected PixelGames menu design with suggested next steps: integration, comparison, remix, and reimagining" data-path="images/pixelgames/mobile/design-step-2.png" width="1284" height="871" data-path="images/pixelgames/mobile/design-step-2.png" />
    </Frame>
  </Step>

  <Step title="Build the version you want">
    Once a version is right, click the send icon in the toolbar above it. Agent takes that
    design off the canvas and builds it as a real screen in your app.

    <Frame caption="The send icon turns the selected design into a real screen.">
      <img src="https://mintcdn.com/replit/WuaQIOfW5oxRlxex/images/pixelgames/mobile/design-step-3.png?fit=max&auto=format&n=WuaQIOfW5oxRlxex&q=85&s=9006dbe90f73b24de3db94d75cadcd84" alt="A PixelGames menu design selected on the canvas with the send icon highlighted in the toolbar" data-path="images/pixelgames/mobile/design-step-3.png" width="1284" height="846" data-path="images/pixelgames/mobile/design-step-3.png" />
    </Frame>
  </Step>
</Steps>

## Troubleshooting

* **The change went further than you wanted:** ask Agent to revert it and describe a smaller
  change, one screen or one element at a time.
* **It looks right in preview, wrong on a phone:** name the device and what you saw, safe
  area and screen size handling are the usual causes.
* **A change keeps getting undone:** the same value may be set in more than one place, ask
  Agent where the styling for that screen actually lives.

## What's next

<CardGroup cols={2}>
  <Card title="Generate an app icon" icon="image" href="/build/mobile-app-icon">
    Design the icon players tap on their home screen.
  </Card>

  <Card title="Use iOS native components" icon="apple" href="/build/mobile-native-components">
    Pair a custom look with native alerts and menus.
  </Card>
</CardGroup>

## Related

* [Generate App Store screenshots](/build/mobile-store-screenshots)
* [Preview and test on your phone](/build/mobile-preview-testing)
