← All projects

CASE STUDY

Magnetita Design System

From a visual library to a more consistent language for Foregon products.

Company
Foregon
Role
Product Design / Design Systems
Focus
UI Architecture · Scalability · Governance
Period
2023 – 2024
TEXTTEXTTEXTAdd to favorites11foregon
580de 1.000
Medium

Color, typography, grid, and spacing as shared decisions.

67 paint styles · 17 text styles · 3 effect styles · 2 grid styles

FEEDBACK COLORS

Informação/50#E3F2FD
Informação/100#BBDEFB
Informação/300#64B5F6
Informação/500#007AD9
Informação/700#1976D2
Informação/900#0D47A1
Link/50#E1F5FE
Link/100#B3E5FC
Link/300#4FC3F7
Link/500#1AD3FF
Link/700#039BE5
Link/900#01579B
Aviso/50#FFF8E1
Aviso/100#FFECB3
Aviso/300#FFD54F
Aviso/500#FFC107
Aviso/700#FFA000
Aviso/900#FF6F00
Ação/50#E0F7FA
Ação/100#B2EBF2
Ação/300#4DD0E1
Ação/500#00BCD4
Ação/700#0097A7
Ação/900#006064
danger/900#B71C1C
danger/700#D32F2F
danger/500#F44336
danger/300#E57373
danger/100#FFCDD2
danger/50#FFEBEE
Success/900#1B5E20
Success/700#388E3C
Success/500#4CAF50
Success/300#81C784
Success/100#C8E6C9
Success/50#E8F5E9

NEUTRAL COLORS

900#1D1D1D
800#3D3D3D
700#5C5C5C
600#707070
300#DBDBDB
100#F3F3F3
50#FFFFFF

PRIMARY COLORS

700#020653
600#00298F
500#0055B8
400#007AD9
300#1AD3FF
200#C4F6FF
100#E8FDFF

GRADIENTS

gradient-primario
gradient-premium
gradient empréstimo
gradient conta
gradient crédito

BACKGROUND COLORS

100#FFFFFF
200#FAFCFF
300#F3F3F3
400#707070
500#3D3D3D

PREMIUM COLOR

700#2C1B08
600#533516
500#7A4E25
400#A16733
300#FEB705
200#FED293
100#FEECC7

Typography

Outfit — 17 text styles · Desktop + Mobile · heading + body

Desktop / H1Magnetita Design System40px · Bold
Desktop / H2Magnetita Design System32px · Bold
Desktop / H3Magnetita Design System28px · Bold
Desktop / H4Magnetita Design System24px · Bold
Desktop / H5Magnetita Design System20px · Bold
Mobile / H1Magnetita Design System24px · Bold
Mobile / H2Magnetita Design System20px · Bold
Mobile / H3Magnetita Design System16px · Bold
Corpo de textoMagnetita Design System24px · Regular
Corpo de texto — BoldMagnetita Design System24px · Bold
Corpo de texto 1Magnetita Design System20px · Regular
Corpo de texto 1 — BoldMagnetita Design System20px · Bold
Corpo de texto 2Magnetita Design System16px · Regular
Corpo de texto 2 — SemiBoldMagnetita Design System16px · SemiBold
BotãoMagnetita Design System14px · ExtraBold
SobrancelhaMagnetita Design System14px · Bold
DescriçãoMagnetita Design System14px · Regular

The change went beyond appearance

A real comparison between Legacy and V2 components. The elements below represent instances from the Magnetita file.

LEGACY

Inconsistent naming

  • No defined states
  • No component set
Chip

V2

Component Set

51 variants · Type, State, Icon

V2 — FORM / INPUT

8 variants · Type × State × Filled

V2 — FORM / SWITCH

8 variants · On · Off · Hover · Focus · Disabled

Component Gallery

The real building blocks behind Foregon products, grouped by their role in the system.

Button / Primary

51 variants · Type (Primary, Card, Account, Loan, Link) × State (Normal, Hover, Focus, Disabled, Loading) × Icon

TYPE

primary
card
account
loan
link

STATE

default
hover
focus
disabled
loading

ICON

No icon
Right
Left

Atom → Molecule → Organism

01

ATOM

Buttons, Inputs, Switch, Radio, Badge, Tooltip, Loader

02

MOLECULE

Score Card, Status Card, Pop over, Navigation

250de 1.000
Score
03

ORGANISM

Carousels, Headers, Product Cards, Navigation, Complete screens

Add to favorites

Core × Team × Lab

A separation of responsibilities across shared, squad-specific, and experimental components.

01

💙 CORE

440 components · 56 component sets

Centralized governance. Used by Score, Cards, Loans, and Digital Account.

02

TEAM

234 components · 45 component sets

Autonomy within standards for squad-specific needs.

03

🧪 LAB

Protected sandbox

Token explorations, evolution proposals, and concept tests not yet formalized.

Token Model

An exploration of a semantic language for visual decisions.

PRIMITIVEVALUE→ SEMANTIC→ COMPONENT
primarias/500#0055B8action/primarybutton/background/default
primarias/300#1AD3FFaction/secondarybutton/background/hover
primarias/700#020653text/primaryheading/color
neutras/900#1D1D1Dtext/defaultbody/color
neutras/100#F3F3F3surface/secondarycard/background
danger/500#F44336feedback/errorinput/border/error
Success/500#4CAF50feedback/successbadge/background/success
Aviso/500#FFC107feedback/warningalert/background/warning

Evolution Roadmap

Nov 2023 – Mar 2024 · 5 phases

  1. 01

    Audit

    Component inventory, inconsistency mapping, and usage analysis across products.

  2. 02

    Foundations

    Color, typography, grid, and spacing became shared decisions: 67 paint styles and 17 text styles.

  3. 03

    Core Rebuild

    Atomic reconstruction from Atom to Molecule to Organism: 440 components and 56 component sets.

  4. 04

    Team / Lab

    Core, Team, and Lab were separated to balance autonomy and governance.

  5. 05

    Documentation

    Guidelines, usage patterns, and an In Memoriam deprecation model.

Deprecation Model

How components are retired without breaking products in production.

01

DEPRECATED

Deprecation tag, visual warning, and documented replacement.

02

IN MEMORIAM

Transition page, notified teams, and a migration period.

03

LIXO

Removed from active use and kept as a historical reference.

Components found in ‘In memoriam / Lixo’:

Ícone/Rounded/MenuÍcone/Rounded/FecharÍcone/Rounded/BuscaÍcone/Rounded/SetaBotão/Selection ControlBotão/Navegação/ChipBotão/Navegação/Item de listaBotão/Avaliação/Curtir

Documentation & Governance

  1. 01–03

    Discovery

    Need · Exploration · System Review

  2. 04–05

    Build

    Design + Engineering · Documentation

  3. 06–07

    Ship

    Release · Adoption

  4. 08–09

    Evolve

    Feedback · Iteration

DOCUMENTATION

Per-component guidelines, anatomy, props, variants, and do/don't living alongside the Figma component.

GOVERNANCE

Open contribution with review, proposals through Lab, consistency checks before promotion to Core, and semantic versioning.

My Contribution

01

SYSTEM STRATEGY

I helped define the Core / Team / Lab architecture and separate shared and squad-specific responsibilities.

02

COMPONENT EVOLUTION

I contributed to the Legacy-to-V2 evolution, atomic restructuring, and variant properties.

03

DESIGN QUALITY

I worked with the team on visual states, basic accessibility, and consistency across products.

04

PRODUCT ALIGNMENT

I helped align the needs of Score, Cards, Loans, and Digital Account with the system.

05

DOCUMENTATION

I contributed to component guidelines and the In Memoriam / Lixo deprecation model.

What I would do differently today

  1. 01

    TOKENS FIRST

    Start with Figma Variables from day one: Primitive → Semantic → Component.

  2. 02

    DOCUMENTATION AS A PRODUCT

    Apply the same design thinking used for interfaces to guidelines.

  3. 03

    GOVERNANCE BEFORE COMPONENTS

    Define contribution, review, and evolution before the library fragments.

  4. 04

    DESIGN × CODE PARITY

    Keep naming, props, and component tokens closer across Figma and code.

  5. 05

    NATIVE ACCESSIBILITY

    Make contrast, focus, target sizes, and keyboard navigation creation requirements.

  6. 06

    ADOPTION METRICS

    Track instance coverage, detach rate, and onboarding time.

Final reflections

A system is not a collection of components. It is a shared mental model.

The hardest part is not building it — it is driving adoption.

Consistency is a political decision, not only a visual one.

Documentation no one reads is not documentation.

A Design System matures when it stops organizing only components and starts organizing decisions.

Jhonatan Rafael — Product Designer

2023 – 2024 · RECONSTRUCTION 2026