Introduction
Welcome to the Guðmundur Design System.
This is where design and code finally stop arguing and start working together. The system keeps everything visually consistent, speeds up the design process, and gives everyone a shared language when building digital products.
Inside you will find modular spacing, thoughtful typography, color systems, and reusable components, all designed to make prototyping faster and implementation smoother.
Think of it as a toolkit for building clear, simple, and human friendly experiences.
Design Principles
Human-Centric
We design for people first, prioritizing extreme reading clarity and intuitive interface feedback flow anchors.
Playful Subtlety
Deliberate micro-animations (like magnetic translation pulls) amplify delight without degrading usability benchmarks.
Structured Rhythm
Strict grid bounds and proportion scales keep layouts harmoniously balanced for cross-device responsiveness.
How to Use
Include the tokens and components stylesheets in your HTML head to get started rapidly:
<link rel="stylesheet" href="assets/design_system/css/tokens.css"> <link rel="stylesheet" href="assets/design_system/css/components.css">
Colors
Core Palette
--bg-color
--text-color
--text-muted
--accent-color
--border-color
Neutral Scale
Structured UI Grays supporting border shades, surface backing layering multipliers triggers.
--gray-100
--gray-200
--gray-300
--gray-400
--gray-500
--gray-600
--gray-700
--gray-800
--gray-900
Semantic States
--success-color
--danger-color
--warning-color
--info-color
Typography
Our typographic scale is built on hierarchical step multipliers, prioritizing absolute reading clarity and balanced display weights securely.
Typefaces
Type Scale
| Style / Landmark | Size (rem) | Size (px) | Line Height | Visual Sample |
|---|---|---|---|---|
| H1 (Hero) | 3.5rem | 56px | 1.1 | Headline Large |
| H2 (Section Header) | 2.5rem | 40px | 1.2 | Section Title |
| H3 (Card Title) | 1.25rem | 20px | 1.4 | Layout Title |
| Body Regular | 1.0rem | 16px | 1.6 | Scalable structural nodes reading cleanly. |
| Small / Caption | 0.875rem | 14px | 1.5 | Secondary helper microcopy notes. |
Font Weights
Spacing Scale
0.25rem
0.5rem
0.75rem
1.0rem
2.0rem
4.0rem
Layout & Structure
12-Column Grid System
Responsive columns with utility classes like .ds-grid and column spans
.ds-col-[1-12].
* Uses media queries for tablet/mobile collapsing overlaps accurately.
Containers Max-Widths
Central constraints limiting alignment structures responsibly framed limits.
100%
1280px
1024px
768px
Responsive Breakpoints
Motion Design
Motion creates fluid relationships between states. Our physics curves prioritize crisp responses with soft decelerations multipliers.
Durations & Timing
| Speed | Value | Usage |
|---|---|---|
| Fast | 200ms |
Subtle fades, tooltip reveals, toggle triggers. |
| Standard | 300ms |
Cards Lift, Scale bounces, Button fills. |
| Slow | 500ms |
Large dashboard content reveals, modals overlays scaling. |
Micro-interactions Showcase
Hover Lift
Smooth translateY(-6px) layout offsets floating offsets.
Compound Micro-interactions
Combining Magnetic pull Physics with dynamic pointer Glows created for core CTA interfaces.
Continuous FX & Backgrounds
Forms & Inputs
Validation & States
<div class="form-group"> <label class="form-label">Label</label> <input type="text" class="form-input"> </div>
Badges & Tags
<span class="tag">Default</span> <span class="tag tag-success">Success</span>
Cards & Tables
Cards
Standard Card
A basic card component with background padding and border radius support framing items beautifully.
Interactive Card
This card includes hover elevation translations smoothly with a shadow offsets glow.
Striped Tables
| Name | Role | Status |
|---|---|---|
| Alex Morgan | Designer | Active |
| Sarah James | Developer | Away |
| Michael Chen | Director | Offline |
Avatars
Bullet Lists
- Comprehensive design documentation
- Pixel perfect variables scale
- Mobile responsive layouts grid
Loaders
<div class="loader-spinner"></div>
Overlays & Feedback
Alerts
Tooltips
Toast Notifications
Empty States
No items found
We couldn't find any results matching your current filters scale setups.
Progress Indicators
UX Solutions & Patterns
Higher-level structures combining base components to solve common user experience flows.
Authentication Form
Welcome Back
Log in to continue your session.
Instant Search Toolbar
Card Loading Skeletons
Interaction States
Standardized visual feedback behaviors applied across all interactive components (buttons, links, inputs) to ensure unified UX.
High Contrast Inverse Background, translations, or opacity shifts.
Outline offset rings with 4px gaps spacing.
Scale translation reductions for absolute click triggers.
Reduced opacity (0.4) and pointer-events lockouts.
Spinning overlays utilizing `.is-loading` pseudo-elements.
Accessibility Guidelines
Ensuring the design system is inclusive, perceivable, and operable by everyone, adhering closely to WCAG 2.1 AA standards.
Color Contrast (WCAG AA)
| Element Type | Min Ratio | Our Variable | Status |
|---|---|---|---|
| Normal Text | 4.5:1 | `--text-color` on `--bg-color` | Pass (AA) |
| Large Text (18pt+) | 3.0:1 | `--text-color` on `--bg-color` | Pass (AA) |
| UI Components / Graphics | 3.0:1 | `--border-color` on `--bg-color` | Pass (AA) |
Keyboard & Focus Management
- Skip Links: Include anchors to bypass repeated navigation sections.
- Visual Focus Indicators: Always maintain high contrast offset rings for tab focuses.
- Logical Tab Order: Match the visual layout structure chronologically.
Screen Reader Checklist
| Attribute | Usage / Purpose | Example |
|---|---|---|
| `aria-label` | Descriptive text for pure iconography or symbols. | `` |
| `aria-expanded` | Indicates expanded/collapsed state on drawers. | `` |
| Semantic HTML | Use ` |
`` |
Content Guidelines
Standards for writing clear, empathetic, and action-oriented copy across all user touchpoints.
Voice & Tone
| Principle | Do | Don't |
|---|---|---|
| Human-Centric | "Reset your password below." | "Execute credential reset sequence." |
| Active Direction | "Save changes to continue." | "The changes will be saved." |
| Empathetic Errors | "That password is too short. Try 8+ characters." | "ERROR 403: Invalid credential length." |
Button Labels & Microcopy Guidelines
- Start with Verbs: Use action words (e.g., *Create*, *Delete*, *Send*).
- Predictable Outcomes: Avoid vague titles like "Submit" when specific triggers apply.
- Helper Microcopy: Explain *why* data points are required (e.g., "For order tracking alerts").