Solução de problemas

Falha no build: vitepress não encontrado

Confirme que as dependências estão instaladas e que o Cloudflare Pages executa a instalação antes do build.

npm install
npm run build

Build bem-sucedido, mas páginas com 404

Verifique se o diretório de saída é .vitepress/dist. Um diretório incorreto implanta arquivos incorretos.

.vitepress/dist

docs.hideapps.top não abre

1. Confirme que docs.hideapps.top foi adicionado em Custom domains.
2. Confirme que o CNAME docs existe.
3. Confirme que o destino é hideapps-docs.pages.dev.
4. Se o domínio acabou de ser adicionado, aguarde a emissão do certificado Cloudflare.

O certificado HTTPS fica pendente

Verifique se hideapps.top tem registros CAA que limitam a emissão de certificados.

Prévia local funciona, mas estilos faltam online

Este projeto é implantado na raiz do subdomínio, então o VitePress não precisa de base.