Skip to content

marcosprofile/finpay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 

Repository files navigation

Finpay — UI Architecture & Design System

Transformando um layout visual em um sistema escalável, consistente e pronto para engenharia.

image

Projeto: Acessar
Behance: Acessar
Figma: Acessar


Sobre o Projeto

Este projeto é um estudo de arquitetura de interface focado na construção de um Design System escalável, partindo de um layout estático para uma implementação estruturada e reutilizável.

O objetivo foi ir além do visual, definindo tokens, componentes e padrões de código, garantindo consistência entre design e desenvolvimento.


Problema

Layouts estáticos não escalam.

Sem uma arquitetura clara:

  • inconsistências visuais surgem rapidamente
  • o handoff entre design e desenvolvimento se perde
  • a manutenção se torna cara e complexa

Solução

Foi construída uma arquitetura baseada em Design Tokens + Componentes, permitindo:

  • consistência visual em toda a interface
  • separação clara entre estilo e implementação
  • escalabilidade para novos componentes e telas
  • integração direta entre Figma e código

Design System

🔹 Tokens

Estruturados em dois níveis:

  • Primitivos: cores base, tipografia, espaçamento
  • Semânticos: aplicação dos tokens em contexto (background, text, border, etc)

Exemplo:

/*Primitivos*/
--color-primary-600: #0084D1;
--color-neutral-primary: #4A5565;

/*Semânticos*/
--bg-primary: var(--color-primary-600);
--button-primary-bg: var(--bg-primary);
--color-text-brand: var(--color-neutral-primary);

🔹 Componentes

Componentes construídos com foco em reutilização e variação:

  • Button

    • Variants: primary, secondary, tertiary
    • States: default, hover, focus, active, disabled
  • Input

    • Estados: default, focus, error, success, disabled
    • Validação com feedback visual

💻 Implementação

A interface foi desenvolvida utilizando HTML5 semântico e CSS moderno, com foco em escalabilidade.

Principais decisões:

  • CSS Variables (Design Tokens):
    Conexão direta entre Figma e código

  • Arquitetura modular:
    Separação entre base, tokens e componentes

  • BEM + Data Attributes:
    Controle de variantes e estados sem dependência excessiva de classes

Exemplo HTML:

<button class="button" data-variant="primary" data-size="medium">
  Label
</button>

Exemplo CSS:

.button[data-variant="primary"] {
  background: var(--button-primary-bg);
}

Estrutura do Projeto

src/
├── assets/        
├── css/
│   ├── base/      
│   ├── components/
│   └── layout/    
├── js/            
└── index.html     

Fluxo Design → Código

Figma (Tokens)
   ↓
CSS Variables
   ↓
Componentes reutilizáveis
   ↓
Interface final

Resultado

Form de Signup

image
  • Input com validação (error / success)
  • Botão com estados (disabled → enabled)
  • Uso real dos tokens em contexto

Tecnologias

  • Design
    • Figma (Tokens, Auto Layout, Components)
  • Front-end
    • HTML5, CSS3 (Variables, Nesting, BEM, Data Attributes)
  • Versionamento
    • Git & GitHub

Aprendizados

  • Estruturação de Design Tokens escaláveis
  • Criação de componentes reutilizáveis com estados
  • Conexão eficiente entre design e código
  • Arquitetura de UI voltada para crescimento

About

Finpay – UI Architecture & Design System

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors