Suporte a versões
Versões do AiDocs
| Versão | Status | Suporte até |
|---|---|---|
| 0.x | Em desenvolvimento | — |
O AiDocs ainda está em desenvolvimento ativo. A API pública pode mudar entre versões 0.x. A partir da 1.0.0, o projeto adotará Semantic Versioning.
Node.js
| Node.js | Suportado |
|---|---|
| 22.x (LTS) | ✅ |
| 20.x (LTS) | ✅ |
| 18.x | ⚠️ Não testado |
| < 18 | ❌ |
Recomendamos sempre usar a versão LTS mais recente do Node.js.
Angular
O AiDocs usa Angular internamente para renderizar o tema via SSR. Você não precisa ter Angular no seu projeto — o motor de renderização já vem embutido e pré-buildado dentro do pacote @aiandrameira/ai-docs; o resultado final (ai-docs build) é sempre HTML estático puro.
| Angular | Versão do AiDocs |
|---|---|
| 21.x | 0.x |
Compatibilidade de build
O output gerado é HTML estático puro. Funciona em qualquer ambiente que sirva arquivos estáticos:
- GitHub Pages
- Vercel
- Netlify
- AWS S3 + CloudFront
- Qualquer servidor Nginx/Apache
Política de breaking changes
Durante a fase 0.x:
- Mudanças no schema do
ai-docs.config.tsserão documentadas no changelog - Estrutura de pastas e frontmatter permanecem estáveis
- APIs internas (componentes Angular, parsers) podem mudar sem aviso
A partir da 1.0.0, qualquer breaking change virá acompanhada de um major bump e um guia de migração.