CodeLeap Network

Frontend application for the CodeLeap technical challenge.

Production

Public URL:

• https://codeleap-network-ten.vercel.app

Requirements and Versions

Runtime and package manager:

• Node.js: 24.x
• npm: 10+

Main dependencies used in this project:

• React: ^19.2.0
• React DOM: ^19.2.0
• React Router DOM: ^7.13.1
• TanStack React Query: ^5.90.21
• Vite: ^7.3.1
• TypeScript: ~5.9.3
• Vitest: ^4.0.18
• date-fns: ^4.1.0

Stack

• React + TypeScript + Vite
• TanStack React Query
• CSS Modules
• Vitest + Testing Library

Architecture

The codebase follows a 4-layer clean architecture:

• src/domain: entities, value objects, ports
• src/application: use cases
• src/infrastructure: API adapters
• src/presentation: pages, components, hooks, providers

Shared abstractions stay in src/shared.

Scripts

• npm run dev: starts development server
• npm run build: type-checks and builds production bundle
• npm run preview: serves the production build locally
• npm run test: runs unit tests once
• npm run test:watch: runs tests in watch mode
• npm run lint: runs ESLint

Local Setup

1. Install dependencies:

npm install

2. Start development server:

npm run dev

3. Build for production:

npm run build

4. Preview production build:

npm run preview

Deployment (Vercel)

vercel.json is configured for a Vite SPA deployment, including rewrite fallback to index.html for React Router.

1. Push the repository to GitHub.
2. In Vercel, click Add New Project and import the GitHub repository.
3. Confirm settings:

• Framework Preset: Vite
• Build Command: npm run build
• Output Directory: dist

4. Deploy.
5. Open the generated public URL and validate:

• Signup and main routes load correctly after refresh
• CRUD operations work against https://dev.codeleap.co.uk/careers/
• Browser network tab shows successful CORS requests

API

Base URL used by the adapter:

• https://dev.codeleap.co.uk/careers/

Trailing slash is enforced in all requests to avoid CORS/path issues.