Skip to content

README.md

Latest commit

 

History

History
90 lines (61 loc) · 2.15 KB

README.md

File metadata and controls

90 lines (61 loc) · 2.15 KB
Raw

Frontend

Aplicação web principal do <Cand!date!>, voltada para usuários finais.

Ela concentra a landing page pública, autenticação, callback OAuth e dashboard de vagas com filtros, detalhes, vagas salvas, perfil e preferências.

Stack

  • React 19
  • TypeScript
  • Vite 8
  • React Router
  • Tailwind CSS
  • Vitest + Testing Library

Como executar

Na raiz do monorepo, instale as dependências:

npm install

Para subir frontend e backend juntos:

npm run dev

Para executar apenas este workspace:

npm run dev --workspace=frontend

Por padrão o Vite usa http://localhost:5173.

Variáveis de ambiente

Crie o arquivo local a partir do exemplo:

cp frontend/.env.example frontend/.env

Variáveis usadas:

  • VITE_API_BASE_URL: URL base da API, normalmente http://localhost:3001.
  • VITE_API_PROXY_TARGET: alvo do proxy Vite quando chamadas relativas forem usadas.

Organização

O frontend segue uma estrutura orientada por domínio:

  • src/app: composição da aplicação, providers, rotas e layouts autenticados.
  • src/domains/auth: login, registro, callback OAuth e estado de sessão.
  • src/domains/jobs: busca, filtros, paginação e interface de vagas.
  • src/domains/marketing: landing page pública.
  • src/domains/new_dashboard: nova estrutura de painel do frontend. É aqui que contribuidores devem procurar a experiência nova de dashboard, com abas de home, vagas, mentoring, perfil e ajuda.
  • src/shared: componentes de UI, assets, hooks e utilitários reutilizáveis.

Veja também ARCHITECTURE.md.

Comandos

npm run dev --workspace=frontend
npm run build --workspace=frontend
npm run lint --workspace=frontend
npm run test --workspace=frontend
npm run test:coverage --workspace=frontend
npm run test:watch --workspace=frontend
npm run preview --workspace=frontend

Testes

Os testes ficam em frontend/tests e cobrem componentes, páginas, hooks, contexto de autenticação, serviços e regras de domínio.

Para rodar somente os testes do frontend:

npm run test --workspace=frontend

Para cobertura:

npm run test:coverage --workspace=frontend