Trustio

Site institucional da Trustio. Site estático, responsivo e sem dependências de execução, publicado em https://trustio.com.br via GitHub Pages.

Estrutura

• index.html: página institucional completa (plataforma, faixa de API, painel de servidor, segurança, implantação).
• modelos.html: catálogo Modelos Poderosos — modelos de fronteira disponíveis.
• manifesto.html: experiência editorial dedicada ao Manifesto.
• fundador.html: página do fundador.
• 404.html: página de erro personalizada (usa caminhos absolutos, obrigatório para funcionar em URLs aninhadas).
• assets/styles.css: identidade visual e responsividade. Tokens em :root (cores, gradientes compostos, --container, --cta-gradient, escala de espaçamento --space-N) e tema claro em :root[data-theme="light"].
• assets/theme.js: aplica o tema salvo antes da primeira pintura. Carregado de forma síncrona no <head>, antes do CSS, em todas as páginas. O escuro é o padrão; o claro é opt-in pelo alternador do cabeçalho e persiste em localStorage (trustio-theme).
• design-system/: bundle de sincronização com o claude.ai/design (tokens, previews de componentes, fotografia e artes). Não é usado pelo site; bloqueado em robots.txt. Veja design-system/README.md.
• assets/app.js: navegação, animações, campo digital de pontos e painel LED do servidor.
• assets/fonts/: fontes oficiais hospedadas localmente.
• SECURITY.md: controles incorporados e cabeçalhos recomendados.

Publicação

O deploy é automático: todo push na branch main republica o site, servido a partir da raiz do repositório (Settings > Pages > Deploy from a branch > main / (root)).

• Domínio próprio: arquivo CNAME com trustio.com.br. O DNS já aponta para o GitHub Pages (185.199.108-111.153) e o certificado HTTPS está ativo com https_enforced.
• .nojekyll impede o processamento por Jekyll.
• Não há etapa de compilação, instalação ou variável de ambiente.

Regra importante

Tudo o que estiver no repositório é servido publicamente. Não versione arquivos .bak, cópias de páginas, saídas de build (dist/) ou diretórios duplicados — além de peso, cópias de páginas geram conteúdo duplicado indexável e prejudicam o SEO. O .gitignore já cobre esses casos.

Builds alternativos (opcionais, fora do caminho de deploy)

• npm run build → scripts/build-worker.mjs, empacota o site para hospedagem em worker. Ao criar uma página nova, adicione-a à lista sourceFiles do script.
• npm run build:static → vite build. Ao criar uma página nova, adicione-a a rollupOptions.input em vite.config.js.
• npm run validate → scripts/validate-artifact.mjs.
• npm run stamp → scripts/stamp-asset-versions.mjs, carimba ?v=<hash do conteúdo> nos links locais de CSS/JS das páginas (e nos @import de CSS). Isso faz parte do caminho de deploy: o GitHub Pages serve styles.css com cache de 4 h, então sem o carimbo um visitante recente pode receber o CSS antigo com o HTML novo. npm run stamp:check só reporta (sai com 1 se houver algo desatualizado).

Segurança

Todas as páginas aplicam uma CSP restrita via <meta http-equiv>: default-src 'self', object-src 'none', e script-src/connect-src/form-action limitados às origens que a página usa (Cloudflare Web Analytics, api.trustio.com.br, o projeto Supabase). Cabeçalhos que o <meta> não cobre (anti-clickjacking) vão na Cloudflare — ver SECURITY.md.

Consequência prática: nada de <script> inline, style="" inline ou recursos de terceiros (CDN, fontes remotas, imagens externas). Ícones e logotipos são SVG embutidos no HTML ou arquivos locais. Blocos application/ld+json são permitidos por não serem executáveis.

Ajustes antes de cada lançamento

• Ao adicionar página: incluir em sitemap.xml, na navegação (desktop + mobile + rodapé), em vite.config.js e em scripts/build-worker.mjs. Copiar também o <script src="assets/theme.js"> antes do CSS e o botão .theme-toggle do cabeçalho.
• Depois de alterar qualquer CSS/JS (ou criar página), rode npm run stamp antes do commit. O script atualiza o ?v= só dos assets que mudaram; sem isso o cache do navegador segura a versão antiga por até 4 h. scripts/build-design-system.py já chama o carimbo ao final.
• Superfícies que ficam escuras nos dois temas (terminal de API, painel de servidor, cartão de contato, finale do manifesto) redeclaram os tokens localmente em [data-theme="light"]; ao criar uma superfície assim, adicione o seletor a essa regra em vez de fixar cores.
• Espaçamento novo: use var(--space-N) (4 a 140). Cores novas: use os tokens semânticos (--text-strong, --on-surface-rgb, --card-gradient*) para que o tema claro continue coerente.
• Revisar os textos institucionais com as áreas jurídica e de segurança.
• Selos de conformidade no rodapé: manter rastreabilidade (número do certificado e organismo certificador) para due diligence de clientes enterprise.

Visualização local

python3 -m http.server 8080

Abra http://localhost:8080 no navegador.

Fontes e licenças

Identidade Trustio 2.0: Unbounded nos títulos, métricas e logotipo, Geist no corpo e nos botões, Martian Mono nos rótulos e dados e Instrument Serif só nas citações. Geist Mono segue como fallback do mono. Todas são distribuídas sob a SIL Open Font License e hospedadas em assets/fonts/ (sem fontes remotas, por causa da CSP). As licenças estão em assets/licenses/ e assets/fonts/.