Invite your teammates. Share your designs early to get feedback, collaborate on iterations, and keep everyone aligned.
Getting an error? Use the /Debug skill.
Attach screenshots when creating designs
Don’t see any changes? Ask the AI to explain what it did. Switch to /Ask mode. For example, It might have made a new page but didn’t link a button to it.
You can attach images and .md files to a prompt — both when starting a new design from the dashboard and from the editor chat bar. Drop in a screenshot, PRD, spec, or notes doc and the agent reads it as first-class context.
Attaching a screenshot as a starting point is highly recommended — the models
are great at recreating designs from images.
Uploaded markdown files are saved alongside your design as docs/*.md, so they stay attached to the artifact and are available on every follow-up prompt.
Plan a change with the AI before it edits your design. The agent asks a few clarifying questions, drafts a structured plan you can edit, and only writes code once you approve it. Useful for larger changes when you want to align on the approach first. Uses credits.Read the full Plan Mode guide.
Magic Patterns manages your conversation context automatically, but the /Clear command gives you more control. Smaller context keeps the agent focused and lowers per-generation credit costs. See Credits and Billing for how context affects credits.
The / menu also gives you access to your Integrations, so you can pull in services like OpenAI, Anthropic, or Feedback collection without leaving the chat.
To go back to a previous design, click an older artifact card or select a version from the versions dropdown to preview it. Previewing lets you inspect an older version without changing the active version.To make the previewed design active again, click Restore this version. Restoring creates a new latest version from the selected design, so future prompts continue from that restored version.
If you send a prompt while previewing an older version, Magic Patterns will
ask you to confirm before restoring it as the active version.
Thumbs down opens an optional comment box so you can tell us exactly what went wrong.
Every rating is logged with the full conversation context so we can reproduce and fix the issue.
Don’t be unclear: checklist with 4 sections with 3 tasks each showing progress
Do be specific: four sections with 3 checkboxes each. There should be a progress bar for each section that changes according to the number of checkboxes checked
Don’t omit component names: a box for checks in a list in screen thing
Do use component names: Three checkboxes in a list in a modal
When you’re ready to bring a design into a production codebase with an AI editor, add the Integration Skill to Cursor or Claude Code. It teaches the agent to treat the Magic Patterns output as a design spec and adapt it to your codebase’s components, tokens, and conventions — instead of pasting the prototype verbatim.
Read key concepts to learn more about Design Systems and components.
The models have become quite good! Try uploading a screenshot of the design you want to use as a starting point.
Do you have an existing component library? You can create a Design System to organize your reusable components and ensure consistent usage across all your designs.
Use Rules to configure default styles like “always use #228B22 as my primary button color.”
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Magic Patterns","description":"Magic Patterns is an AI design tool for product teams. Create prototypes with your real design system, hand off to engineering, and speed up your software development lifecycle.","colors":{"primary":"#9784BF","light":"#FFFFFF","dark":"#001617"},"logo":{"light":"https://mintcdn.com/magicpatterns/owWJh7xQtXBlIJ16/logo/magicpatterns_logo_light.svg?fit=max\u0026auto=format\u0026n=owWJh7xQtXBlIJ16\u0026q=85\u0026s=2a7a773a8194091ebfe3e1c0104f2c92","dark":"https://mintcdn.com/magicpatterns/owWJh7xQtXBlIJ16/logo/magicpatterns_logo_dark.svg?fit=max\u0026auto=format\u0026n=owWJh7xQtXBlIJ16\u0026q=85\u0026s=20e5d64413256401004cd68c98e798d0"},"favicon":"https://mintcdn.com/magicpatterns/owWJh7xQtXBlIJ16/icon.svg?fit=max\u0026auto=format\u0026n=owWJh7xQtXBlIJ16\u0026q=85\u0026s=7854f15b01790c1d076cf1f1e10c61b0","api":{"openapi":["openapi-v3.yml","openapi.yml"]},"navbar":{"links":[{"href":"https://www.magicpatterns.com/customers","label":"Case Studies"}],"primary":{"type":"button","label":"Start designing","href":"https://www.magicpatterns.com"}},"footer":{"socials":{"twitter":"https://x.com/magicpatterns","github":"https://github.com/magicpatterns","linkedin":"https://www.linkedin.com/company/magicpatterns"}},"integrations":{"intercom":{"appId":"ftkg08cn"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"magicpatterns","hasAudioNarration":false,"actualSubdomain":"magicpatterns","customDomains":["www.magicpatterns.com"],"gitSource":{"type":"github","owner":"magicpatterns","repo":"patterns","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aecbba141290b71c3828cbd","collectionId":"2e385020-b02a-471f-85a4-79efe7f6e8f4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aecbba141290b71c3828cbd"},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aece1b3a84f97fba518a7c7","clientVersion":"0.0.4071","searchFilterCounts":[{"language":"default","tag":"Publish and Integrate","count":37},{"language":"default","tag":"Designs","count":18},{"language":"default","tag":"Introduction","count":15},{"language":"default","tag":"API","count":14},{"language":"default","tag":"Design Systems","count":14},{"language":"default","tag":"Integrations","count":11},{"language":"default","tag":"Teams and Enterprise","count":9},{"language":"default","tag":"Workflows and Video Guide","count":8},{"language":"default","tag":"Prompting and iterating","count":6},{"language":"default","tag":"Importing your Design System","count":6}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@magicpatterns.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-tabs-item[href^=\"/documentation/magic-os/\"]::after{content:\"NEW\";margin-left:0.375rem;padding:0.0625rem 0.375rem;border-radius:9999px;font-size:0.625rem;font-weight:600;line-height:1rem;color:rgb(var(--primary));background-color:rgb(var(--primary) / 0.1)}"}],"page":{"pagePath":"documentation/editor/how-to-prompt","slug":"/documentation/editor/how-to-prompt","pageMetadata":{"title":"How to Prompt","description":"Prompt like a pro with Magic Patterns.","icon":"graduation-cap","href":"/documentation/editor/how-to-prompt"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Prompt like a pro with Magic Patterns.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedFrame,OptimizedImage,Table,Tip}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedFrame)_missingMdxReference(`OptimizedFrame`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`general-tips`,children:`General Tips`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Invite your teammates.`}),` Share your designs early to get feedback, collaborate on iterations, and keep everyone aligned.`]}),`\n`,_jsxs(_components.li,{children:[`Getting an error? Use the `,_jsx(_components.code,{children:`/Debug`}),` skill.`]}),`\n`,_jsx(_components.li,{children:`Attach screenshots when creating designs`}),`\n`,_jsxs(_components.li,{children:[`Don’t see any changes? Ask the AI to explain what it did. Switch to `,_jsx(_components.code,{children:`/Ask`}),` mode. For example, It might have made a new page but didn’t link a button to it.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`select-mode-and-visual-edit`,children:`Select Mode and Visual Edit`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Selecting specific elements with “Select Mode” is the most important feature\nfor getting accurate results.`})}),`\n`,_jsx(_components.p,{children:`Select Mode lets you click on specific elements in your design to tell the AI exactly what you want to change.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`How to use Select Mode:`})}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Toggle on Select Mode from the bottom-left corner of the chat`}),`\n`,_jsx(_components.li,{children:`Click any element in your design (button, text, image, etc.)`}),`\n`,_jsx(_components.li,{children:`This will open the Visual Edit panel.`}),`\n`,_jsx(_components.li,{children:`By default, the “context” of what you have selected will be added to the chat.`}),`\n`,_jsx(_components.li,{children:`Optional: edit visual properties manually in the panel and then click “Save.”`}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`You can quickly toggle Select Mode with `,_jsx(`strong`,{children:`⌥ + S`}),`.`]})}),`\n`,_jsx(OptimizedFrame,{className:`mint-w-full mint-aspect-video`,src:`https://www.youtube.com/embed/AU-up911buI`,title:`Visual Edit Tutorial`,allow:`accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture`,allowFullScreen:true}),`\n`,_jsx(Heading,{level:`3`,id:`when-to-use-select-mode`,children:`When to use Select Mode`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`When the AI is changing the wrong thing`}),`\n`,_jsx(_components.li,{children:`When working with complex, multi-section designs`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`adding-context-to-a-prompt`,children:`Adding Context to a Prompt`}),`\n`,_jsx(Heading,{level:`3`,id:`attaching-files`,children:`Attaching Files`}),`\n`,_jsxs(_components.p,{children:[`You can attach images and `,_jsx(_components.code,{children:`.md`}),` files to a prompt — both when starting a new design from the dashboard and from the editor chat bar. Drop in a screenshot, PRD, spec, or notes doc and the agent reads it as first-class context.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Attaching a screenshot as a starting point is highly recommended — the models\nare great at recreating designs from images.`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Uploaded markdown files are saved alongside your design as `,_jsx(_components.code,{children:`docs/*.md`}),`, so they stay attached to the artifact and are available on every follow-up prompt.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`other-magic-patterns-designs`,children:`Other Magic Patterns Designs`}),`\n`,_jsxs(_components.p,{children:[`Want to merge designs? You can simply paste Magic Patterns links directly into your prompt. See more in the `,_jsx(_components.a,{href:`/documentation/editor/merging-designs`,children:`Merging Designs`}),` guide.`]}),`\n`,_jsx(Frame,{children:_jsx(`video`,{autoPlay:true,muted:true,loop:true,playsInline:true,src:`https://cdn.magicpatterns.com/uploads/eENj4gEW1rhFZ8ZycYmC7s/Cross%20Project%20Referencing.mp4`})}),`\n`,_jsx(Heading,{level:`2`,id:`chat-modes-commands-and-integrations`,children:`Chat Modes, Commands, and Integrations`}),`\n`,_jsxs(_components.p,{children:[`Type `,_jsx(_components.code,{children:`/`}),` in the chat input to open the menu. You can also use Chat Modes and Skills straight from the dashboard initial prompt to kick off a new design.`]}),`\n`,_jsx(OptimizedImage,{height:`200`,src:`https://cdn.magicpatterns.com/uploads/bVeCue4HZM4381ADRm9LuQ/CleanShot_2026-04-30_at_18.31.372x.png`}),`\n`,_jsx(Heading,{level:`3`,id:`chat-modes`,children:`Chat Modes`}),`\n`,_jsx(_components.p,{children:`Chat modes change how the AI responds to your next message and stay active until you switch them.`}),`\n`,_jsx(Heading,{level:`4`,id:`/ask`,children:_jsx(_components.code,{children:`/Ask`})}),`\n`,_jsx(_components.p,{children:`Chat with the AI without generating code (great for planning or asking questions). Uses credits.`}),`\n`,_jsx(Heading,{level:`4`,id:`/plan`,children:_jsx(_components.code,{children:`/Plan`})}),`\n`,_jsx(_components.p,{children:`Plan a change with the AI before it edits your design. The agent asks a few clarifying questions, drafts a structured plan you can edit, and only writes code once you approve it. Useful for larger changes when you want to align on the approach first. Uses credits.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.a,{href:`/documentation/editor/plan-mode`,children:`Read the full Plan Mode guide.`})}),`\n`,_jsx(Heading,{level:`3`,id:`default-skills`,children:`Default Skills`}),`\n`,_jsx(_components.p,{children:`Skills are powerful default prompts that help you work more efficiently. You can also add your own custom Skills.`}),`\n`,_jsx(Heading,{level:`4`,id:`/debug`,children:_jsx(_components.code,{children:`/Debug`})}),`\n`,_jsxs(_components.p,{children:[`If the AI is in a doom loop or not following instructions, the `,_jsx(_components.code,{children:`/Debug`}),` skill uses a special prompt template to help debug the issue effectively.`]}),`\n`,_jsx(Heading,{level:`4`,id:`/inspiration`,children:_jsx(_components.code,{children:`/Inspiration`})}),`\n`,_jsx(_components.p,{children:`Generates 4 different design variations to explore options.`}),`\n`,_jsx(Heading,{level:`4`,id:`/polish`,children:_jsx(_components.code,{children:`/Polish`})}),`\n`,_jsx(_components.p,{children:`Cleans up your design with better spacing, alignment, and visual hierarchy.`}),`\n`,_jsx(Heading,{level:`3`,id:`managing-context`,children:`Managing Context`}),`\n`,_jsxs(_components.p,{children:[`Magic Patterns manages your conversation context automatically, but the `,_jsx(_components.code,{children:`/Clear`}),` command gives you more control. Smaller context keeps the agent focused and lowers per-generation credit costs. See `,_jsx(_components.a,{href:`/documentation/get-started/credits-and-billing#credits`,children:`Credits and Billing`}),` for how context affects credits.`]}),`\n`,_jsx(Heading,{level:`4`,id:`/clear`,children:_jsx(_components.code,{children:`/Clear`})}),`\n`,_jsx(_components.p,{children:`Resets the current conversation context without needing to fork the design. Useful when you start an unrelated task on the same design.`}),`\n`,_jsx(Heading,{level:`3`,id:`integrations`,children:`Integrations`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`/`}),` menu also gives you access to your `,_jsx(_components.a,{href:`/documentation/integrations/overview`,children:`Integrations`}),`, so you can pull in services like OpenAI, Anthropic, or Feedback collection without leaving the chat.`]}),`\n`,_jsx(Heading,{level:`2`,id:`using-version-history`,children:`Using Version History`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`One of the most powerful features of Magic Patterns is version control. It’s\ninstantaneous because Magic Patterns is frontend-only.`})}),`\n`,_jsx(Heading,{level:`3`,id:`reverting-to-a-previous-design`,children:`Reverting to a previous design`}),`\n`,_jsx(_components.p,{children:`To go back to a previous design, click an older artifact card or select a version from the versions dropdown to preview it. Previewing lets you inspect an older version without changing the active version.`}),`\n`,_jsxs(_components.p,{children:[`To make the previewed design active again, click `,_jsx(_components.strong,{children:`Restore this version`}),`. Restoring creates a new latest version from the selected design, so future prompts continue from that restored version.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`If you send a prompt while previewing an older version, Magic Patterns will\nask you to confirm before restoring it as the active version.`})}),`\n`,_jsx(OptimizedImage,{height:`200`,src:`https://cdn.magicpatterns.com/uploads/631ap5uowPsy6QyHdNQm4x/version-dropdown.png`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Thumbs down opens an optional comment box so you can tell us exactly what went wrong.`}),`\n`,_jsx(_components.li,{children:`Every rating is logged with the full conversation context so we can reproduce and fix the issue.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`prompting-dos-and-don’ts`,children:`Prompting Dos and Don’ts`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`❌ Don’t`}),_jsx(_components.th,{children:`✅ Do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Don’t`}),` be unclear: `,_jsx(_components.code,{children:`checklist with 4 sections with 3 tasks each showing progress`})]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Do`}),` be specific: `,_jsx(_components.code,{children:`four sections with 3 checkboxes each. There should be a progress bar for each section that changes according to the number of checkboxes checked`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Don’t`}),` omit component names: `,_jsx(_components.code,{children:`a box for checks in a list in screen thing`})]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Do`}),` use component names: `,_jsx(_components.code,{children:`Three checkboxes in a list in a modal`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Don’t`}),` upload lengthy PRDs expecting perfect results`]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Do`}),` break down large changes into smaller, focused updates`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Don’t`}),` give broad instructions like “make the page cleaner”`]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Do`}),` use the `,_jsx(_components.code,{children:`/Polish`}),` skill`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Don’t`}),` keep prompting when results become inconsistent`]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Do`}),` fork your chat, roll back to a previous version, or ask the AI to reflect on what’s going wrong`]})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Use a screenshot to recreate an existing design. Provide styling rules by\ncreating a `,_jsx(_components.a,{href:`/documentation/design-systems/overview`,children:`design system`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`taking-your-design-to-a-codebase`,children:`Taking your design to a codebase`}),`\n`,_jsxs(_components.p,{children:[`When you’re ready to bring a design into a production codebase with an AI editor, add the `,_jsx(_components.a,{href:`/documentation/exporting/integration-skill`,children:`Integration Skill`}),` to Cursor or Claude Code. It teaches the agent to treat the Magic Patterns output as a design spec and adapt it to your codebase’s components, tokens, and conventions — instead of pasting the prototype verbatim.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-to-use-existing-styles`,children:`How to use Existing Styles`}),`\n`,_jsxs(_components.p,{children:[`Read `,_jsx(_components.a,{href:`/documentation/get-started/introduction#key-features`,children:`key concepts`}),` to learn more about Design Systems and components.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`The models have become quite good! Try uploading a screenshot of the design you want to use as a starting point.`}),`\n`,_jsxs(_components.li,{children:[`Do you have an existing component library? You can `,_jsx(_components.a,{href:`/documentation/design-systems/overview`,children:`create a Design System`}),` to organize your reusable components and ensure consistent usage across all your designs.`]}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.a,{href:`/documentation/design-systems/editing/rules`,children:`Rules`}),` to configure default styles like “always use #228B22 as my primary button color.”`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`video-guide`,children:`Video Guide`}),`\n`,_jsxs(_components.p,{children:[`How to prompt is covered in our video lesson `,_jsx(_components.a,{href:`/documentation/guide/building-your-first-prototype`,children:`Building Your First Prototype`}),`.`]}),`\n`,_jsx(OptimizedFrame,{className:`mint-w-full mint-aspect-video`,src:`https://www.youtube.com/embed/7vVcU17hUJ4?si=Pld9r8mwWo_d5g0d`,title:`Building Your First Prototype`,alt:`Building Your First Prototype`,frameborder:`0`,allow:`accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture`,allowFullScreen:true})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"How to Prompt","description":"Prompt like a pro with Magic Patterns.","icon":"graduation-cap","href":"/documentation/editor/how-to-prompt"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"General Tips","slug":"general-tips","depth":2,"children":[]},{"title":"Select Mode and Visual Edit","slug":"select-mode-and-visual-edit","depth":2,"children":[{"title":"When to use Select Mode","slug":"when-to-use-select-mode","depth":3,"children":[]}]},{"title":"Adding Context to a Prompt","slug":"adding-context-to-a-prompt","depth":2,"children":[{"title":"Attaching Files","slug":"attaching-files","depth":3,"children":[]},{"title":"Other Magic Patterns Designs","slug":"other-magic-patterns-designs","depth":3,"children":[]}]},{"title":"Chat Modes, Commands, and Integrations","slug":"chat-modes-commands-and-integrations","depth":2,"children":[{"title":"Chat Modes","slug":"chat-modes","depth":3,"children":[]},{"title":"/Ask","slug":"/ask","depth":4,"children":[]},{"title":"/Plan","slug":"/plan","depth":4,"children":[]},{"title":"Default Skills","slug":"default-skills","depth":3,"children":[]},{"title":"/Debug","slug":"/debug","depth":4,"children":[]},{"title":"/Inspiration","slug":"/inspiration","depth":4,"children":[]},{"title":"/Polish","slug":"/polish","depth":4,"children":[]},{"title":"Managing Context","slug":"managing-context","depth":3,"children":[]},{"title":"/Clear","slug":"/clear","depth":4,"children":[]},{"title":"Integrations","slug":"integrations","depth":3,"children":[]}]},{"title":"Using Version History","slug":"using-version-history","depth":2,"children":[{"title":"Reverting to a previous design","slug":"reverting-to-a-previous-design","depth":3,"children":[]}]},{"title":"Prompting Dos and Don’ts","slug":"prompting-dos-and-don’ts","depth":2,"children":[]},{"title":"Taking your design to a codebase","slug":"taking-your-design-to-a-codebase","depth":2,"children":[]},{"title":"How to use Existing Styles","slug":"how-to-use-existing-styles","depth":2,"children":[]},{"title":"Video Guide","slug":"video-guide","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-aspect-video {\n aspect-ratio: 16 / 9\n}\n.mint-w-full {\n width: 100%\n}","subdomain":"magicpatterns","siteName":"Magic Patterns","title":"How to Prompt - Magic Patterns","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-13T01:00:37.230Z","originalFileLocation":"documentation/editor/how-to-prompt.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Prompt like a pro with Magic Patterns.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Magic Patterns\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/magicpatterns/7ZqRXq6s1-Htf8k5/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/magicpatterns/7ZqRXq6s1-Htf8k5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/magicpatterns/7ZqRXq6s1-Htf8k5/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/magicpatterns/7ZqRXq6s1-Htf8k5/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/magicpatterns/7ZqRXq6s1-Htf8k5/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/magicpatterns/7ZqRXq6s1-Htf8k5/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/magicpatterns/7ZqRXq6s1-Htf8k5/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/magicpatterns/7ZqRXq6s1-Htf8k5/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/magicpatterns/7ZqRXq6s1-Htf8k5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"How to Prompt - Magic Patterns\">\u003cmeta data-mint-head property=\"og:description\" content=\"Prompt like a pro with Magic Patterns.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Magic Patterns\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.magicpatterns.com/docs/documentation/editor/how-to-prompt\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://magicpatterns.mintlify.app/_mintlify/api/og/v2?division=Start+here\u0026amp;title=How+to+Prompt\u0026amp;description=Prompt+like+a+pro+with+Magic+Patterns.\u0026amp;theme=58b3985732190453b80d7ef2\u0026amp;signature=9951d2aeea845324c22b32562d3690291671b2021fd9b8c1fc463ccd670a6976\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"How to Prompt - Magic Patterns\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Prompt like a pro with Magic Patterns.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://magicpatterns.mintlify.app/_mintlify/api/og/v2?division=Start+here\u0026amp;title=How+to+Prompt\u0026amp;description=Prompt+like+a+pro+with+Magic+Patterns.\u0026amp;theme=58b3985732190453b80d7ef2\u0026amp;signature=9951d2aeea845324c22b32562d3690291671b2021fd9b8c1fc463ccd670a6976\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/magicpatterns/7ZqRXq6s1-Htf8k5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Magic Patterns\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9784BF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.magicpatterns.com/docs/documentation/editor/how-to-prompt\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/documentation/editor/how-to-prompt.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.magicpatterns.com/#organization\",\"name\":\"Magic Patterns\",\"url\":\"https://www.magicpatterns.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/magicpatterns/owWJh7xQtXBlIJ16/logo/magicpatterns_logo_light.svg?fit=max\u0026auto=format\u0026n=owWJh7xQtXBlIJ16\u0026q=85\u0026s=2a7a773a8194091ebfe3e1c0104f2c92\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.magicpatterns.com/docs#website\",\"name\":\"Magic Patterns\",\"url\":\"https://www.magicpatterns.com/docs\",\"publisher\":{\"@id\":\"https://www.magicpatterns.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.magicpatterns.com/docs/documentation/editor/how-to-prompt#webpage\",\"url\":\"https://www.magicpatterns.com/docs/documentation/editor/how-to-prompt\",\"name\":\"How to Prompt\",\"description\":\"Prompt like a pro with Magic Patterns.\",\"dateModified\":\"2026-10-13T01:00:37.230Z\",\"isPartOf\":{\"@id\":\"https://www.magicpatterns.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.magicpatterns.com/docs/documentation/editor/how-to-prompt#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.magicpatterns.com/docs/documentation/editor/how-to-prompt#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Start here\",\"item\":\"https://www.magicpatterns.com/docs/documentation/get-started/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to Prompt\",\"item\":\"https://www.magicpatterns.com/docs/documentation/editor/how-to-prompt\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.magicpatterns.com/docs/documentation/editor/how-to-prompt#article\",\"headline\":\"How to Prompt\",\"name\":\"How to Prompt\",\"description\":\"Prompt like a pro with Magic Patterns.\",\"url\":\"https://www.magicpatterns.com/docs/documentation/editor/how-to-prompt\",\"mainEntityOfPage\":{\"@id\":\"https://www.magicpatterns.com/docs/documentation/editor/how-to-prompt#webpage\"},\"dateModified\":\"2026-10-13T01:00:37.230Z\",\"publisher\":{\"@id\":\"https://www.magicpatterns.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.magicpatterns.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Magic Patterns\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Magic Patterns","nav":{"global":null,"tabs":[{"tab":"Introduction","groups":[{"group":"Start here","pages":[{"title":"Welcome","icon":"hand-wave","href":"/documentation/get-started/introduction"},{"title":"Features","icon":"cube","href":"/documentation/features/overview"},{"title":"Credits and Plans","description":"Learn how plans, credits, on-demand usage, and billing work in Magic Patterns.","icon":"credit-card","iconType":"solid","href":"/documentation/get-started/credits-and-billing"},{"title":"How to Prompt","icon":"graduation-cap","href":"/documentation/editor/how-to-prompt"}]},{"group":"Workflows and Video Guide","pages":[{"title":"Introduction","description":"AI design with Magic Patterns","icon":"graduation-cap","href":"/documentation/guide/introduction"},{"title":"Building Your First Prototype","icon":"rocket","href":"/documentation/guide/building-your-first-prototype"},{"title":"Improving Your Prompts","icon":"circle-plus","href":"/documentation/guide/improving-your-prompts"},{"title":"Importing from Figma","icon":"figma","href":"/documentation/guide/figma-imports"},{"title":"Design Systems","icon":"cubes","href":"/documentation/guide/design-systems"},{"title":"Team Workflows and Sharing","icon":"people-group","href":"/documentation/guide/team-workflows-and-sharing"},{"title":"Engineering Handoff","icon":"code","href":"/documentation/guide/engineering-handoff"},{"title":"Video Tutorials","icon":"video","href":"/documentation/tutorials/video-tutorials"}]},{"group":"Help","pages":[{"title":"Troubleshooting","icon":"hammer","href":"/documentation/troubleshooting/overview"},{"title":"Common Questions","icon":"comments-question","href":"/documentation/get-started/faq"},{"title":"Support","icon":"headset","href":"/documentation/get-started/support"}]}]},{"tab":"Designs","pages":[{"title":"Designs","href":"/documentation/editor/what-is-a-design"}]},{"tab":"MagicOS","pages":[{"title":"MagicOS","href":"/documentation/magic-os/overview"}]},{"tab":"Design Systems","pages":[{"title":"Design Systems","href":"/documentation/design-systems/overview"}]},{"tab":"Publish and Integrate","pages":[{"title":"Publish and Integrate","href":"/documentation/publishing/publish-url"}]},{"tab":"Teams and Enterprise","pages":[{"title":"Teams and Enterprise","href":"/documentation/collaboration/team-workspaces"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/documentation/feature-releases/changelog"}]}]},"basePath":"","title":"How to Prompt - Magic Patterns","buildId":"dpl_DQCMP4mismmBj3AFK7YZqNhrtLNq","deploymentId":"dpl_DQCMP4mismmBj3AFK7YZqNhrtLNq","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-CAXmh2H7.js","DynamicMarkdown-B95U9rYS.js","zoom-image-lightbox-CgttNQ9S.js","lightbox-handle-r17bVUz3.js"]}