20 of the best prompts for identify design system violations, step by step across 4 stages. Works with ChatGPT, Claude, and Gemini.
20 of the best prompts for identify design system violations, step by step across 4 stages. Works with ChatGPT, Claude, and Gemini.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Render the component in the browser and visually compare it against the design system specifications. Bolt's rendering capabilities can help identify discrepancies.
Common causes include incorrect input specifications or outdated design tokens. Bolt may not flag these issues unless explicitly checked during the component generation process.
AI Prompts for Identify Design System Violations
The generated component does not adhere to the established design system tokens, patterns, or components, leading to inconsistencies in the UI.
See promptsAI Prompts for Align Component with Design System
Generated components not using design system tokens can lead to inconsistent UI.
See promptsAI Prompts for Correcting File Structure Errors
Bolt is making changes in the wrong location due to a misunderstanding of the file layout, causing unexpected behavior and broken features.
See prompts