O que Landing estática do repositório faz?
Gere uma página de destino estática (docs/index.html + docs/style.css + docs/main.js) cujo conteúdo é extraído do repositório onde está inserida. Nunca liste recursos, provedores ou comandos que não existam de fato no repositório.
Fonte da Verdade para o Conteúdo
Antes de escrever qualquer coisa, leia o seguinte:
README.*— visão geral, recursos, stack tecnológico, comandos de instalação/início rápidoLICENSE*— nome da licença, versão, URLCHANGELOG.*— resumo do histórico de alteraçõespackage.json,composer.json,requirements.txt, etc.: nome, descrição, dependências (base para badges de stack tecnológico)AGENTS.md,CLAUDE.md,config.toml,GEMINI.md, etc.: o propósito do projeto e, se o projeto tiver, tabelas de provedores/configurações suportadas- Um
docs/index.htmlexistente (se presente): a menos que seja explicitamente solicitado um redesign, reutilize sua estrutura de seções e edite o conteúdo no lugar, em vez de reconstruir do zero
Elementos Obrigatórios
-
Tema claro/escuro — Sobrescreva as propriedades personalizadas CSS (
--bg,--text,--accent, etc.) com uma media queryprefers-color-scheme: dark. Não adicione um alternador de tema JS a menos que seja solicitado. -
Cartão OGP + Twitter/X —
og:title,og:description,og:url,og:image,og:type,og:site_name,twitter:card,twitter:title,twitter:description,twitter:image. Aponteog:image/twitter:imagepara um ativo que já exista de fato no repositório (por exemplo,social-preview.png). Se nenhum existir, gere um primeiro com a habilidademake-social-preview. -
Esquema JSON-LD — Um bloco
<script type="application/ld+json">(SoftwareApplicationpara um aplicativo/ferramenta; caso contrário, qualquer@typeque se encaixe no projeto). Mantenha-o consistente com a descrição OGP. -
Favicon — Faça referência a um SVG Twemoji que se adeque ao projeto com
<link rel="icon">. -
Suporte multilíngue via
multilanguagejs(CDN, sem etapa de build):<script src="https://unpkg.com/[email protected]/dist/multilanguagejs.umd.cjs"></script>Envolva cada elemento a ser traduzido em
<template type="language-group">e, dentro dele, coloque um elemento filho por idioma, cada um com um atributolanguage="xx"(nãolang):<h2> <template type="language-group"> <span language="en">Features</span> <span language="ja">機能</span> </template> </h2>Cada
template[type=language-group]deve conter exatamente um elemento por idioma suportado —multilanguagejspega o primeiro[language=X]correspondente por template, então duplicatas fazem com que o conteúdo seja perdido silenciosamente.Inicialize-o em
main.js:var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" }); ml.setLanguage(lang); // ao carregar e no evento de mudança do <select> alternador<title>e<meta name="description">estão fora do escopo dos modelos[language](a biblioteca apenas atualiza otextContentdos elementos correspondentes, e a tradução de uma tag<meta>está em seu atributocontent, não em seu texto). Dê amain.jsum pequeno dicionário{ title, description }por idioma e atualize essas duas tags manualmente junto comml.setLanguage().Detecte o idioma do visitante a partir de
navigator.language, salve o idioma selecionado emlocalStoragee, ao carregar, reaplique-o antes de recorrer à detecção do navegador.Conjunto de idiomas obrigatório (sempre, independentemente do que o próprio aplicativo suporta): Inglês (
en), Japonês (ja), Chinês (zh), Espanhol (es), Russo (ru), Alemão (de) — pelo menos 6 idiomas. Isso se aplica mesmo quesrc/locales/*.jsonou o próprioi18n.ts/i18n.jsdo aplicativo cubra apenas alguns deles (por exemplo, mesmo para um aplicativo apenas emen/ja, faça a página de destino em 6 idiomas). Se solicitado, você pode adicionar outros idiomas a esses 6. -
Botões copiar para a área de transferência — Dê a cada comando de instalação/execução mostrado em um bloco
<code>um botão de cópia com um ícone SVG inline (nunca um emoji), com um estado de confirmação de marca de seleção vianavigator.clipboard.writeText(). Para layout consistente, envolva o<code>e seu botão em um contêiner flex.code-row. -
Responsivo — Mobile-first. Não cause rolagem horizontal em viewports estreitas, exceto dentro de contêineres explicitamente destinados a rolar (por exemplo, uma tabela de comparação larga).
-
Nenhuma etapa de build — Faça a página funcionar apenas abrindo o arquivo HTML ou servindo a pasta estática como está, independentemente de qual bundler (Vite, etc.) o próprio aplicativo usa. Mantenha
main.jscomo código-fonte legível. Carregue-o diretamente na página com<script src="main.js">. -
Estrutura semântica — Estruture estes elementos semanticamente: hero (título, texto principal, CTA, comando de execução principal), capturas de tela (reutilize URLs de ativos existentes do repositório/GitHub, se houver), grade de recursos, comandos de início rápido/instalação, badges de stack tecnológico, rodapé.
-
Reutilize CSS existente — Reutilize as propriedades personalizadas CSS e nomes de classe já existentes em
docs/style.cssdo repositório, em vez de criar um sistema de estilos paralelo e separado. -
Respeite o sistema de design — Respeite o sistema de design no ambiente de tempo de execução do agente de IA existente. Ao adicionar novo CSS, reutilize propriedades personalizadas e nomes de classe existentes e siga as convenções de nomenclatura, design, layout e tom e maneira consistentes com o sistema de design do repositório.
Fluxo de Trabalho
- Leia as fontes de conteúdo acima.
- Se
docs/não existir, crie-o. - Se
docs/index.htmljá existir, edite-o no lugar — a menos que seja explicitamente solicitado um redesign, não o substitua por completo; mantenha a estrutura de seções e atualize o conteúdo. - Estruture as seções semanticamente: hero (título, texto principal, CTA, comando de execução principal), capturas de tela (reutilize URLs de ativos existentes do repositório/GitHub, se houver), grade de recursos, tabela de comparação/configurações (se o projeto tiver vários provedores/modos/backends que valham a pena comparar), comandos de início rápido/instalação, badges de stack tecnológico, rodapé.
- Reutilize as propriedades personalizadas CSS e nomes de classe já existentes em
docs/style.cssdo repositório, em vez de criar um sistema de estilos paralelo e separado. - Atualize
docs/main.js. - Verifique antes de finalizar: nenhum emoji é usado para ícones interativos (apenas SVG); cada
template[type=language-group]tem exatamente um elemento filho por idioma suportado, sem duplicatas ou omissões; OGP/JSON-LD apontam para arquivos/URLs que realmente existem no repositório.