mds- Design System para Devs · versão interativa
Voltar à documentação

Mobiis Design System · para o time de desenvolvimento

Mobiis Design System para Devs

Como usar o MDS no código de amanhã de manhã: tokens, utilitários, componentes, a extensão do VS Code e a auditoria que pega o valor fixo antes do review.

@mobiis/mds-style 1.1.4@mobiis/mds-angulardesign.mobiis.com.br

Use ← → para navegar. Arraste a cena para girar. Mova o mouse sobre a malha de tokens.

02 · Por que importa

Menos CSS seu, mais tempo na regra de negócio

Menos CSS duplicado

Cor, espaçamento e tipografia já existem como token e classe.

Menos ajuste fino com o design

O componente já nasce no padrão visual.

Menos retrabalho em revisão

O review discute lógica, não um padding de 3px.

Consistência por padrão

Mesmo visual, mesmos estados, tema claro e escuro.

Agora: cada tela com seus próprios tamanhos e cores.

03 · O ecossistema

Um núcleo, um adaptador por tecnologia

O Figma desenha, os tokens viram o mds-style, e dele sai um adaptador para cada stack. Clique em uma etapa aqui ou na cena.

Figma e código divergem? Para o que já está implementado, vale o código. Siga o Storybook e avise o time do Design System.

04 · Os pacotes

Dois pacotes: um estiliza, o outro monta

@mobiis/mds-style

Tokens --mds-*, classes mds-*, utilitários, temas claro, escuro e dark blue. Traz também o tema MUI em /mui e as CLIs mds-style-audit e mds-style-mcp.

@mobiis/mds-angular

Componentes Angular prontos, com a API no Storybook. É de onde a extensão do VS Code lê os snippets.

$ npm i @mobiis/mds-style @mobiis/mds-angular

Tokens na base, CSS no meio, componentes em cima.

05 · Tokens e temas

Token no lugar de valor fixo, sempre

Tema
card-header.scsstema claro

Na cena, o card da esquerda usa os tokens e acompanha o tema. O da direita tem hex fixo e fica para trás. Valores lidos de src/scss/themes.

06 · Utilitários de layout

Layout sem escrever uma linha de CSS

Monte a classe: propriedade-lado--tamanho, na escala de espaçamento dos tokens.

Propriedade
Lado
Tamanho

Atalhos equivalentes: padding-a--md e p-all--md fazem o mesmo que padding-all--md. Para barras de filtro, d-flex gap--sm resolve a maior parte dos casos.

07 · Componentes e Storybook

A API real está no Storybook

1 · Ache

Pela categoria ou pelo nome.

2 · Leia a API

Inputs, outputs e tipos.

3 · Veja os estados

Teste antes de implementar.

variant

Clique no botão da cena para trocar a variante. Cores ilustrativas: as reais estão no Storybook.

Storybooks: design.mobiis.com.br/mds-angular · design.mobiis.com.br/mds-styles

08 · Extensão VS Code · demo

Do mds- ao componente pronto

Escolha um prefixo. O snippet é o mesmo que a extensão insere, gerado do código da biblioteca.

pedidos.component.html

09 · Extensões do VS Code · explore

Explore as extensões sem sair da página

MDS Angular - Mobiis Design System

Fretefy.mds-angular-snippets

Snippets, autocomplete, hover, diagnósticos e painel de componentes. Requer @mobiis/mds-angular.

Marketplace

Mobiis Theme

Fretefy.mobiis-theme

Quatro temas de cor com a paleta do MDS. Experimente na janela abaixo.

Marketplace
Recurso
Tema do editor
meu-app · Visual Studio Code
pedidos.component.html

10 · Auditoria de design

A auditoria acha o valor fixo antes do review

A CLI vem no @mobiis/mds-style. Ela lê HTML e CSS/SCSS e sugere o token certo.

terminal

No CI: sai com código 1 se houver erro. Ajuste regras em .mds-audit.json e suprima um caso com /* mds-ignore regra.id */. Templates Angular: use a CLI do mds-angular, que traz o adaptador.

11 · Diretrizes de UI e IA

As mesmas regras valem para você e para a IA

DESIGN.md

Decisões visuais, comportamento dos componentes e escrita, num arquivo só. Baixe o modelo na página DESIGN.md e anexe ao prompt.

MCP mds-style

mds_style_audit, mds_style_map_tokens e mds_style_get_rules direto no agente.

tokensbuttonformscopystructuretext-roles
# no seu prompt
"Siga o DESIGN.md anexo. Gere a tela de
 listagem de pedidos com componentes MDS e rode
 mds_style_audit antes de entregar."

12 · Próximos passos

Comece hoje em três passos

design.mobiis.com.br

Este navegador não abriu o WebGL, então a cena 3D não aparece. O conteúdo e os controles continuam funcionando.

Arraste para girar · clique nos objetos