Base para projetos com SolidJS, TypeScript e renderização no servidor (SSR). Inclui roteamento por arquivos, server functions, servidor Nitro e validação automatizada com Vite+.
Veja a demonstração do SolidJS Boilerplate para conhecer as páginas, os componentes e os idiomas disponíveis.
- SSR com hidratação, páginas de erro e proteção de chamadas de backend.
- Português, inglês e espanhol, com inglês como idioma base e URLs localizadas.
- Componentes com CSS Modules, tema claro, escuro ou do sistema e persistência.
- SEO por rota, dados estruturados, sitemap,
robots.txtellms.txt. - Testes de unidade, componentes e navegador com Vitest e Playwright.
- Formatação, lint, tipos, hooks de Git e CI com deploy na Vercel.
Instale o CLI global do Vite+. As versões de Node e Bun são definidas no package.json e gerenciadas pelo Vite+.
git clone git@github.com:everton-dgn/boilerplate_solidjs.git
cd boilerplate_solidjs
vp install
vp run devAbra o endereço exibido no terminal. O .env versionado contém a configuração
local; ajuste VITE_SITE_URL para a URL pública do projeto antes de publicar.
Veja ambiente, runtimes e deploy para os detalhes.
Para executar os testes de navegador e E2E, instale o Chromium uma vez:
vp run test:browser:install| Comando | Uso |
|---|---|
vp run dev |
Iniciar o servidor de desenvolvimento |
vp run build |
Gerar o build de produção |
vp run start |
Conferir o build localmente |
vp run validate |
Verificar formato, lint, tipos, cobertura, tooling e build |
vp run test:e2e |
Testar a aplicação com as fixtures E2E |
vp run test:e2e:production |
Testar as rotas reais de produção |
Use vp run dev e vp run build para executar os scripts com Bun. Vitest,
testes de tooling e SSR de produção permanecem em Node. Execute as duas suítes
E2E em sequência, pois compartilham porta e artefatos de build. A
referência de desenvolvimento contém os demais
scripts e as restrições de runtime.
| Guia | Conteúdo |
|---|---|
| Desenvolvimento | Ambiente, scripts, runtimes, cache, CI e deploy |
| Arquitetura | Rotas, organização de módulos e dependências entre camadas |
| Internacionalização | Catálogos, geração, navegação e persistência do idioma |
| Componentes e estilos | Campos, diálogos, notificações, tema, CSS e ícones |
| Segurança e CSP | Cabeçalhos, nonce, renderização e limites da política |
| Erros no servidor | Chamadas de backend, saída pública e recuperação |
| SEO | Metadados, dados estruturados e índices do site |
| Testes | Ambientes, isolamento, E2E e diagnóstico de falhas |
| Desempenho de SEO | Medições históricas e método de comparação |
| Releases | Versões, tags, changelog e recuperação da automação |
As convenções para agentes ficam no arquivo de instruções do projeto.