ui-context-and-scope
UI Context and Scope
Users need to know three things at all times:
- Where am I? — current location in the product hierarchy
- What context am I in? — which section, record, or workspace is active
- What will my actions affect? — scope of changes before committing them
When these are unclear, users make mistakes, feel lost, and lose trust in the product.
Communicating Hierarchy with Visual Structure
Lines and Dividers
Horizontal rules and borders signal the boundary between sections. Use them to separate content areas that belong to different contexts — not just for decoration.
- A line between a header and content says "the content below belongs to this header"
- A sidebar border says "this is a different region with a different purpose"
- Avoid overusing dividers — proximity and whitespace should do most of the work; dividers reinforce where space alone is insufficient
Colour Regions and Background Fills
Background colour is one of the strongest signals for "you are now in a different area."
- Use a distinct background shade for sidebars, panels, or contextual drawers
- Active or selected regions benefit from a subtle fill to confirm "this is the current context"
- When a user's changes are scoped to a specific section, that section should be visually bounded — border, fill, or both — so the scope is self-evident before the user commits
Section Labels and Context Headers
Every major region should be able to answer "what am I?" without the user having to read surrounding content.
- Name sections with the user's vocabulary, not the system's
- Show the active entity: "Editing: Invoice #2041" or "Settings for: Workspace" — not just "Settings"
- In forms that affect a specific record, show the record name prominently in the form header
Navigating Depth
Breadcrumbs
Use breadcrumbs when the product has three or more levels of hierarchy, or when users can arrive at a page from multiple paths.
Home > Projects > Website Redesign > Tasks > #142 Fix header
- Each breadcrumb item should be a clickable link back to that level
- The current page is the last item — not a link, just text
- On mobile, collapse to show only the immediate parent:
← Website Redesign - Breadcrumbs do not replace primary navigation — they complement it
Search and Filter as Navigation
In products with large or dynamic content trees, search reduces the cognitive cost of navigating depth.
- Global search for finding any entity across the product
- Contextual filters for narrowing within the current scope
- Search results should show enough context to distinguish similar items (e.g. project name alongside task name)
Scope Communication Before Action
When a change, setting, or action affects a specific scope, that scope must be communicated before the user commits — not discovered afterward.
- Labels: "This setting applies to: this workspace only" / "All users will see this change"
- Visual bounding: Highlight or outline the affected region when the user is about to edit it
- Confirmation copy: Destructive or wide-scope actions should state the scope in the confirmation dialog ("Delete this project and all 47 tasks inside it?")
Review Checklist
- Can the user always identify which section or record they are currently editing?
- Are colour regions or borders used consistently to separate distinct contexts?
- Does navigation deeper than 2 levels use breadcrumbs or a clear back path?
- Do action confirmation dialogs state the scope of what will be affected?
- Are section titles written in user vocabulary, naming the active entity where relevant?
- Is global search available when the content structure is too large to browse?
More from dembrandt/dembrandt-skills
nielsen-usability-heuristics
UI design and review should apply Nielsen's 10 Usability Heuristics — the foundational principles for evaluating and improving usability. Use when auditing an interface, designing interaction flows, writing error messages, or reviewing any UI for usability issues.
45form-design
Forms have three layers of guidance: helper text below the input explains what to enter, placeholder shows the expected format, and validation confirms correctness. Real-time validation for complex inputs. Submit enables only when the form is valid. Use when designing or reviewing any form, input field, or data entry UI.
44color-mode-and-theme
Choose light, dark, or combined color mode deliberately based on brand tone and user context. Offer a theme selector only when user control genuinely matters — enterprise tools, data-heavy UIs, or extended-use applications. Use when defining the base color palette, designing a design system, or deciding whether to build dark mode support.
43generate-ui-from-brand
Pipeline skill — turns a URL or DESIGN.md into a concrete UI structure with decisions already made. Extracts live design tokens, normalizes them into a semantic system, applies UX principles, and outputs an actionable UI spec. Use when building UI for an existing brand from scratch, auditing a design system, or refactoring visual inconsistency.
42scroll-areas
Scroll areas inside a layout should be avoided wherever possible. When unavoidable, allow only one scroll axis at a time and always keep the user in control. Use when designing layouts, data tables, panels, or any component that might introduce an inner scroll container.
42micro-interactions
Micro-interactions are small, purposeful animations and responses that reward the user and make the interface feel alive — an animated icon, a satisfying toggle, a subtle reveal. Borrowed from the natural world, they add delight without distraction. Use when designing interactive components, success states, toggles, loaders, or any moment worth celebrating.
42