AI Prompts for Identify Design System Violations

20 of the best prompts for identify design system violations, step by step across 4 stages. Works with ChatGPT, Claude, and Gemini.

AI Prompts for Identify Design System Violations

20 of the best prompts for identify design system violations, step by step across 4 stages. Works with ChatGPT, Claude, and Gemini.

Scroll to explore

Getting Identify Design System Violations right takes more than a single prompt. This 4-stage guide covers Diagnose the Wall, Isolate and Fix, Verify the Resolution, and more, breaking the whole process into focused steps where each prompt builds on the last. The generated component is not adhering to the established design system tokens, patterns, or components. This inconsistency can lead to a fragmented user experience and increased maintenance overhead. By following this guide, developers can ensure that all components align with the design system, improving consistency and usability. Every prompt is optimized and runs in ChatGPT, Claude, and Gemini.

Diagnose the Wall

Look for discrepancies between the generated component and the design system. Specifically, check the output of the component rendering in the browser.

Quote the Component Output

Please quote the exact output of the generated component in the browser for the use-case of [USE-CASE]. Compare this output with the expected output defined by the design system for [DESIGN SYSTEM]. Highlight any specific tokens or patterns that are missing or incorrect, and provide a brief explanation of how these discrepancies affect the overall design consistency.

Diagnose the Wall

Paste the Generated Component Code

Please analyze the code for the generated component located in [FILE_PATH]. Identify specific areas where it deviates from the expected design system tokens and patterns. Provide a detailed report that includes the nature of the deviations, potential impacts on the user experience, and recommendations for aligning the component with the design system.

Diagnose the Wall

State Your Understanding of the Design System

Please summarize the requirements of the design system as they pertain to the [COMPONENT NAME]. Include key principles, guidelines, and any specific elements that must be adhered to. Highlight any potential misinterpretations or areas of confusion that may exist regarding the design system and how they relate to this component.

Diagnose the Wall

Expected vs. Actual Component Behavior

Compare the expected behavior of the component against its actual rendered output. Structure your analysis by detailing the specific design tokens and patterns that should be present according to the design system. Include examples of both the expected and actual behaviors, and highlight any discrepancies along with suggestions for alignment with the design system.

Diagnose the Wall

Identify Violated Design Constraints

Please analyze the generated component for the use-case of [USE-CASE] and identify any design system rules or constraints that have been violated. For each violation, quote the exact clause from the design system documentation that outlines the requirement. Additionally, provide a brief explanation of how the component deviates from the specified design constraints.

Diagnose the Wall

Isolate and Fix

Target the specific lines of code in the generated component that do not comply with the design system. Focus on correcting the use of tokens and patterns.

Correct Token Usage in Component

Please review the component located at [FILE_PATH] on line [LINE] for incorrect design token usage. The original token being used is [ORIGINAL_TOKEN]. I need you to replace it with the correct token, [CORRECT_TOKEN], and provide me with a diff of the changes before the replacement is applied. Ensure that the output clearly highlights the modifications made to the code.

Isolate and Fix

Rewrite Component with Design Patterns

Rewrite the component located at [FILE_PATH] to adhere to the specified design patterns. The revised component should follow this expected structure: [EXPECTED_STRUCTURE]. Please ensure that all elements are consistent with the design system, and provide a summary of the changes made to achieve this alignment.

Isolate and Fix

Scoped Change to Component Styles

Modify the styles in the component located at [FILE_PATH] to ensure they align with the design system. Specifically, focus on changing the following styles: [LIST_STYLES]. Please provide a detailed summary of the modifications made and any potential impact on the overall component functionality.

Isolate and Fix

Enforce Design System Format

Please review the component located at [FILE_PATH] and assess its adherence to the required design token format. The correct format is as follows: [EXPECTED_FORMAT]. Provide a detailed list of the discrepancies you find, and then update the component to ensure it matches the specified format. Include a summary of the changes made and any potential impacts on functionality or design consistency.

Isolate and Fix

Verify Component Dependencies

Please verify the component dependencies used in the file located at [FILE_PATH]. Assess whether each dependency is compatible with the design system. If you find any outdated or incorrect dependencies, provide a detailed list of those dependencies along with suggestions for correction and updates needed to align them with the design system.

Isolate and Fix

Verify the Resolution

Confirm that the component now adheres to the design system. Check the rendered output in the browser.

Run a Visual Test of the Component

Please run a visual test of the component titled [COMPONENT NAME] by rendering it in the browser. After rendering, take a screenshot of the component and compare it with the design system specifications provided in [DESIGN SYSTEM LINK]. Identify any discrepancies between the rendered component and the design specifications, and summarize the findings in a report format that includes screenshots and notes on compliance issues.

Verify the Resolution

Show Diff of Component Changes

Please display the differences in the changes made to the component located at [FILE_PATH]. Highlight all modifications and provide a detailed analysis of how each change aligns with the design system requirements. Include a summary of any discrepancies and suggestions for adjustments to ensure full compliance with the design standards.

Verify the Resolution

Replay the Original Component Scenario

Please re-run the original scenario that caused the design violation for the [COMPONENT NAME]. Confirm whether the output now aligns with the design system expectations. Provide a detailed comparison of the previous output and the current output, highlighting any discrepancies and confirming compliance with the design specifications.

Verify the Resolution

Check for Edge Case Violations

Please test the [COMPONENT NAME] for edge case violations to verify its adherence to the design system. Document any discrepancies you find during this testing process, including specific examples of how the component deviates from the design guidelines. Provide a summary of the findings in a structured format, highlighting each issue and suggesting potential resolutions.

Verify the Resolution

Confirm Component State After Changes

Please verify the state of the component located at [FILE_PATH] after implementing the recent changes. Confirm that it accurately utilizes the design system tokens and patterns as intended. Provide a detailed report on any discrepancies found, including specific examples of how the component aligns or misaligns with the design system.

Verify the Resolution

Prevent Recurrence

Implement artefacts that ensure future components adhere to the design system. Focus on reusable constraints and checks.

Design System Compliance Check Prompt

Before generating any component, please verify that it adheres to the design system tokens and patterns. If you find any discrepancies, stop the process and notify the user immediately. Additionally, provide a summary of the specific areas where the component does not comply with the design system, including suggested adjustments to align it properly.

Prevent Recurrence

Component Generation Template

Create a comprehensive template for generating components that ensures consistency with our design system. The template should include the following structure: first, list all design tokens that must be used, represented as [LIST_TOKENS]. Next, include a reference to the design patterns that should be adhered to, linking to the guidelines at [LINK_TO_GUIDELINES]. Finally, provide a section for notes on any specific considerations or exceptions that may apply to the component being generated.

Prevent Recurrence

Naming Convention for Components

Establish a naming convention for components that aligns with the design system. The format should be '[COMPONENT_NAME]_[DESIGN_SYSTEM_TOKEN]'. Please provide a detailed explanation of the rationale behind this convention, examples of how it can be applied to various components, and guidelines for ensuring that all new components adhere to this naming structure.

Prevent Recurrence

Self-Check Request for Components

Please create a self-check request template for components to ensure they align with the design system requirements. The template should include sections for confirming compliance, listing any deviations found, and proposing specific corrections for each deviation. Ensure the format is clear and structured, allowing for easy documentation and review.

Prevent Recurrence

Design System Reference Reminder

Please create a reminder message for users to refer to the design system documentation before generating components. The message should read: "Always refer to the design system documentation at [LINK] before generating components. Ensure compliance with all tokens and patterns." This reminder should be displayed at the start of each session to reinforce adherence to the design system.

Prevent Recurrence

Frequently asked questions

What should I do if my component is not using the design tokens?+

Check the generated component's code for any hardcoded values. Bolt may not automatically apply design tokens if they are not explicitly referenced in the component's styles.

How can I ensure my components follow the design patterns?+

Use the design system documentation as a reference. Bolt may generate components that deviate from established patterns if the input does not clearly specify these requirements.

What happens if I ignore design system violations?+

Ignoring these violations can lead to inconsistent UI elements. Bolt's sandboxed environment may not surface these issues until deployment, causing potential user experience problems.

How can I test for design system compliance?+

Render the component in the browser and visually compare it against the design system specifications. Bolt's rendering capabilities can help identify discrepancies.

What are common causes of design system violations in Bolt?+

Common causes include incorrect input specifications or outdated design tokens. Bolt may not flag these issues unless explicitly checked during the component generation process.