Landing Pages e Aplicações Web
Escolha o tipo de site certo e veja como uma Landing Page ou uma Aplicação Web é organizada. A IA cuida dos arquivos.
Quando usar cada tipo de site
Seção intitulada “Quando usar cada tipo de site”O tipo é escolhido na criação.
| Página Estática | Landing Page | Aplicação Web | |
|---|---|---|---|
| Tecnologia | HTML, CSS e JavaScript | Astro | TanStack Start (React no servidor) |
| Páginas | Arquivos .html na raiz |
src/pages |
src/routes |
| Código no servidor | Não | Só em páginas sob demanda | Sim |
| Variáveis, segredos, banco de dados e KV | Não | Sim | Sim |
| Upload pelo painel | Sim | Não | Não |
| Plano necessário | Todos | Todos | Pro ou Diamante |
- Página Estática: páginas simples, documentos e sites prontos em HTML.
- Landing Page: sites de conteúdo com várias páginas, blog, portfólio ou negócio; rápida e pode ter formulários com banco de dados.
- Aplicação Web: login, telas dinâmicas, chatbot ou lógica no servidor.
Mais detalhes em Tipos de site e arquivos.
Plano necessário para Aplicação Web
Seção intitulada “Plano necessário para Aplicação Web”A Aplicação Web está nos planos Pro e Diamante e conta na cota de aplicações. Quando a cota acaba, a criação é recusada e a IA sugere mudar de plano ou usar uma Landing Page. Veja Planos e limites.
Estrutura de arquivos de uma Landing Page
Seção intitulada “Estrutura de arquivos de uma Landing Page”- AGENTS.md guia do template (não é publicado) - astro.config.mjs - package.json - wrangler.jsonc opcional, para variáveis, banco de dados e KV - migrations/ opcional, SQL do banco de dados - public/ arquivos avulsos - favicon.svg - robots.txt - sitemap.xml - src/ - pages/ - index.astro página inicial, em / - contato.astro
- As páginas são pré-renderizadas. Uma página com
export const prerender = falseé renderizada sob demanda e só ela lê variáveis de execução, segredos, banco de dados e KV. public/guarda só arquivos avulsos, comositemap.xmle ícones.
Estrutura de arquivos de uma Aplicação Web
Seção intitulada “Estrutura de arquivos de uma Aplicação Web”- AGENTS.md guia do template (não é publicado) - package.json - vite.config.ts - wrangler.jsonc - migrations/ opcional, SQL do banco de dados - public/ arquivos avulsos - sitemap.xml - robots.txt
Directorysrc/ - router.tsx - routes/ - __root.tsx - index.tsx página inicial, em /
- …
As rotas ficam em src/routes.
Build e dependências
Seção intitulada “Build e dependências”A Landing Page e a Aplicação Web passam por um build a cada publicação (bun run build). Se o build falhar, a publicação fica failed, o erro diz o que corrigir e a versão anterior continua no ar. Veja A publicação falhou.
O que o wrangler.jsonc aceita
Seção intitulada “O que o wrangler.jsonc aceita”O wrangler.jsonc declara variáveis (vars), KV (kv_namespaces) e banco de dados D1 (d1_databases). Além de banco de dados (D1) e KV, outros recursos não estão disponíveis. A IA declara os recursos por você. Veja Banco de dados e KV.
O AGENTS.md dos templates
Seção intitulada “O AGENTS.md dos templates”Muitos templates trazem um AGENTS.md na raiz: o guia do template para a IA. A IA o segue e o mantém atualizado. O arquivo não é publicado.
Prompts de exemplo
Seção intitulada “Prompts de exemplo”Crie uma Landing Page no Site no Ar para minha confeitaria, com página inicial, cardápio e contato. Use o endereço doces-da-ana.Crie uma Aplicação Web no Site no Ar com um formulário de orçamento que salva os pedidos num banco de dados e uma página para eu ver a lista.