Design System

Citric Design System

Citric is a design system that helps create clean, consistent, and scalable interfaces. It unifies styles, components, and rules, making the design process faster.

Year :

2020

Industry :

Tech

Client :

Itau / ZUP I.T.

Project Duration :

6 Years

A unified system of reusable foundations and components that brings clarity, consistency, and structure to every interface.

What's inside

Design systems start with strong foundations. They define how components look, behave, and scale across the entire product.

Foundations

Typography

The typographic system defines text styles as design tokens and explains how titles and body text should be applied.

A wide range of clearly organized text styles, making it easy to select the right option for any screen or interface element.

Foundations

Color system

A flexible palette of semantic and functional colors that keeps interfaces consistent, clear, and expressive across the entire product.

Primitive colors

As the foundation of the palette, primitive colors define backgrounds, text, and neutral Ul surfaces, creating a consistent base that supports semantic and brand palettes across the entire interface.

Every color combination in the system was validated against WCAG contrast standards. This ensures that text and Ul elements remain readable and accessible across light and dark themes, regardless of size, state, or context.

Foundations

Spacing and radius

A consistent spacing and radius scale creates visual rhythm and predictable layouts. Each value exists as a reusable token, simplifying alignment across the interface.

Spacing

By establishing consistent Spacing values for margins, paddings, and alignments, teams can achieve visual harmony and enhance the overall user experience.

Border Radius

Radius help make Ul personable, easier to process, and recognizable at a glance. Selecting the correct radius for components builds consistent visual vocabulary and narrative.

Foundations

shadows

Shadows create depth and focus within the interface. A unified scale ensures visual hierarchy and keeps components looking consistent across different contexts.

Foundations

grid system

A 12-column grid provides flexibility for complex layouts. Consistent column width and gutter spacing help maintain structure and visual balance across wide screens.

Foundations

icons

A unified icon system built on consistent stroke, size, and grid rules. Icons stay clear and readable at any scale and adapt to semantic colors automatically.

+250 icons

A comprehensive library of more than 250 icons, carefully organized into four distinct categories. Quickly find what you need through an intuitive structure that simplifies navigation, reduces search time, and makes icon selection faster and more efficient.

Foundations

ILLUSTRATIONS

To create a more consistent and engaging experience across the ecosystem, Citric includes a dedicated illustration library designed to support communication, orientation, and empty-state experiences throughout the product.

The illustration system is organized into two main categories: Entity Illustrations and Error State Illustrations.

Entities

Were created to represent the core objects and modules available across the platform. These illustrations act as visual placeholders in empty states, onboarding moments, and content creation flows, helping users quickly understand the context of each section. The library includes dedicated illustrations for entities such as Accounts, Studios, Workspaces, Service Catalog, Stacks, Actions, and other product modules, ensuring visual consistency regardless of where users are navigating.

Error State

Were designed to make system feedback more approachable and human. Rather than relying solely on text messages, these illustrations help communicate issues such as missing content, unavailable resources, permission restrictions, and unexpected failures, reducing frustration while maintaining the product’s visual identity.

Buttoms

Buttons adapt to different use cases through shared variables: size, palette, type, and state. Every button follows the same spacing, grid, and logic, making interactions consistent across the entire interface.

Smart variations

Buttons are built on semantic tokens and adaptive properties.
Sizes, colors, and icons can be adjusted through variables, keeping the component flexible while preserving structure and clarity.

Input Fields

Input fields are built from reusable tokens — spacing, states, icons, and labels. This keeps interactions predictable and helps designers build forms faster.

Anatomy

The core structure includes label, field, and help text. Optional add-ons - prefix/suffix, icons, actions, and masks — fit the same grid and spacing for clarity.

States and variants

Inputs support multiple visual styles and clear interaction states
— default, typing, focus, error, disabled — ensuring predictable behavior across scenarios.

BADGES

Badges help draw attention to key information - status, priority, or category — using clear color semantics and flexible styling options.

Smart variations

Badges use the same spacing, color, and rules, keeping the interface consistent while adapting to different states and palettes.

Avatars

Avatars visually represent users, team members, or entities. They adjust to any context - supporting text initials, photos, or custom illustrations.

Smart variations

Built on shared sizing, spacing, and color tokens, avatars remain consistent across shapes and content types. They adapt to text initials, images, and illustrations, ensuring clarity and visual balance in any

Sizes

Choose the most appropriate size for each use case. Avatars scale consistently while preserving legibility, proportions, and visual recognition across lists, cards, tables, and collaborative experiences.

Colors

Use color variations to enhance identity, differentiation, and quick user recognition. Each option follows the design system palette, ensuring visual consistency and accessible contrast across different contexts and interfaces.

Switches, checkboxes, radiobuttons

These controls allow users to make quick selections or toggle states. Each component adapts to various palettes, sizes, and interaction states while maintaining a unified visual language.

Smart variations

All components follow shared spacing, sizing, and stroke rules, ensuring consistent visuals and interaction patterns across the entire interface.

Tooltips

Tooltips provide quick contextual hints without interrupting the user flow. They appear on hover or focus and help users understand actions, icons, or controls instantly.

Lightweight and informative

Tooltips adapt to different placements and component sizes, keeping spacing and styling consistent across variations.

Tables

Tables combine multiple Ul components — filters, pagination, badges, icons — into a flexible data-presentation pattern. Shared spacing, typography, and interaction rules keep the interface clear and easy to scan.

Reusable cell components

Table cells reuse simple Ul components — Avatars, Buttons, Rating, Progress — resulting in scalable layouts that are easy to adjust without breaking consistency.

Panels

Statistical widgets visualize key metrics in a clear and compact format. Data, labels, icons and states are combined into flexible cards that adapt to any scenario - from dashboards to detail views.

Flexible data cards

Cards follow consistent spacing tokens and structure, adapting to any data type - numbers, charts, or progress indicators. Components remain clean and readable at any size, making metrics easy to compare and visually

Menu

The structure adapts to the context - from simple dropdowns to complex multi-level navigation — keeping actions clear, accessible, and easy to scan.

Flexible and scalable

Flexible and scalable

Menus support icons, labels, shortcuts, and nested groups. The layout adapts to different levels of complexity and content density, preserving clarity and effortless navigation. Consistent spacing and typography maintain a clean structure across all variations.

Menus support icons, labels, shortcuts, and nested groups. The layout adapts to different levels of complexity and content density, preserving clarity and effortless navigation. Consistent spacing and typography maintain a clean structure across all variations.

calendar

A flexible date-selection system with multiple presets, ranges, and shortcuts. Components stay clear and responsive on any layout, making scheduling fast and effortless.

Calendar interactions stay intuitive

Calendars support multiple selection modes, shortcuts, and uick-range presets. Components adapt to different layouts and remain readable at any scale, helping users pick dates faster without breaking their flow.

file uploader

File uploader enables quick and intuitive file submission with real-time feedback. The component adapts to different states — uploading, success, or error — while keeping the interface clean and predictable.

Upload states

Clear visual states (uploading, success, error) help users understand progress instantly. Layout and spacing adapt depending on the number of files, ensuring readability and control at every step.

Build pages effortlessly

With a rich library of reusable components and consistent design rules, pages can be assembled in minutes - simply combine blocks, adjust content, and you're ready to ship. No extra styling or manual alignment required.

Design System

Citric Design System

Citric is a design system that helps create clean, consistent, and scalable interfaces. It unifies styles, components, and rules, making the design process faster.

Year :

2020

Industry :

Tech

Client :

Itau / ZUP I.T.

Project Duration :

6 Years

A unified system of reusable foundations and components that brings clarity, consistency, and structure to every interface.

What's inside

Design systems start with strong foundations. They define how components look, behave, and scale across the entire product.

Foundations

Typography

The typographic system defines text styles as design tokens and explains how titles and body text should be applied.

A wide range of clearly organized text styles, making it easy to select the right option for any screen or interface element.

Foundations

Color system

A flexible palette of semantic and functional colors that keeps interfaces consistent, clear, and expressive across the entire product.

Primitive colors

As the foundation of the palette, primitive colors define backgrounds, text, and neutral Ul surfaces, creating a consistent base that supports semantic and brand palettes across the entire interface.

Every color combination in the system was validated against WCAG contrast standards. This ensures that text and Ul elements remain readable and accessible across light and dark themes, regardless of size, state, or context.

Foundations

Spacing and radius

A consistent spacing and radius scale creates visual rhythm and predictable layouts. Each value exists as a reusable token, simplifying alignment across the interface.

Spacing

By establishing consistent Spacing values for margins, paddings, and alignments, teams can achieve visual harmony and enhance the overall user experience.

Border Radius

Radius help make Ul personable, easier to process, and recognizable at a glance. Selecting the correct radius for components builds consistent visual vocabulary and narrative.

Foundations

shadows

Shadows create depth and focus within the interface. A unified scale ensures visual hierarchy and keeps components looking consistent across different contexts.

Foundations

grid system

A 12-column grid provides flexibility for complex layouts. Consistent column width and gutter spacing help maintain structure and visual balance across wide screens.

Foundations

icons

A unified icon system built on consistent stroke, size, and grid rules. Icons stay clear and readable at any scale and adapt to semantic colors automatically.

+250 icons

A comprehensive library of more than 250 icons, carefully organized into four distinct categories. Quickly find what you need through an intuitive structure that simplifies navigation, reduces search time, and makes icon selection faster and more efficient.

Foundations

ILLUSTRATIONS

To create a more consistent and engaging experience across the ecosystem, Citric includes a dedicated illustration library designed to support communication, orientation, and empty-state experiences throughout the product.

The illustration system is organized into two main categories: Entity Illustrations and Error State Illustrations.

Entities

Were created to represent the core objects and modules available across the platform. These illustrations act as visual placeholders in empty states, onboarding moments, and content creation flows, helping users quickly understand the context of each section. The library includes dedicated illustrations for entities such as Accounts, Studios, Workspaces, Service Catalog, Stacks, Actions, and other product modules, ensuring visual consistency regardless of where users are navigating.

Error State

Were designed to make system feedback more approachable and human. Rather than relying solely on text messages, these illustrations help communicate issues such as missing content, unavailable resources, permission restrictions, and unexpected failures, reducing frustration while maintaining the product’s visual identity.

Buttoms

Buttons adapt to different use cases through shared variables: size, palette, type, and state. Every button follows the same spacing, grid, and logic, making interactions consistent across the entire interface.

Smart variations

Buttons are built on semantic tokens and adaptive properties.
Sizes, colors, and icons can be adjusted through variables, keeping the component flexible while preserving structure and clarity.

Input Fields

Input fields are built from reusable tokens — spacing, states, icons, and labels. This keeps interactions predictable and helps designers build forms faster.

Anatomy

The core structure includes label, field, and help text. Optional add-ons - prefix/suffix, icons, actions, and masks — fit the same grid and spacing for clarity.

States and variants

Inputs support multiple visual styles and clear interaction states
— default, typing, focus, error, disabled — ensuring predictable behavior across scenarios.

BADGES

Badges help draw attention to key information - status, priority, or category — using clear color semantics and flexible styling options.

Smart variations

Badges use the same spacing, color, and rules, keeping the interface consistent while adapting to different states and palettes.

Avatars

Avatars visually represent users, team members, or entities. They adjust to any context - supporting text initials, photos, or custom illustrations.

Smart variations

Built on shared sizing, spacing, and color tokens, avatars remain consistent across shapes and content types. They adapt to text initials, images, and illustrations, ensuring clarity and visual balance in any

Sizes

Choose the most appropriate size for each use case. Avatars scale consistently while preserving legibility, proportions, and visual recognition across lists, cards, tables, and collaborative experiences.

Colors

Use color variations to enhance identity, differentiation, and quick user recognition. Each option follows the design system palette, ensuring visual consistency and accessible contrast across different contexts and interfaces.

Switches, checkboxes, radiobuttons

These controls allow users to make quick selections or toggle states. Each component adapts to various palettes, sizes, and interaction states while maintaining a unified visual language.

Smart variations

All components follow shared spacing, sizing, and stroke rules, ensuring consistent visuals and interaction patterns across the entire interface.

Tooltips

Tooltips provide quick contextual hints without interrupting the user flow. They appear on hover or focus and help users understand actions, icons, or controls instantly.

Lightweight and informative

Tooltips adapt to different placements and component sizes, keeping spacing and styling consistent across variations.

Tables

Tables combine multiple Ul components — filters, pagination, badges, icons — into a flexible data-presentation pattern. Shared spacing, typography, and interaction rules keep the interface clear and easy to scan.

Reusable cell components

Table cells reuse simple Ul components — Avatars, Buttons, Rating, Progress — resulting in scalable layouts that are easy to adjust without breaking consistency.

Panels

Statistical widgets visualize key metrics in a clear and compact format. Data, labels, icons and states are combined into flexible cards that adapt to any scenario - from dashboards to detail views.

Flexible data cards

Cards follow consistent spacing tokens and structure, adapting to any data type - numbers, charts, or progress indicators. Components remain clean and readable at any size, making metrics easy to compare and visually

Menu

The structure adapts to the context - from simple dropdowns to complex multi-level navigation — keeping actions clear, accessible, and easy to scan.

Flexible and scalable

Flexible and scalable

Menus support icons, labels, shortcuts, and nested groups. The layout adapts to different levels of complexity and content density, preserving clarity and effortless navigation. Consistent spacing and typography maintain a clean structure across all variations.

Menus support icons, labels, shortcuts, and nested groups. The layout adapts to different levels of complexity and content density, preserving clarity and effortless navigation. Consistent spacing and typography maintain a clean structure across all variations.

calendar

A flexible date-selection system with multiple presets, ranges, and shortcuts. Components stay clear and responsive on any layout, making scheduling fast and effortless.

Calendar interactions stay intuitive

Calendars support multiple selection modes, shortcuts, and uick-range presets. Components adapt to different layouts and remain readable at any scale, helping users pick dates faster without breaking their flow.

file uploader

File uploader enables quick and intuitive file submission with real-time feedback. The component adapts to different states — uploading, success, or error — while keeping the interface clean and predictable.

Upload states

Clear visual states (uploading, success, error) help users understand progress instantly. Layout and spacing adapt depending on the number of files, ensuring readability and control at every step.

Build pages effortlessly

With a rich library of reusable components and consistent design rules, pages can be assembled in minutes - simply combine blocks, adjust content, and you're ready to ship. No extra styling or manual alignment required.

Design System

Citric Design System

Citric is a design system that helps create clean, consistent, and scalable interfaces. It unifies styles, components, and rules, making the design process faster.

Year :

2020

Industry :

Tech

Client :

Itau / ZUP I.T.

Project Duration :

6 Years

A unified system of reusable foundations and components that brings clarity, consistency, and structure to every interface.

What's inside

Design systems start with strong foundations. They define how components look, behave, and scale across the entire product.

Foundations

Typography

The typographic system defines text styles as design tokens and explains how titles and body text should be applied.

A wide range of clearly organized text styles, making it easy to select the right option for any screen or interface element.

Foundations

Color system

A flexible palette of semantic and functional colors that keeps interfaces consistent, clear, and expressive across the entire product.

Primitive colors

As the foundation of the palette, primitive colors define backgrounds, text, and neutral Ul surfaces, creating a consistent base that supports semantic and brand palettes across the entire interface.

Every color combination in the system was validated against WCAG contrast standards. This ensures that text and Ul elements remain readable and accessible across light and dark themes, regardless of size, state, or context.

Foundations

Spacing and radius

A consistent spacing and radius scale creates visual rhythm and predictable layouts. Each value exists as a reusable token, simplifying alignment across the interface.

Spacing

By establishing consistent Spacing values for margins, paddings, and alignments, teams can achieve visual harmony and enhance the overall user experience.

Border Radius

Radius help make Ul personable, easier to process, and recognizable at a glance. Selecting the correct radius for components builds consistent visual vocabulary and narrative.

Foundations

shadows

Shadows create depth and focus within the interface. A unified scale ensures visual hierarchy and keeps components looking consistent across different contexts.

Foundations

grid system

A 12-column grid provides flexibility for complex layouts. Consistent column width and gutter spacing help maintain structure and visual balance across wide screens.

Foundations

icons

A unified icon system built on consistent stroke, size, and grid rules. Icons stay clear and readable at any scale and adapt to semantic colors automatically.

+250 icons

A comprehensive library of more than 250 icons, carefully organized into four distinct categories. Quickly find what you need through an intuitive structure that simplifies navigation, reduces search time, and makes icon selection faster and more efficient.

Foundations

ILLUSTRATIONS

To create a more consistent and engaging experience across the ecosystem, Citric includes a dedicated illustration library designed to support communication, orientation, and empty-state experiences throughout the product.

The illustration system is organized into two main categories: Entity Illustrations and Error State Illustrations.

Entities

Were created to represent the core objects and modules available across the platform. These illustrations act as visual placeholders in empty states, onboarding moments, and content creation flows, helping users quickly understand the context of each section. The library includes dedicated illustrations for entities such as Accounts, Studios, Workspaces, Service Catalog, Stacks, Actions, and other product modules, ensuring visual consistency regardless of where users are navigating.

Error State

Were designed to make system feedback more approachable and human. Rather than relying solely on text messages, these illustrations help communicate issues such as missing content, unavailable resources, permission restrictions, and unexpected failures, reducing frustration while maintaining the product’s visual identity.

Buttoms

Buttons adapt to different use cases through shared variables: size, palette, type, and state. Every button follows the same spacing, grid, and logic, making interactions consistent across the entire interface.

Smart variations

Buttons are built on semantic tokens and adaptive properties.
Sizes, colors, and icons can be adjusted through variables, keeping the component flexible while preserving structure and clarity.

Input Fields

Input fields are built from reusable tokens — spacing, states, icons, and labels. This keeps interactions predictable and helps designers build forms faster.

Anatomy

The core structure includes label, field, and help text. Optional add-ons - prefix/suffix, icons, actions, and masks — fit the same grid and spacing for clarity.

States and variants

Inputs support multiple visual styles and clear interaction states
— default, typing, focus, error, disabled — ensuring predictable behavior across scenarios.

BADGES

Badges help draw attention to key information - status, priority, or category — using clear color semantics and flexible styling options.

Smart variations

Badges use the same spacing, color, and rules, keeping the interface consistent while adapting to different states and palettes.

Avatars

Avatars visually represent users, team members, or entities. They adjust to any context - supporting text initials, photos, or custom illustrations.

Smart variations

Built on shared sizing, spacing, and color tokens, avatars remain consistent across shapes and content types. They adapt to text initials, images, and illustrations, ensuring clarity and visual balance in any

Sizes

Choose the most appropriate size for each use case. Avatars scale consistently while preserving legibility, proportions, and visual recognition across lists, cards, tables, and collaborative experiences.

Colors

Use color variations to enhance identity, differentiation, and quick user recognition. Each option follows the design system palette, ensuring visual consistency and accessible contrast across different contexts and interfaces.

Switches, checkboxes, radiobuttons

These controls allow users to make quick selections or toggle states. Each component adapts to various palettes, sizes, and interaction states while maintaining a unified visual language.

Smart variations

All components follow shared spacing, sizing, and stroke rules, ensuring consistent visuals and interaction patterns across the entire interface.

Tooltips

Tooltips provide quick contextual hints without interrupting the user flow. They appear on hover or focus and help users understand actions, icons, or controls instantly.

Lightweight and informative

Tooltips adapt to different placements and component sizes, keeping spacing and styling consistent across variations.

Tables

Tables combine multiple Ul components — filters, pagination, badges, icons — into a flexible data-presentation pattern. Shared spacing, typography, and interaction rules keep the interface clear and easy to scan.

Reusable cell components

Table cells reuse simple Ul components — Avatars, Buttons, Rating, Progress — resulting in scalable layouts that are easy to adjust without breaking consistency.

Panels

Statistical widgets visualize key metrics in a clear and compact format. Data, labels, icons and states are combined into flexible cards that adapt to any scenario - from dashboards to detail views.

Flexible data cards

Cards follow consistent spacing tokens and structure, adapting to any data type - numbers, charts, or progress indicators. Components remain clean and readable at any size, making metrics easy to compare and visually

Menu

The structure adapts to the context - from simple dropdowns to complex multi-level navigation — keeping actions clear, accessible, and easy to scan.

Flexible and scalable

Flexible and scalable

Menus support icons, labels, shortcuts, and nested groups. The layout adapts to different levels of complexity and content density, preserving clarity and effortless navigation. Consistent spacing and typography maintain a clean structure across all variations.

Menus support icons, labels, shortcuts, and nested groups. The layout adapts to different levels of complexity and content density, preserving clarity and effortless navigation. Consistent spacing and typography maintain a clean structure across all variations.

calendar

A flexible date-selection system with multiple presets, ranges, and shortcuts. Components stay clear and responsive on any layout, making scheduling fast and effortless.

Calendar interactions stay intuitive

Calendars support multiple selection modes, shortcuts, and uick-range presets. Components adapt to different layouts and remain readable at any scale, helping users pick dates faster without breaking their flow.

file uploader

File uploader enables quick and intuitive file submission with real-time feedback. The component adapts to different states — uploading, success, or error — while keeping the interface clean and predictable.

Upload states

Clear visual states (uploading, success, error) help users understand progress instantly. Layout and spacing adapt depending on the number of files, ensuring readability and control at every step.

Build pages effortlessly

With a rich library of reusable components and consistent design rules, pages can be assembled in minutes - simply combine blocks, adjust content, and you're ready to ship. No extra styling or manual alignment required.