styling-tenzir-ui

tenzir's avatarfrom tenzir

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.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026⬇️1downloads

When & Why to Use This Skill

The Styling Tenzir UI skill serves as a comprehensive digital style guide and technical reference for the Tenzir design system. It enables developers and designers to implement consistent user interfaces by providing instant access to design tokens, CSS custom properties, and detailed component specifications. By centralizing guidelines for typography, color palettes, spacing scales, and interactive elements, it ensures brand-aligned frontend development and streamlines the transition from design to code.

Use Cases

  • Implementing brand-consistent UI components such as buttons, inputs, and navigation bars using Tenzir's standardized specifications.
  • Applying precise styling to web applications using CSS custom properties (--tnz-prefix) for colors, shadows, and border radii to ensure visual harmony.
  • Referencing the official spacing scale and typography system to build responsive layouts that adhere to Tenzir's corporate font guidelines (Inter and JetBrains Mono).
  • Quickly retrieving technical details for complex UI patterns like Toasts, Segmented Controls, and Tab Bars to maintain functional consistency across different product modules.
namestyling-tenzir-ui
descriptionProvides 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.

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:

Aspect Reference Description
Typography typography.md Font families, sizes, weights, line heights
Colors colors.md Brand colors, semantic colors, neutrals
Spacing spacing.md Padding and margin scale
Shadows shadows.md Elevation and shadow styles
Border Radius border-radius.md Corner radius tokens (always 5px)
Buttons buttons.md All button styles (standard, delete, floating)
Dropdown dropdown.md Dropdown trigger with chevron
Hyperlinks hyperlinks.md Link styling with underline
Segmented Ctrl segmented-control.md Toggle between mutually exclusive options
Input Field input-field.md Text input with title and states
Search Input search-input.md Search field with icon and clear
Checkbox checkbox.md Square multi-select control
Radio Button radio-button.md Circular single-select control
Toggle Switch toggle-switch.md Binary on/off switch
Tag tag.md Colored labels for categorization
Badge badge.md Small uppercase status indicators
Tab Bar tab-bar.md Horizontal navigation tabs
Toast toast.md Transient notification messages

Quick Reference

Fonts

  • Inter - Corporate font for UI text
  • JetBrains Mono - Monospace font for code

Usage Guidelines

  1. Always use design tokens - Never hardcode pixel values; use the token names (e.g., text-sm, text-base)
  2. Respect the type scale - Use the defined sizes; don't create custom sizes
  3. Match weight to purpose - Use semi-bold for headings, medium for emphasis, regular for body text
  4. 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)
  • 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: