feat: FIT-1393: Create DESIGN.md#9389
Merged
robot-ci-heartex merged 8 commits intodevelopfrom Feb 13, 2026
Merged
Conversation
✅ Deploy Preview for label-studio-storybook canceled.
|
✅ Deploy Preview for label-studio-docs-new-theme canceled.
|
✅ Deploy Preview for heartex-docs canceled.
|
✅ Deploy Preview for label-studio-playground canceled.
|
Create DESIGN.md and design.mdc cursor rule to provide LLM agents with comprehensive guidance for creating consistent, accessible UIs following the HumanSignal design language. Key additions: - Brand principles, personality, and mission - Content guidelines (voice, tone, writing style, vocabulary) - WCAG 2.1 AA accessibility standards with keyboard navigation requirements - Design tokens (semantic vs numeric, color system, spacing, typography) - Component library reference with Storybook integration - Styling guidelines (Tailwind, SCSS modules, component tokens) - Component development patterns and best practices - UI patterns: saving settings, empty states, button hierarchy - Canvas element color handling with getTokenColor utility - Anti-patterns and quick reference The documentation ensures consistent visual design, accessibility compliance, dark mode compatibility, and efficient component reuse across Label Studio. Co-authored-by: Cursor <cursoragent@cursor.com>
Add comprehensive modal guidelines covering: - Footer action placement (default right-aligned, Previous buttons left-aligned) - Button visual hierarchy based on alignment direction - Destructive action confirmation requirements - High-impact destructive actions requiring typing validation - Modal stacking guidance (avoid modal-over-modal) Includes code examples showing correct patterns for standard modals, navigation modals, and destructive action modals with validation. Co-authored-by: Cursor <cursoragent@cursor.com>
Move button visual hierarchy guidelines from Modal Patterns to the general Button Hierarchy section, as these rules apply to all button groups (modals, forms, toolbars, page-level actions), not just modals. Changes: - Button Hierarchy section now includes visual hierarchy by alignment rules - Right-aligned buttons: hierarchy flows right to left (primary rightmost) - Left-aligned buttons: hierarchy flows left to right (primary leftmost) - Modal Patterns section now references the general Button Hierarchy guidelines Co-authored-by: Cursor <cursoragent@cursor.com>
Streamlined DESIGN.md and design.mdc to be more actionable and agent-focused: - Removed philosophical explanations and non-actionable content - Condensed examples to essential patterns only - Simplified verbose descriptions to concise directives - Removed maintenance/process documentation - Fixed capitalization rule inconsistency in design.mdc - Pointed to terminology.mdc for domain terms - Focused on implementation guidance over conceptual explanations The documentation now provides clear, actionable rules for building UIs while maintaining all critical design system requirements. Co-authored-by: Cursor <cursoragent@cursor.com>
Point to @humansignal/ui library and Storybook instead of listing specific components to avoid documentation becoming outdated. Co-authored-by: Cursor <cursoragent@cursor.com>
nass600
approved these changes
Feb 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request introduces a comprehensive design system guideline for Label Studio, detailing UI consistency, accessibility, component usage, styling, and anti-patterns. The new rule file provides clear instructions for developers to ensure interfaces align with the HumanSignal brand and design language.
Design system and UI consistency guidelines:
.cursor/rules/design.mdcwith detailed guidance on brand principles, content voice, accessibility requirements (WCAG 2.1 AA), and semantic design tokens for colors, spacing, and typography.@humansignal/uilibrary and Storybook for component development and discovery.Styling and component development:
Anti-patterns and quick reference: