Frontend Guidelines – Questionário
Uma referência prática e interativa para equipes estabelecerem padrões coesos de frontend, mantendo qualidade, manutenção e performance.
HTML
Princípios:
- HTML semântico, autoral e acessível (guia)
- Markup compatível com padrões W3C, uso criterioso de landmarks/aria.
- Comentário:
<!-- Explicação clara sobre o bloco -->
Ferramentas:
- Uso de preprocessador (ex: HAML, Pug) se facilitar sintaxe.
- Motores de template, ex: Mustache.
- Padronização conforme backend e nomenclaturas influentes.
Style:
- Indentação: 2 espaços.
- Comentários descritivos em blocos.
CSS
Principais Princípios:
- Modularidade, reutilização e nomeação consistente (CSS Guidelines)
- Metodologias como BEM/OOCSS/SMACSS (SMACSS | BEM)
Ferramentas:
- Pré-processador (Sass/Less) e guidelines (Sass)
- Base normalize.css ou reset.css
- Uso de autoprefixer/postprocessors.
Style:
- Indentação: 2 espaços; propriedades agrupadas; comentários com
/* Comentário */
JavaScript
Princípios:
- CLARIDADE, modularidade e uso de padrões documentados (Airbnb)
Ferramentas:
- Preferir frameworks/componentes estáveis (React/Vue/Angular).
- Testes unitários com Jest/Jasmine e linter ativo.
Style:
- 2 espaços, comentários
// Comentário breve e padrões como módulo, singleton.
Fontes
- Fontes web via
@font-face, Google Fonts ou serviços third-party.
- Apoio em ferramentas como Font Squirrel.
Acessibilidade
- Checklist A11Y Project, uso de ferramentas de avaliação automática.
Versionamento
- Git / GitHub com workflows claros (gitflow).
Suporte & Otimização
- Lista de dispositivos/browsers otimizados.
- Uso de sistema de suporte escalonado (Graded browser support).
Localização
- Implementação multilíngue e padrões de regionalização adequados.
Deploy/Integração
- Integração contínua (CI/CD) e deploy automatizado (Netlify/Vercel).
Documentação
- Guia vivo, versionado via repo, exemplos: Pattern Lab
- Responsáveis documentados no rodapé.