Primeiros passos

O sitelo é um gerador de sites estáticos sem configuração, assente no Vite. Instala um único pacote, escreve funções que devolvem HTML e corre sitelo build.

Instalação

npm install -D sitelo

Requer Node 20.19+ (ou 22.12+). O Vite vem incluído — não é preciso instalá-lo à parte.

A tua primeira página

Cria src/index.ht.js (ou .ht.jsx). Recomendamos o ht.js:

export default () => `
  <html lang="pt">
    <head><title>O meu site</title></head>
    <body><h1>Olá, mundo</h1></body>
  </html>
`

import { html, head, title, body, h1 } from 'javascript-to-html'

export default () =>
  html({ lang: 'pt' },
    head(title('O meu site')),
    body(h1('Olá, mundo'))
  )

export default function Home() {
  return (
    <html lang="pt">
      <head><title>O meu site</title></head>
      <body><h1>Olá, mundo</h1></body>
    </html>
  )
}

Executar

sitelo          # servidor de desenvolvimento
sitelo build    # escreve dist/
sitelo preview  # pré-visualiza a compilação

Isso produz dist/index.html (com <!DOCTYPE html> acrescentado automaticamente) e um 404.html por omissão.

Passos seguintes

Escrever páginas — templates de string, JSX e módulos estruturados
Rotas — rotas baseadas em ficheiros e generateStaticParams
Carregamento de dados — data() e fetchWithCache
Recursos e estilos — JS/CSS de frontend compilados pelo Vite (src/js, src/css)
Configuração — sitelo.config.js e opções do Vite
Criar com IA — llms.txt, regras de projeto e dicas para agentes