Usando Temas
Um tema é um pacote de componentes prontos e arquivos de estilo que você instala no seu projeto. Em vez de criar tudo do zero, você parte de uma base visual consistente e personaliza o que precisar.
O que um tema fornece
- Componentes — botões, cards, navbars, heroes, formulários e muito mais, todos configuráveis via props
- Estilos — arquivos CSS com as classes base dos componentes
- JavaScript — comportamentos interativos como accordion, tabs e menus mobile
Tudo fica em themes/<nome>/ dentro do seu projeto. O Seed carrega automaticamente quando você ativa o tema no seed.yaml.
O tema padrão: seed-theme
O seed-theme é instalado automaticamente quando você cria um projeto com seed init. Ele inclui componentes para tipografia, layout, navegação, formulários, sidebars, tabs e muito mais.
Se o seed-theme não foi instalado (por exemplo, você estava offline), instale depois:
```bash seed theme-install meu-projeto https://github.com/ssjunior/seed-theme ```
Instalando um tema
A partir do GitHub
```bash seed theme-install meu-projeto https://github.com/usuario/nome-do-tema ```
O Seed clona o repositório, copia os arquivos para themes/<nome>/ e atualiza o seed.yaml automaticamente com theme: <nome>.
A partir de uma pasta local
```bash seed theme-install meu-projeto /caminho/para/o/tema ```
Útil quando você está desenvolvendo um tema localmente ou recebeu o tema como pasta compactada.
O que acontece durante a instalação
- Os arquivos do tema são copiados para
themes/<nome>/ - O
seed.yamlé atualizado comtheme: <nome> - Se o tema já estiver instalado, o Seed pergunta se você quer sobrescrever antes de continuar
Ativando o tema
O tema ativo é definido no seed.yaml na raiz do projeto:
```yaml theme: seed-theme ```
Apenas um tema pode estar ativo por vez. Para trocar de tema, altere o valor de theme: e reinicie o dev server.
Atualizando um tema
Para atualizar um tema instalado com a versão mais recente da fonte:
```bash seed theme-update meu-projeto https://github.com/usuario/nome-do-tema ```
O comando substitui os arquivos em themes/<nome>/ pela versão mais recente. Qualquer customização feita diretamente dentro da pasta do tema será perdida — por isso a forma recomendada de personalizar é via src/components/, não editando o tema diretamente. Veja mais em Customizando Temas.
O Seed não instala múltiplos temas simultaneamente. Se você instalar um segundo tema, ele substitui o anterior no seed.yaml. Os arquivos do tema anterior permanecem em themes/ mas ficam inativos.
Feito com ❤️ e Seed