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

# Design

Design is QoderWork's first vertical workspace — an AI-native "design as code" surface where you describe what you want and ship a runnable, editable, handoff-ready design on an infinite canvas.

Unlike traditional design tools that center on cloud-based vector editing, Design treats design output as a code asset that the team co-owns. From the very first step, designers and engineers operate on the same runnable file, and the design product can be handed off to Qoder IDE in a single click — no lossy export between design and development.

## Use cases

### Designers — targeted iteration, multi-surface collaboration

Traditional flows force designers to slice, re-export, update annotations, sync with engineers, and verify the final pixels. Design pulls iteration back into the canvas: lasso a region, mark intent, and the agent adjusts based on canvas context. Use Nudge to fine-tune color and spacing in real time. The output keeps a readable, hand-offable engineering structure.

### Product managers — high-fidelity prototypes, ready when you are

Hi-fi prototypes communicate design direction clearly but typically depend on the design team's bandwidth. With Design, structured Questions align intent, the Design Plan confirms direction, and the canvas produces a clickable, design-grade prototype you can take straight into a review or stakeholder demo.

### Marketing & operations — many directions in parallel

A single campaign needs key visuals, banners, and landing pages, but design bandwidth often forces a single direction. With Design, you describe theme and tone, confirm via the Design Plan, and switch entries under **Auto Style Reference** to generate parallel directions covering posters, banners, and landing pages.

## How it works

Design reshapes how AI produces design through three mechanisms:

* **Questions** — when input isn't enough, the agent asks structured questions to align intent first instead of guessing. Less wasted iteration.
* **Design Plan** — before generation, the agent produces a structured plan (layout, style, content hierarchy) under the **Plan** tab. You confirm, then it executes.
* **Nudge** — after generation, key decisions like color, spacing, and corner radius are exposed as adjustable parameters. Fine-tune them without re-describing the brief.

## Workspace

<Frame>
  <img src="https://mintcdn.com/qoder/hjCzjGvcnHE5UJIx/images/qoderwork-design-en.png?fit=max&auto=format&n=hjCzjGvcnHE5UJIx&q=85&s=551a02818157ae32dab45f883906e1d7" alt="Design workspace full view: left task panel summarizes the CodePilot AI Coding Agent homepage build — sticky nav with brand mark, hero with Linear-inspired dark theme, dual CTAs (Start free / Book a demo), product UI preview, customer testimonial, footer; center canvas renders the dark hero &#x22;Ship production code with AI that understands your codebase&#x22;; right Nudge panel exposes COLORS (Brand Color), DENSITY (Spacing Scale), SHAPE (Corner Radius), THEME (Appearance Dark)" width="2000" height="1386" data-path="images/qoderwork-design-en.png" />
</Frame>

The right side of the window has five tabs:

| Tab                  | What it does                                                    |
| :------------------- | :-------------------------------------------------------------- |
| **Canvas**           | The infinite design surface where the agent generates and edits |
| **Design Files**     | The underlying engineering files behind what's on the canvas    |
| **Preview**          | Preview the running design as a real interface                  |
| **Style References** | View and switch the active style reference used by the design   |
| **Plan**             | The structured Design Plan the agent uses before generating     |

## Creating a design

<Steps>
  <Step title="Switch to Design">
    In the input box at the bottom of the QoderWork home, click the workspace switcher (defaults to **General**) and choose **Design**.

    <Frame>
      <img src="https://mintcdn.com/qoder/hjCzjGvcnHE5UJIx/images/qoderwork-design-step1-en.png?fit=max&auto=format&n=hjCzjGvcnHE5UJIx&q=85&s=5cfc23047cab2df04ae399e0f191949f" alt="QoderWork home with greeter &#x22;Ideas become products. Design becomes code.&#x22; and subtitle &#x22;Describe the goal and QoderWork will plan the structure, generate the interface, and keep the preview in sync.&#x22;; the input shows the workspace switcher dropdown open listing General / Design (checked) / Slides Beta / Writing Beta, with Work in a Folder / Auto Style Reference / High fidelity / No library toolbar buttons below" width="2000" height="1386" data-path="images/qoderwork-design-step1-en.png" />
    </Frame>

    <Tip>The default workspace can be changed in QoderWork settings — set Design as your default if it's the surface you live in.</Tip>
  </Step>

  <Step title="Describe what you want">
    Type or dictate the brief. Be concrete about purpose, key sections, and tone — for example: *"Design a high-fidelity AI product homepage with brand navigation, a strong headline, product value proposition, primary CTA, secondary CTA, product UI preview, and customer trust proof. Make it modern, credible, and refined."*

    Paste screenshots and links directly into the input. Click the microphone icon for [voice input](/qoderwork/voice-input).

    <Frame>
      <img src="https://mintcdn.com/qoder/hjCzjGvcnHE5UJIx/images/qoderwork-design-step2-en.png?fit=max&auto=format&n=hjCzjGvcnHE5UJIx&q=85&s=6db39120240bcc51f22a900c5d65e9b0" alt="QoderWork home with the input box filled in: &#x22;Design a high-fidelity AI product homepage with brand navigation, a strong headline, product value proposition, primary CTA, secondary CTA, product UI preview, and customer trust proof. Make it modern, credible, and refined.&#x22; The workspace picker reads Design and the toolbar below the input shows Work in a Folder / Auto Style Reference / High fidelity / No library" width="2000" height="1386" data-path="images/qoderwork-design-step2-en.png" />
    </Frame>
  </Step>

  <Step title="Pick a style reference, pin a folder (optional)">
    A toolbar under the input box exposes the workspace's optional setup: **Work in a Folder**, **Auto Style Reference**, **Fidelity**, and **Component library**.

    * Click **Auto Style Reference** to lock the overall look-and-feel before generation — keep **Auto Style Reference** to let Canvas pick the best fit from 161 references, or pick a specific style like Airbnb, Airtable, Apple, Carbon, or Cloudscape. Use the search box at the top to filter by name.
    * Click **Work in a Folder** to pin the task to a local directory — the agent writes engineering files into that folder, which keeps the project maintainable over time and ready for handoff to Qoder IDE.
    * Click **Fidelity** to switch between **Wireframe** (low-fidelity layout, minimal visual styling) and **High fidelity** (production-grade visual design and detail, the default).
    * Click **Component library** to pick a target — defaults to **No library** (HTML-first unless the brief explicitly calls for React or another framework). You can also pick from **shadcn/ui**, **Spark Design**, or **Ant Design** — the agent will generate against the chosen React library.
  </Step>

  <Step title="Run directly, or enter design planning">
    After you submit, the agent first reads the brief and does a quick analysis pass (the reasoning shows up in the left panel as **Thinking** entries), then surfaces an **Enter design planning** decision card with two buttons:

    * **Run directly** — skip the structured questions and the design plan; the agent generates straight onto the canvas using whatever context it already has. Use this when the brief is small or you just want a quick exploration.
    * **Enter** — turn on design planning. The agent will first ask clarifying questions, then produce a Design Plan, then generate. Recommended for high-fidelity or production-grade work.

    <Frame>
      <img src="https://mintcdn.com/qoder/hjCzjGvcnHE5UJIx/images/qoderwork-design-step3-en.png?fit=max&auto=format&n=hjCzjGvcnHE5UJIx&q=85&s=44e58f1054f41ff614d6c3e19164f702" alt="Mid-conversation &#x22;Enter design planning&#x22; prompt card with two side-by-side buttons (Run directly / Enter); the right Canvas pane previews a &#x22;Generating extraordinary design&#x22; card with a wireframed device frame" width="2000" height="1386" data-path="images/qoderwork-design-step3-en.png" />
    </Frame>
  </Step>

  <Step title="Answer the agent's clarifying questions">
    In design planning mode, the agent opens a **Questions** tab and asks a few structured questions — product type, audience, fidelity, brand assets — each rendered as single-select options with an *Other* free-text fallback. Answer them so the plan matches your real context; click **Let AI decide** at the bottom if you'd rather skip the back-and-forth.

    <Frame>
      <img src="https://mintcdn.com/qoder/hjCzjGvcnHE5UJIx/images/qoderwork-design-step4-en.png?fit=max&auto=format&n=hjCzjGvcnHE5UJIx&q=85&s=f7909d507047541f40ec918248bf33a4" alt="Design task Questions tab: question 01 &#x22;Product type&#x22; with single-select options AI coding agent / dev tool, AI workspace / knowledge assistant, AI analytics / data copilot plus an Other field; question 02 &#x22;Audience&#x22; partly visible; bottom action bar shows Submit and Let AI decide" width="2000" height="1386" data-path="images/qoderwork-design-step4-en.png" />
    </Frame>
  </Step>

  <Step title="Confirm the Design Plan">
    The agent then writes a **Design Plan** under the **Plan** tab: a summary of intent and direction, a **Contract** panel (artifact, platform, output, library, fidelity, style), and the list of **Artifacts** with a one-line goal each. Hit **Run plan** to ship it, or **Request changes** to push back before any pixels are drawn.

    <Frame>
      <img src="https://mintcdn.com/qoder/hjCzjGvcnHE5UJIx/images/qoderwork-design-step5-en.png?fit=max&auto=format&n=hjCzjGvcnHE5UJIx&q=85&s=7494fc5570cead08265058bbb238719a" alt="Plan tab: &#x22;Design Plan&#x22; with summary, .design.json link, Contract panel (Artifact = landing page, Platform = responsive/web/desktop-first, Output = html, Library = none, Fidelity = high-fidelity, Style = Linear-inspired dark SaaS aesthetic), Artifacts section showing index.html; bottom action bar Run plan / Request changes / Cancel" width="2000" height="1386" data-path="images/qoderwork-design-step5-en.png" />
    </Frame>
  </Step>

  <Step title="Watch the canvas fill in">
    The agent generates on the **Canvas** tab. Reasoning appears in the left panel as **Thinking** entries; the canvas updates in place as each component lands.
  </Step>

  <Step title="Preview the running design">
    Switch to **Preview** to interact with the design as a real interface — click through CTAs, hover states, and navigation.

    <Frame>
      <img src="https://mintcdn.com/qoder/hjCzjGvcnHE5UJIx/images/qoderwork-design-en.png?fit=max&auto=format&n=hjCzjGvcnHE5UJIx&q=85&s=551a02818157ae32dab45f883906e1d7" alt="Design workspace full view: left task panel summarizes the CodePilot AI Coding Agent homepage build — sticky nav with brand mark, hero with Linear-inspired dark theme, dual CTAs (Start free / Book a demo), product UI preview, customer testimonial, footer; center canvas renders the dark hero &#x22;Ship production code with AI that understands your codebase&#x22;; right Nudge panel exposes COLORS (Brand Color), DENSITY (Spacing Scale), SHAPE (Corner Radius), THEME (Appearance Dark)" width="2000" height="1386" data-path="images/qoderwork-design-en.png" />
    </Frame>
  </Step>
</Steps>

## Iterating

You don't need to redo a brief from scratch — keep iterating in place.

* **Add to the queue.** Send follow-up instructions in the bottom input box — they're picked up after the current step.
* **Stop a run.** Click the stop button next to the input while the agent is generating to halt mid-flight.
* **Lasso and annotate on the Canvas.** Select a region and tell the agent what to change there; it adjusts based on canvas context instead of regenerating the whole frame.
* **Nudge key parameters.** After generation, the agent exposes color, spacing, and corner-radius as adjustable values — tune them without re-describing the brief.
* **Switch models mid-run.** Use the model dropdown next to the input (e.g. **Standard** / **Premium**) to change models for the next step.
* **Edit the engineering files directly.** Open **Design Files** to inspect or edit the source files when you need to drop into code.

<Tip>
  The agent keeps full conversation context, so iterations like *"keep the layout but make the hero darker and the CTA wider"* land precisely on what's already on the canvas.
</Tip>

## Typical Scenarios

### Product landing page

```plaintext theme={null}
Design a SaaS product landing page targeting enterprise users.
Include: top nav, hero section (headline + subtitle + primary CTA),
three-column product advantages, customer logo bar,
pricing comparison table, bottom CTA, and footer.
Style: clean, generous white space, cool color palette.
```

### Marketing visual kit

```plaintext theme={null}
Design a marketing visual suite for an online product launch event:
1. 16:9 promo banner (headline + countdown + QR code area)
2. Square social media image (suited for Instagram and Twitter)
3. Event landing page (agenda, speakers, registration form)
Use brand color #1A73E8 throughout. Modern, tech-forward style.
```

### Dashboard redesign

```plaintext theme={null}
Redesign a data analytics dashboard.
Include: sidebar navigation, top filter bar, 4 KPI metric cards,
line trend chart, donut distribution chart, data table.
Reference Linear's design. Dark theme, high information density
but clear visual hierarchy.
```

## Handing off to Qoder

Click **Handoff to Qoder** in the top-right corner to send the current code artifact straight to Qoder IDE for downstream work. A designer comfortable with frontend code can pull the same branch, continue iterating, and submit code without ever leaving the design surface.

## Next Steps

<CardGroup cols={2}>
  <Card title="Slides" icon="presentation-screen" href="/qoderwork/slides">
    Create presentations with AI Slides
  </Card>

  <Card title="Writing" icon="pen-nib" href="/qoderwork/writing">
    AI-assisted writing and polishing
  </Card>
</CardGroup>
