vite
Use ao criar ou revisar código em projetos React + Vite + TypeScript com Tailwind — telas em `src/pages/`, rotas em `src/routes/AppRoutes.tsx`, stores Zustand, services com Axios + TanStack Query, forms React Hook Form + Zod, alias `@/`, `vite.config.ts`, `npm run dev`.
El texto de las convenciones está escrito en portugués y se muestra aquí tal como está en el repositorio.
Projeto que já existe? Estas convenções valem para código novo e para remodelação. Em sistema legado, de cliente ou de outra equipe, a arquitetura do projeto manda: antes da primeira mudança, siga
veritas:projeto-existente.Dado pessoal? Código que toca CPF, contato, saúde, dado financeiro ou credencial, e todo log, exportação ou integração, segue também a
veritas:lgpd, em qualquer modo.
Filosofia
FOCO DO MVP: preparar um boilerplate FUNCIONAL, não apenas pastas vazias. Roteamento, estado global, cliente HTTP e formulário de exemplo devem estar operantes e navegáveis no primeiro npm run dev.
ESTRUTURA: React com Functional Components e Hooks. Separe lógica em hooks customizados.
Tecnologias
TECNOLOGIAS/LIBS:
- Rotas: react-router-dom.
- UI: Tailwind CSS.
- Estado Global: Zustand.
- Dados/API: Axios + TanStack Query.
- Forms: React Hook Form + Zod.
- Ícones: lucide-react.
- Imports: sempre via alias
@/.
Proibições (violação = erro)
- BOILERPLATE FUNCIONAL: os arquivos gerados devem compilar e rodar sem erro assim que o agente de features começar a trabalhar. Nada de imports para libs não instaladas.
- GERÊNCIA DE ESTADO: Zustand APENAS para estado global (
src/store/). Estado local usa exclusivamente hooks nativos (useState,useReducer). - CHAMADAS DE API: use o cliente
@/api/client. Toda chamada nova vira uma função emsrc/services/, tipada emsrc/types/, consumida via hook do TanStack Query. - COMPONENTES: Functional Components limpos, sem lógica de fetch dentro de
components/ui. - ESTILIZAÇÃO: Tailwind via
className, design moderno mesmo em componentes mockados. - TIPAGEM: forte, com interfaces/types em
src/types/. Nuncaany. - NAVEGAÇÃO: toda tela nova entra em
src/pages/e ganha uma rota emsrc/routes/AppRoutes.tsx.
Imports proibidos
styled-components@emotion/react@emotion/styledredux@reduxjs/toolkitreact-reduxmobxmobx-react
Arquivos protegidos
vite.config.tstsconfig.app.jsonsrc/index.csssrc/api/client.tssrc/context/ConfigContext.tsx
Skills de fora
Se estiverem instaladas, carregue sem esperar pedido:
- Componente, data fetching ou performance →
vercel-react-best-practices - Prop booleana demais, componente reutilizável →
vercel-composition-patterns - Animação entre rotas ou estados →
vercel-react-view-transitions - Página pública (landing, site, portfolio) →
design-taste-frontend - Revisar UI ou acessibilidade →
web-design-guidelines
Elas decidem visual e tática; stack, libs e pastas são desta skill. Em conflito, esta vence. O que nunca entra sozinho: skills-de-fora.md.
Recursos adicionais
- Estrutura e arquitetura: architecture.md
Origem
Portada do scaffold/stacks/vite.py do Veritas v1, onde vivia como string dentro do Python.