Criar com IA

Os editores com IA e os agentes de programação enganam-se muitas vezes com o sitelo: recorrem a padrões do React, Next ou Astro que aqui não se aplicam. Este guia mostra como apontá-los para a documentação atual do sitelo e manter o código gerado no modelo certo.

llms.txt

O sitelo publica um resumo do framework legível por máquinas em sitelo.dev/llms.txt. Muitos agentes conseguem descarregar um URL; pede ao teu que leia esse ficheiro (e a documentação para humanos) antes de escrever código do sitelo.

https://sitelo.dev/llms.txt — API e convenções em formato compacto
https://sitelo.dev/pt/docs — guias completos
README no GitHub — modelo mental e panorâmica das funcionalidades
https://ht.js.org — documentação do javascript-to-html (recomendado para escrever HTML em JS)

Ao contrário de um servidor MCP de documentação, o llms.txt não precisa de instalação — cola o URL na conversa, acrescenta-o às regras do projeto, ou deixa o agente descarregá-lo.

Regras de projeto

Se a tua ferramenta suportar instruções persistentes (AGENTS.md, regras do Cursor, instruções do Copilot, …), acrescenta uma regra curta sobre o sitelo para que cada sessão comece com o modelo mental certo. O exemplo básico inclui um AGENTS.md que podes copiar:

# sitelo

Este projeto usa o [sitelo](https://sitelo.dev) — um gerador de sites estáticos assente no Vite.

## Regras

- As páginas são módulos dentro de `src/` com extensões como `.ht.js` / `.ht.ts` / `.ht.jsx` que **exportam por omissão uma função (ou string) que devolve HTML**.
- **Não** introduzas React, Next.js, Astro nem qualquer framework de componentes/hidratação, a menos que o utilizador peça explicitamente.
- O encaminhamento baseia-se em ficheiros: `about.ht.js` → `/about`, `[slug].ht.js` → dinâmica (usa `generateStaticParams` para `sitelo build`).
- Carrega dados com `export async function data(ctx)`. Usa `fetchWithCache` do `sitelo` para HTTP com cache. Lê JSON local com `readJson` / `readJsonCollection` do `sitelo/data`.
- Só o JS/CSS referenciado a partir do HTML entra em `dist/`. Deixa o código de servidor sem referências para que nunca seja publicado.
- A configuração vive em `sitelo.config.js`. Coloca as opções do Vite sob `vite`.
- Comandos: `sitelo` (dev), `sitelo build`, `sitelo preview`.
- Para as APIs atuais, lê https://sitelo.dev/llms.txt e https://sitelo.dev/docs — não inventes APIs de outras frameworks.
- Prefere [javascript-to-html](https://ht.js.org) (`ht.js`) para a marcação: funções de etiqueta que devolvem strings HTML. Docs: https://ht.js.org

Cursor

Cria .cursor/rules/sitelo.mdc no teu projeto (ou cola o mesmo texto na interface de regras de projeto do Cursor):

---
description: convenções de sites estáticos do sitelo
alwaysApply: true
---

# sitelo

As páginas são módulos `.ht.js` (etc.) que devolvem strings HTML — não componentes de React/Next/Astro.
Prefere javascript-to-html (https://ht.js.org) para a marcação. Usa encaminhamento por ficheiros, `data()` e `sitelo build`.
Consulta https://sitelo.dev/llms.txt para as APIs do sitelo.

Dicas para trabalhar no sitelo com IA

Parte de um modelo — pede ao agente que gere o esqueleto a partir de examples/basic ou examples/wordpress em vez de inventar um framework.
Prefere o javascript-to-html (ht.js) para a marcação — funções de etiqueta que devolvem strings HTML, sem motor de templates nem React. Aponta os agentes para ht.js.org para que não inventem árvores de componentes JSX.
As páginas são funções que devolvem HTML — export default () => `<html>…</html>` ou compostas com javascript-to-html. JSX serve enquanto compilar para strings; não é preciso um runtime do React.
Usa a CLI do sitelo — sitelo / sitelo build — e não o vite diretamente, a não ser que saibas que precisas de uma configuração do Vite própria.
Verifica as APIs contra o llms.txt — sobretudo generateStaticParams, fetchWithCache e as ilhas de servidor.
Zero JS por omissão — só liga um <script> quando a página precisar de código de cliente; os módulos sem referências ficam no servidor.
Revê e executa — corre sempre sitelo build (ou o servidor de desenvolvimento) depois de o agente editar páginas; trata a marcação gerada como um rascunho.

Primeiros passos · Exemplo básico · llms.txt