acerola-design Como o app parece
Tokens, tipografia, componentes, estados obrigatórios, acessibilidade, movimento, texto, ícone e mascote.
Padrão de projeto
Web, extensão, desktop, Android ou Rust: a mesma estrutura, o mesmo git, os mesmos hooks, o mesmo i18n e o mesmo design. Este repositório segue o padrão e entrega o kit para começar qualquer projeto.
Claude Code
O agente carrega a skill certa antes de mexer, e os hooks recusam o que fugir dela.
acerola-design Tokens, tipografia, componentes, estados obrigatórios, acessibilidade, movimento, texto, ícone e mascote.
acerola-project Inglês em tudo que o usuário não vê, estrutura de pastas, padrões por camada, i18n, licença e projeto novo.
acerola-git Commit, Git-Flow, travas de branch, PR, issues, Actions, Dependabot e release.
Idioma
Pastas, arquivos, rotas, variáveis, tipos, chaves de JSON e de config, tabelas, colunas, modelos, logs e comentários de código. Em português (via i18n) fica só o que aparece na tela; docs, skills, commits e PRs são para pessoas e seguem em português.
// code: English
const watchedEpisodes = await mediaRepository.findProgress(userId);
// table media_progress (user_id, media_id, episode, updated_at)
// route /library/anime · file library-screen.svelte
// screen: i18n
m['library.progress.episode']({ current, total }) // → "Ep 5 de 12"i18n
Paraglide (inlang) com pt-br e en. Chave em inglês e aninhada por assunto: mais um nível em vez de _ ou - para emendar contexto.
{
"library": {
"search": {
"placeholder": "Buscar título",
"empty": "Nada encontrado"
}
}
}{
"library_search_placeholder": "Buscar título",
"library": { "search_empty": "Nada encontrado" },
"biblioteca": { "busca": "…" }
}Estrutura
O código mora em pastas com o nome do local do commit. Na raiz, só o que é do repositório inteiro.
<repo>/
├── <app>/ one folder per app (name = commit scope)
│ └── messages/ pt-br.json · en.json (i18n)
├── lib/<name>/ library shared between apps
├── docs/ ARQUITETURA.md, guides and README images
├── scripts/
│ ├── git/ branch-guard.sh · commit-msg.mjs · setup-git.mjs
│ ├── design/ check-design.mjs
│ └── i18n/ check-i18n.mjs
├── .claude/ settings.json (hooks) · skills/
├── .github/ workflows · ISSUE_TEMPLATE · PR template · CODEOWNERS · dependabot
├── acerola.config.json name, commit scopes, design and i18n folders
├── CLAUDE.md project rules and deviations from the standard
├── README.md · CONTRIBUTING.md · RELEASE.md · LICENSE (MPL-2.0)
└── .gitmessage · .gitattributes · .editorconfig · lefthook.ymlSão o padrão, não lei: trocar é permitido com o motivo escrito em "Desvios do padrão" no CLAUDE.md do projeto.
Git
Português, primeira maiúscula, sem ponto, até 100 caracteres. Um local por commit. Merge também segue o formato.
[feat](site): Hero em pôster com Titan One
[fix](kit): Hook de design ignora arquivo gerado
[chore](deps): Sobe o SvelteKit para a 3.1
[merge](site): Página do padrão de projetomain produção · só quem administra faz merge e pushdevelop integração · só recebe merge, nada de commit diretofeature/<name> funcionalidade · sai da develop e volta para elabugfix/<name> correção · sai da develop e volta para elarelease/<version> versão · vai para main e develop, com tag vX.Y.Zhotfix/<version> urgência · sai da main, vai para main e developHooks
lefthook no git (igual para Rust, Kotlin ou Node) e hooks do Claude Code no agente.
commit-msg.mjs formato, tipo e local do commitbranch-guard + check-design + check-i18n trava main/develop, confere design e i18nbranch-guard trava merge na mainbranch-guard trava push na maincheck-design --summary regras de design no contextocheck-design + check-i18n --hook recusa o arquivo que fugiu do design ou do i18nGitHub
Templates de issue e PR, CODEOWNERS por pasta, e workflows com nome e gatilho previsíveis.
Licença
Código, CSS, scripts, skills, docs, ícone e mascote. O que é de terceiros mantém a licença de origem (fontes em SIL OFL 1.1).
"license": "MPL-2.0"license = "MPL-2.0"// SPDX-License-Identifier: MPL-2.0Projeto novo
Do zip ao primeiro commit na develop.