Cat Tetris não é apenas um jogo de Tetris — é um sistema educacional completo que ensina desde o básico até técnicas profissionais usadas em torneios.
🎮 JOGAR AGORA | 📚 Documentação | 🚀 Deploy
- 21 lições progressivas (Fundamentals → Professional)
- 19 demonstrações automáticas onde o CPU joga e mostra as técnicas
- Sistema de validação em tempo real
- Progress tracking e rewards automáticos
- 1v1 Local - Split-screen para 2 jogadores
- vs IA - 4 níveis de dificuldade (Easy → Expert)
- Controles duplos otimizados
- Estatísticas de match
- Missões Diárias - 3 missões renovadas automaticamente
- Conquistas - 50+ achievements para desbloquear
- Loja de Temas - 10 temas visuais únicos
- Sistema de moedas (🐟) e XP
- Interface limpa e moderna
- Animações suaves (Framer Motion)
- PWA instalável (funciona offline!)
- Totalmente responsivo
# 1. Clone o repositório
git clone https://github.com/shigake/cat-tetris.git
cd cat-tetris
# 2. Instale dependências
npm install
# 3. Inicie o servidor
npm run dev
# 4. Abra no navegador
# http://localhost:5173/cat-tetris- ✅ Movimentação básica
- ✅ Rotação de peças
- ✅ Soft Drop vs Hard Drop
- ✅ Sistema de Hold
- ✅ Next Preview
- ✅ T-Spin Básico
- ✅ T-Spin Mini
- ✅ T-Spin Double
- ✅ Sistema de Combos
- ✅ Back-to-Back Chains
- ✅ Downstacking
- ✅ T-Spin Triple
- ✅ Técnica 4-Wide
- ✅ Perfect Clear
- ✅ DT Cannon
- ✅ TKI Opener
- ✅ T-Spin Stacking
- ✅ Sprint 40 Linhas
- ✅ Defesa contra Garbage
- ✅ Táticas Multiplayer
- ✅ Desafio Final
- Clássico - Jogo padrão infinito
- Sprint - 40 linhas no menor tempo
- Ultra - Máxima pontuação em 2 minutos
- Survivor - Velocidade progressiva
- Cheese - Limpe linhas com garbage
- 1v1 Local - 2 jogadores no mesmo computador
- vs IA - 4 níveis de dificuldade
- 3 Missões Diárias - Renovadas automaticamente
- 50+ Conquistas - Badges e troféus
- 10 Temas - Personalize o visual
- Sistema de Níveis - XP e ranking
- React 18 - UI framework
- Vite 4 - Build tool e dev server
- Tailwind CSS - Styling
- Framer Motion - Animações
- React Router - Navegação
- Design Patterns - Observer, Singleton, DI
- SOLID Principles - Código limpo e escalável
- Component-Driven - Componentes reutilizáveis
- Custom Hooks - Lógica compartilhada
- ESLint - Linting
- Prettier - Formatação
- Playwright - Testes E2E
- TypeScript-ready - Preparado para migração
cat-tetris/
├── src/
│ ├── components/ # Componentes React
│ │ ├── lesson/ # Componentes do tutorial
│ │ ├── TetrisBoard.jsx
│ │ ├── MainMenu.jsx
│ │ └── ...
│ ├── core/ # Lógica do jogo
│ │ ├── services/ # Services (GameService, etc)
│ │ ├── Board.js
│ │ ├── Score.js
│ │ └── ...
│ ├── hooks/ # Custom hooks
│ ├── patterns/ # Design patterns
│ └── utils/ # Utilidades
├── public/ # Assets estáticos
├── test-results/ # Screenshots de testes
├── docs/ # Documentação
└── ...
- TUTORIAL-COMPLETO.md - Documentação técnica do tutorial
- GUIA-DEPLOY.md - Como fazer deploy
- RELATORIO-FINAL-SESSAO-2.md - Relatório de desenvolvimento
- PLANO-IMPLEMENTACAO-COMPLETO.md - Planejamento
- AUDITORIA-CODIGO.md - Análise técnica
node test-tutorial-system.cjsVerifica:
- ✅ Abertura da aplicação
- ✅ Navegação ao Tutorial
- ✅ Tela de introdução
- ✅ Demonstração (CPU jogando)
- ✅ Modo prática
- ✅ Arquitetura refatorada
- ✅ Cobertura de demonstrações
npm run devTestar:
- Tutorial completo (21 lições)
- Multiplayer (1v1 e vs IA)
- Missões diárias
- Conquistas
- Loja de temas
- Modos de jogo
- ← → - Mover para os lados
- ↓ - Soft Drop (acelerar queda)
- ↑ - Rotação horária
- Espaço - Hard Drop (queda instantânea)
- C - Hold (guardar peça)
- Shift - Rotação anti-horária
- P - Pausar
- Player 1: WASD + Q/E + Shift+Space
- Player 2: Arrows + ↑ + Ctrl + Enter
- Suporte para controles Xbox/PlayStation
- CPU joga automaticamente mostrando as técnicas
- Narração dinâmica explicando cada movimento
- Controles de playback (play/pause/velocidade)
- Não existe nada igual no mercado!
- 21 lições estruturadas pedagogicamente
- Validação em tempo real do que o jogador faz
- Feedback instantâneo e construtivo
- Sistema de hints quando o jogador trava
- Arquitetura limpa e escalável
- Componentes reutilizáveis
- Design patterns aplicados corretamente
- Fácil de manter e expandir
- Split-screen funcional
- IA com comportamento realista
- 4 níveis de dificuldade balanceados
- Experiência competitiva divertida
| Métrica | Valor |
|---|---|
| Tempo de Desenvolvimento | ~15 horas |
| Linhas de Código | ~8,000 |
| Componentes React | 40+ |
| Services | 15 |
| Lições Tutorial | 21 |
| Demonstrações | 19 |
| Conquistas | 50+ |
| Temas | 10 |
| Commits | 70+ |
- Tutorial completo
- Multiplayer local
- Sistema de progressão
- PWA
- 2 demonstrações restantes
- Sound effects completos
- Particles effects avançados
- Backend real (Firebase/Supabase)
- Multiplayer online
- Leaderboard global
- Torneios
- Sistema de replays
- Marketplace de temas
Contribuições são bem-vindas!
- Fork o projeto
- Crie sua feature branch (
git checkout -b feature/AmazingFeature) - Commit suas mudanças (
git commit -m 'Add AmazingFeature') - Push para a branch (
git push origin feature/AmazingFeature) - Abra um Pull Request
Este projeto é proprietário. Todos os direitos reservados.
Desenvolvido com ❤️ por: [Seu Nome]
- Tetris Guidelines - Por especificações oficiais
- Guideline Community - Por estratégias avançadas
- Framer Motion - Por animações incríveis
- Vite - Por desenvolvimento rápido
- Issues: GitHub Issues
- Email: (adicionar se necessário)
- Discord: (adicionar se necessário)
Se você achou o projeto útil, dê uma ⭐ no GitHub!
🎮 Divirta-se jogando Cat Tetris! 🐱
Feito com 💜 e muito ☕
© 2026 Cat Tetris. Todos os direitos reservados.