cesnimda
65 lines
2.1 KiB
Markdown
65 lines
2.1 KiB
Markdown
# Job Tracker frontend
|
|
|
|
The frontend is a statically exported Next.js 16 application using React 19, TypeScript, Material UI, and React Router. Next.js supplies the build shell; authenticated and public application routes are defined in `src/App.tsx`.
|
|
|
|
## Requirements
|
|
|
|
- Node.js 24 (the version used by CI)
|
|
- npm 11 or a compatible npm release
|
|
- The Job Tracker API at `http://localhost:5202` for normal local use
|
|
|
|
Install the lockfile exactly:
|
|
|
|
```powershell
|
|
npm ci
|
|
```
|
|
|
|
## Development
|
|
|
|
Start the application on Next.js's default development port:
|
|
|
|
```powershell
|
|
npm run dev
|
|
```
|
|
|
|
Open `http://localhost:3000`. The client calls `http://localhost:5202/api` on localhost unless `NEXT_PUBLIC_API_BASE_URL` overrides it.
|
|
|
|
The Playwright harness uses port `3300` and starts its own isolated API and SQLite database. Do not point it at a development or production database.
|
|
|
|
## Quality gates
|
|
|
|
```powershell
|
|
npm run lint
|
|
npm test -- --runInBand
|
|
npm run build
|
|
```
|
|
|
|
The production build is written to `out/` and is served by nginx in the frontend container.
|
|
|
|
Run the browser suite after installing Chromium once:
|
|
|
|
```powershell
|
|
npx playwright install chromium
|
|
npm run test:e2e
|
|
```
|
|
|
|
The browser suite covers login, job creation, Career Workspace routing, and public CV/PDF access against isolated services.
|
|
|
|
## Useful paths
|
|
|
|
- `app/` — thin Next.js application shell
|
|
- `src/App.tsx` — application routes and shared authenticated shell
|
|
- `src/api.ts` — API client and local/default base URL
|
|
- `src/components/` — feature and shared UI components
|
|
- `src/i18n/` — English and Norwegian Bokmål UI messages
|
|
- `src/theme.ts` — application theme
|
|
- `e2e/` — Playwright browser tests
|
|
- `next.config.js` — static-export configuration
|
|
- `playwright.config.ts` — isolated browser-test services
|
|
|
|
## Runtime configuration
|
|
|
|
`NEXT_PUBLIC_API_BASE_URL` is the only browser-visible API setting. Leave it unset in the production container so nginx proxies same-origin `/api` requests. Values prefixed with `NEXT_PUBLIC_` are embedded at build time and must never contain secrets.
|
|
|
|
See the repository `README.md` for full-stack development and `deploy/README.md` for production requirements.
|