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.
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.
Na documentaçãoSobre o MDSComponentes-chave
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.
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-angularTokens na base, CSS no meio, componentes em cima.
Na documentaçãomds-styleStorybook do mds-angular
05 · Tokens e temas
Token no lugar de valor fixo, sempre
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.
Na documentaçãoDesign TokensCores
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.
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.
Na documentaçãoLayout & EspaçamentoFlexbox
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.
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
Na documentaçãoButton
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.
Na documentaçãoExtensões do VS CodeInputSelect
09 · Extensões do VS Code · explore
Explore as extensões sem sair da página
MDS Angular - Mobiis Design System
Fretefy.mds-angular-snippetsSnippets, autocomplete, hover, diagnósticos e painel de componentes. Requer @mobiis/mds-angular.
Mobiis Theme
Fretefy.mobiis-themeQuatro temas de cor com a paleta do MDS. Experimente na janela abaixo.
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.
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.
# 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."
Na documentaçãoDESIGN.mdDiretrizes de interfaceAssistente de escrita
12 · Próximos passos
Comece hoje em três passos
Na documentaçãoExtensões do VS Codemds-styleStorybook do mds-angular
Este navegador não abriu o WebGL, então a cena 3D não aparece. O conteúdo e os controles continuam funcionando.