Styling Tenzir UI
This skill provides Tenzir's brand and style guidelines for frontend development.
Contents
Design System Overview
Tenzir's design system provides consistent styling across all Tenzir products.
When implementing frontend components, always reference the appropriate section:
Quick Reference
Fonts
- Inter - Corporate font for UI text
- JetBrains Mono - Monospace font for code
Usage Guidelines
- Always use design tokens - Never hardcode pixel values; use the token names (e.g.,
text-sm, text-base)
- Respect the type scale - Use the defined sizes; don't create custom sizes
- Match weight to purpose - Use semi-bold for headings, medium for emphasis, regular for body text
- Apply letter-spacing - Larger text sizes (2xl+) require negative letter-spacing
Spacing
- Scale: 0, 0.5, 1, 2, 3, 4, 5, 6, 7, 8, 10, 16, 20
- Base unit: 4px (1 = 0.25rem = 4px)
- Common: p-2 (8px) for inputs, p-4 (16px) for containers, gap-4 (16px) for sections
Colors
- Primary: Blue (
#0A54FF) and Green (#29E06C)
- Neutrals: 11-shade grey scale from
neutral-800 (black) to neutral-50 (white)
- Semantic: Success (green), Warning (yellow), Error (red)
- Graph colors: Blue, Lightblue, Purple, Pink, Orange, Yellow (in order)
Shadows
- shadow-l - Sidepanels and modals (highest elevation)
- shadow-m - Popups
- shadow-s - Tooltips and toasts
- shadow-xs - Subtle elevation (lowest)
Buttons
- Primary - Solid blue (
blue-500), main actions
- Secondary - Outlined (
neutral-250 border), alternative actions
- Tertiary - Text-only, low-emphasis actions
- Sizes: XS (24px), S (28px), M (32px), L (36px)
Inputs
- Input Field - M (32px), L (36px) heights; neutral-100 background
- Search - 32px height with search icon and clear button
- Checkbox - 16px square, 5px radius
- Radio Button - 16px circle
- Toggle Switch - 32x20px with sliding knob
- Focus ring - 3px primary-200 for inputs, 2px for controls
Tags & Badges
- Tag - 24px height, 9 colors, add/remove variants
- Badge - 16px height, 8px uppercase text, 9 colors (same palette as tags)
Navigation
- Tab Bar - 48px height, 2px active indicator, notification counter support
Feedback
- Toast - 48px min-height, shadow-s, optional icon/subtitle/button/progress bar
CSS Custom Properties Naming Convention
When implementing the design system in CSS, use the --tnz- prefix for all custom properties:
:root {
/* Typography */
--tnz-font-sans: "Inter Variable", "Inter", system-ui, sans-serif;
--tnz-font-mono: "JetBrains Mono Variable", "JetBrains Mono", monospace;
/* Font Sizes */
--tnz-text-xxs: 0.625rem; /* 10px */
--tnz-text-xs: 0.75rem; /* 12px */
--tnz-text-sm: 0.875rem; /* 14px */
--tnz-text-base: 1rem; /* 16px */
--tnz-text-lg: 1.125rem; /* 18px */
--tnz-text-xl: 1.25rem; /* 20px */
--tnz-text-2xl: 1.5rem; /* 24px */
--tnz-text-3xl: 1.875rem; /* 30px */
--tnz-text-4xl: 2.25rem; /* 36px */
--tnz-text-5xl: 3rem; /* 48px */
/* Border Radius - 5px is the standard */
--tnz-radius: 5px;
/* Spacing Scale (base unit: 4px) */
--tnz-space-0: 0;
--tnz-space-0-5: 0.125rem; /* 2px */
--tnz-space-1: 0.25rem; /* 4px */
--tnz-space-1-5: 0.375rem; /* 6px */
--tnz-space-2: 0.5rem; /* 8px */
--tnz-space-3: 0.75rem; /* 12px */
--tnz-space-4: 1rem; /* 16px */
--tnz-space-5: 1.25rem; /* 20px */
--tnz-space-6: 1.5rem; /* 24px */
--tnz-space-7: 1.75rem; /* 28px */
--tnz-space-8: 2rem; /* 32px */
--tnz-space-10: 2.5rem; /* 40px */
--tnz-space-16: 4rem; /* 64px */
--tnz-space-20: 5rem; /* 80px */
/* Shadows */
--tnz-shadow-xs: 0px 8px 16px -8px #0e10171a, 0px 3px 6px -3px #0e10171a;
--tnz-shadow-s: 0px 8px 16px -8px #0e101733, 0px 3px 6px -3px #0e101733;
--tnz-shadow-m: 0px 10px 20px -8px #0e101733, 0px 4px 8px -6px #0e101733;
--tnz-shadow-l: 0px 20px 40px -16px #0e101733, 0px 8px 16px -8px #0e101733;
/* Transitions */
--tnz-transition-fast: 0.15s ease;
--tnz-transition-base: 0.2s ease;
--tnz-transition-slow: 0.3s ease;
/* Colors - see colors.md for full palette */
/* Primary Blue */
--tnz-primary-500: #0a54ff;
--tnz-primary-600: #0043e0;
/* ... etc */
/* Neutrals */
--tnz-neutral-50: #fdfdfe;
--tnz-neutral-100: #f7f8fa;
--tnz-neutral-200: #f0f1f5;
/* ... etc */
}
Important: Always use design tokens via CSS custom properties. Never hardcode values like font-family: 'Inter' or border-radius: 5px - use var(--tnz-font-sans) and var(--tnz-radius) instead.
When to Load References
Load the specific reference file when you need detailed specifications:
1---2name: styling-tenzir-ui3description: Provides Tenzir design system tokens and component specifications. Use when building UI components, styling with CSS/Tailwind, choosing colors, typography, spacing, or implementing buttons, inputs, tags/badges, toasts, and other Tenzir UI elements.4metadata:5 source: https://skillmd.com/skills/diegosouzapw/styling-tenzir-ui6---78# Styling Tenzir UI910This skill provides Tenzir's brand and style guidelines for frontend development.1112## Contents1314- [Design System Overview](#design-system-overview)15- [Quick Reference](#quick-reference)16- [When to Load References](#when-to-load-references)1718## Design System Overview1920Tenzir's design system provides consistent styling across all Tenzir products.2122When implementing frontend components, always reference the appropriate section:2324| Aspect | Reference | Description |25| -------------- | ---------------------------------------------- | ---------------------------------------------- |26| Typography | [typography.md](./typography.md) | Font families, sizes, weights, line heights |27| Colors | [colors.md](./colors.md) | Brand colors, semantic colors, neutrals |28| Spacing | [spacing.md](./spacing.md) | Padding and margin scale |29| Shadows | [shadows.md](./shadows.md) | Elevation and shadow styles |30| Border Radius | [border-radius.md](./border-radius.md) | Corner radius tokens (always 5px) |31| Buttons | [buttons.md](./buttons.md) | All button styles (standard, delete, floating) |32| Dropdown | [dropdown.md](./dropdown.md) | Dropdown trigger with chevron |33| Hyperlinks | [hyperlinks.md](./hyperlinks.md) | Link styling with underline |34| Segmented Ctrl | [segmented-control.md](./segmented-control.md) | Toggle between mutually exclusive options |35| Input Field | [input-field.md](./input-field.md) | Text input with title and states |36| Search Input | [search-input.md](./search-input.md) | Search field with icon and clear |37| Checkbox | [checkbox.md](./checkbox.md) | Square multi-select control |38| Radio Button | [radio-button.md](./radio-button.md) | Circular single-select control |39| Toggle Switch | [toggle-switch.md](./toggle-switch.md) | Binary on/off switch |40| Tag | [tag.md](./tag.md) | Colored labels for categorization |41| Badge | [badge.md](./badge.md) | Small uppercase status indicators |42| Tab Bar | [tab-bar.md](./tab-bar.md) | Horizontal navigation tabs |43| Toast | [toast.md](./toast.md) | Transient notification messages |4445## Quick Reference4647### Fonts4849- **Inter** - Corporate font for UI text50- **JetBrains Mono** - Monospace font for code5152### Usage Guidelines53541. **Always use design tokens** - Never hardcode pixel values; use the token names (e.g., `text-sm`, `text-base`)552. **Respect the type scale** - Use the defined sizes; don't create custom sizes563. **Match weight to purpose** - Use semi-bold for headings, medium for emphasis, regular for body text574. **Apply letter-spacing** - Larger text sizes (2xl+) require negative letter-spacing5859### Spacing6061- **Scale:** 0, 0.5, 1, 2, 3, 4, 5, 6, 7, 8, 10, 16, 2062- **Base unit:** 4px (1 = 0.25rem = 4px)63- **Common:** p-2 (8px) for inputs, p-4 (16px) for containers, gap-4 (16px) for sections6465### Colors6667- **Primary:** Blue (`#0A54FF`) and Green (`#29E06C`)68- **Neutrals:** 11-shade grey scale from `neutral-800` (black) to `neutral-50` (white)69- **Semantic:** Success (green), Warning (yellow), Error (red)70- **Graph colors:** Blue, Lightblue, Purple, Pink, Orange, Yellow (in order)7172### Shadows7374- **shadow-l** - Sidepanels and modals (highest elevation)75- **shadow-m** - Popups76- **shadow-s** - Tooltips and toasts77- **shadow-xs** - Subtle elevation (lowest)7879### Buttons8081- **Primary** - Solid blue (`blue-500`), main actions82- **Secondary** - Outlined (`neutral-250` border), alternative actions83- **Tertiary** - Text-only, low-emphasis actions84- **Sizes:** XS (24px), S (28px), M (32px), L (36px)8586### Inputs8788- **Input Field** - M (32px), L (36px) heights; neutral-100 background89- **Search** - 32px height with search icon and clear button90- **Checkbox** - 16px square, 5px radius91- **Radio Button** - 16px circle92- **Toggle Switch** - 32x20px with sliding knob93- **Focus ring** - 3px primary-200 for inputs, 2px for controls9495### Tags & Badges9697- **Tag** - 24px height, 9 colors, add/remove variants98- **Badge** - 16px height, 8px uppercase text, 9 colors (same palette as tags)99100### Navigation101102- **Tab Bar** - 48px height, 2px active indicator, notification counter support103104### Feedback105106- **Toast** - 48px min-height, shadow-s, optional icon/subtitle/button/progress bar107108## CSS Custom Properties Naming Convention109110When implementing the design system in CSS, use the `--tnz-` prefix for all custom properties:111112```css113:root {114 /* Typography */115 --tnz-font-sans: "Inter Variable", "Inter", system-ui, sans-serif;116 --tnz-font-mono: "JetBrains Mono Variable", "JetBrains Mono", monospace;117118 /* Font Sizes */119 --tnz-text-xxs: 0.625rem; /* 10px */120 --tnz-text-xs: 0.75rem; /* 12px */121 --tnz-text-sm: 0.875rem; /* 14px */122 --tnz-text-base: 1rem; /* 16px */123 --tnz-text-lg: 1.125rem; /* 18px */124 --tnz-text-xl: 1.25rem; /* 20px */125 --tnz-text-2xl: 1.5rem; /* 24px */126 --tnz-text-3xl: 1.875rem; /* 30px */127 --tnz-text-4xl: 2.25rem; /* 36px */128 --tnz-text-5xl: 3rem; /* 48px */129130 /* Border Radius - 5px is the standard */131 --tnz-radius: 5px;132133 /* Spacing Scale (base unit: 4px) */134 --tnz-space-0: 0;135 --tnz-space-0-5: 0.125rem; /* 2px */136 --tnz-space-1: 0.25rem; /* 4px */137 --tnz-space-1-5: 0.375rem; /* 6px */138 --tnz-space-2: 0.5rem; /* 8px */139 --tnz-space-3: 0.75rem; /* 12px */140 --tnz-space-4: 1rem; /* 16px */141 --tnz-space-5: 1.25rem; /* 20px */142 --tnz-space-6: 1.5rem; /* 24px */143 --tnz-space-7: 1.75rem; /* 28px */144 --tnz-space-8: 2rem; /* 32px */145 --tnz-space-10: 2.5rem; /* 40px */146 --tnz-space-16: 4rem; /* 64px */147 --tnz-space-20: 5rem; /* 80px */148149 /* Shadows */150 --tnz-shadow-xs: 0px 8px 16px -8px #0e10171a, 0px 3px 6px -3px #0e10171a;151 --tnz-shadow-s: 0px 8px 16px -8px #0e101733, 0px 3px 6px -3px #0e101733;152 --tnz-shadow-m: 0px 10px 20px -8px #0e101733, 0px 4px 8px -6px #0e101733;153 --tnz-shadow-l: 0px 20px 40px -16px #0e101733, 0px 8px 16px -8px #0e101733;154155 /* Transitions */156 --tnz-transition-fast: 0.15s ease;157 --tnz-transition-base: 0.2s ease;158 --tnz-transition-slow: 0.3s ease;159160 /* Colors - see colors.md for full palette */161 /* Primary Blue */162 --tnz-primary-500: #0a54ff;163 --tnz-primary-600: #0043e0;164 /* ... etc */165166 /* Neutrals */167 --tnz-neutral-50: #fdfdfe;168 --tnz-neutral-100: #f7f8fa;169 --tnz-neutral-200: #f0f1f5;170 /* ... etc */171}172```173174**Important:** Always use design tokens via CSS custom properties. Never hardcode values like `font-family: 'Inter'` or `border-radius: 5px` - use `var(--tnz-font-sans)` and `var(--tnz-radius)` instead.175176## When to Load References177178Load the specific reference file when you need detailed specifications:179180- Working on typography? Read [typography.md](./typography.md)181- Implementing colors? Read [colors.md](./colors.md)182- Adding shadows/elevation? Read [shadows.md](./shadows.md)183- Building buttons? Read [buttons.md](./buttons.md)184- Adding spacing? Read [spacing.md](./spacing.md)