Isurwars/Correlation / .agents/skills/slint-ui
slint-ui
VerifiedGuide creation of modular Slint UI components, Material Design 3 design tokens, responsive layouts, property scoping, and modern visual aesthetics. Use when designing, styling, or refactoring Slint components.
Slint UI Component Architecture
This skill provides comprehensive standards for constructing modular, accessible, Material 3 styled visual interfaces using the Slint GUI toolkit for the Correlation application.
1. Syntax, Property Scoping & Decomposition
Declarative Property Scope
in property: Read-only properties driven by external callers or C++ controllers.out property: Read-only internal state exposed for external inspection.in-out property: Bi-directional reactive state.private property: Internal component state encapsulation.
Component Decomposition Rules
- Single Responsibility: Each card or dialog gets its own
.slintfile inside logical subdirectories (ui/cards/,ui/nav/). - File Length Limit: Keep individual
.slintfiles under 300 lines. Split complex components into child components. - Root Entry Point:
ui/AppWindow.slintserves strictly as the main window host importing and positioning sub-cards.
2. Design Tokens & Material 3 Styling (ui/material/)
A. Material Palette (MaterialPalette)
Always import and use tokenized color definitions from MaterialPalette. Never hardcode raw hex values (#1a202c, #000) in .slint components.
import { MaterialPalette } from "material/material.slint";
// Recommended token pairings:
// Background/Surface: MaterialPalette.background, MaterialPalette.surface, MaterialPalette.surface_container
// Content/Text: MaterialPalette.on_surface, MaterialPalette.on_surface_variant
// Primary Actions: MaterialPalette.primary, MaterialPalette.on_primary
// Errors/Validation: MaterialPalette.error, MaterialPalette.on_error
// Run State: MaterialPalette.run, MaterialPalette.on_run
B. Material Style Metrics (MaterialStyleMetrics)
Use standard metric tokens for spacing, padding, component heights, and corner radii:
- Spacing Tokens:
spacing_2(2px),spacing_4(4px),spacing_8(8px),spacing_12(12px),spacing_16(16px),spacing_24(24px) - Size Metrics:
size_40(40px compact target),size_56(56px standard target) - Border Radii:
border_radius_1(4px),border_radius_2(8px),border_radius_3(12px)
C. Material Typography & Dark/Light Themes
- Typography Styles:
display_large,headline_medium,title_medium,body_large,body_small,label_large. - ColorScheme Binding: Bind theme switching globally to
Palette.color-scheme(ColorScheme.dark/ColorScheme.light).
3. Layout Structure & Container Rules
VerticalBox/HorizontalBox: Primary structural containers for sequential alignment. Usespacingandpaddingtokens rather than manual pixel offsets.GridBox: Matrix layouts for form fields, parameter grids, and options cards.ScrollView: Wrap dynamic or height-constrained panels to handle overflowing UI elements cleanly.
4. Reusable Material Component Library
A. Buttons & Cards
Use standard FilledButton, IconButton, FilledCard, and Elevation primitives:
import { FilledButton, FilledCard, Icons, MaterialPalette } from "material/material.slint";
FilledButton {
text: "Run Analysis";
icon: Icons.play_arrow;
background: MaterialPalette.run;
text_color: MaterialPalette.on_run;
clicked => { root.run_analysis(); }
}
B. Interactive Feedback & Accessibility Annotations
- Accessibility: Guarantee every interactive widget declares standard
accessible-role(e.g.,button,checkbox,slider,text-input) and descriptiveaccessible-labelproperties. - State Layers: Provide visual hover and touch feedback on custom clickable areas using
StateLayerandTouchArea. - Micro-Animations: Animate property transitions using
animatedirectives with150ms–250msdurations and easing curves.
5. Data Visualization Guidelines
- Plotting Canvas Elements: Use custom
PathorImageelements to stream rendered data charts (e.g. Pair Distribution Functions g(r) or Radial Distribution Profiles). - Control Panels: Group analysis parameters (cutoff radius, bin width, particle filters) in collapsable card widgets with active state indicators.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |