Catlovers é um projeto educacional sobre adoção responsável de gatos, construído com HTML, CSS e JavaScript. A aplicação publicada funciona como demonstração: os perfis e cenários são fictícios, o formulário não envia pedidos de adoção nem dados pessoais e os exemplos educacionais são identificados como tais.
- Site multipágina responsivo, com tema claro e escuro, inclusive quando o
localStorageestá indisponível. - Interface em português, inglês e espanhol.
- Galeria com filtros, quiz de compatibilidade, blog demonstrativo e formulário local.
- Recursos de acessibilidade, como navegação por teclado, skip link, regiões
aria-livee contraste de cores. - PWA com manifesto, ícones e cache do app shell.
- Dez especificações de ponta a ponta com 55 testes Cypress, além de validações automatizadas de build, traduções e catálogo.
- HTML5, CSS3 e JavaScript com módulos ES.
- Vite 8 para desenvolvimento e build multipágina.
- Plugin local do Vite para compor os fragmentos HTML de
includes/. - Fontsource com Atkinson Hyperlegible e Cormorant Garamond.
- ESLint 10, Stylelint 17 e Cypress 16.
- GitHub Actions e GitHub Pages.
- Node.js 24 recomendado. O projeto aceita
^22.13.0 || ^24.0.0 || >=26.0.0. - pnpm 11.
- Google Chrome para a execução E2E padrão.
A versão recomendada do Node também está em .nvmrc.
git clone https://github.com/c0destep/catlovers.git
cd catlovers
pnpm install --frozen-lockfilepnpm devO Vite abre o site em http://127.0.0.1:1234. A porta é fixa para manter o ambiente local e o Cypress alinhados.
| Comando | Finalidade |
|---|---|
pnpm dev |
Inicia o servidor de desenvolvimento. |
pnpm build |
Gera dist/, prepara a PWA e valida páginas e recursos. |
pnpm preview |
Serve a build local na porta 1234. |
pnpm lint |
Executa ESLint e Stylelint. |
pnpm test:i18n |
Confere a consistência dos três catálogos de tradução. |
pnpm test:catalog |
Valida o catálogo e confirma que fixtures com schema inválido ou IDs duplicados são rejeitadas. |
pnpm test:e2e:open |
Abre a interface do Cypress. |
pnpm test:e2e:run |
Inicia o preview, executa o Cypress e valida a navegação offline em um Chrome ou Chromium isolado. |
pnpm check |
Executa lint, validações de traduções e do catálogo e build. |
pnpm test |
Executa as validações de traduções e do catálogo, a build e toda a suíte E2E. |
Para usar outro navegador instalado:
CYPRESS_BROWSER=chromium pnpm test:e2e:runArgumentos adicionais são repassados ao Cypress. Por exemplo:
pnpm test:e2e:run -- --spec cypress/e2e/performance.cy.jspnpm buildAlém de compilar o site, esse comando:
- publica o manifesto e os recursos estáveis da PWA;
- gera a versão do cache e a lista de pré-cache a partir da build;
- verifica as 13 páginas, os links para recursos locais, os ícones, a captura de tela e o service worker.
O funcionamento offline cobre o app shell gerado e é verificado em um navegador com a rede desativada. Imagens externas do Unsplash continuam dependendo de conexão.
catlovers/
├── css/ # Estilos globais
├── cypress/e2e/ # Cenários de ponta a ponta
├── img/ # Imagens processadas pelo Vite
├── includes/ # Fragmentos HTML compartilhados
├── js/ # Comportamento, tradução e formulários
├── languages/ # Catálogos pt_BR, en_US e es_ES
├── public/ # Manifesto, service worker e recursos estáveis
├── scripts/ # Automação de build, i18n, imagens e E2E
├── *.html # Páginas de entrada
└── vite.config.mjs # Build multipágina e composição dos includes
- Não existe backend nem integração com organizações de adoção.
- O formulário valida os campos apenas no navegador e não armazena dados.
- Alguns conteúdos e imagens externas não ficam disponíveis offline.
- As orientações sobre saúde e comportamento ainda precisam registrar autoria, fontes e datas de revisão.
As próximas etapas, prioridades e critérios de conclusão estão no ROADMAP.md.
Leia o CONTRIBUTING.md antes de enviar alterações. O projeto usa commits pequenos no padrão Conventional Commits e exige pnpm check antes da revisão.
Distribuído sob a licença MIT. Consulte LICENSE.txt.
Lucas Alves — @c0destep
