veza/docs/FRONTEND_SETUP.md
2025-12-12 21:34:34 -05:00

70 lines
1.1 KiB
Markdown

# Frontend Setup Guide (apps/web)
Ce guide explique comment installer, lancer et tester le frontend Veza localement.
## Prérequis
- Node.js 18+
- npm 9+
- Backend Veza (Go) lancé (`make start` à la racine)
## Installation
Depuis la racine du projet :
```bash
make install
```
Ou spécifiquement pour le frontend :
```bash
cd apps/web
npm install --legacy-peer-deps
```
## Lancement (Développement)
Lancer tout l'environnement (Backend + Frontend + DBs) :
```bash
make start
```
Le frontend sera accessible sur : http://localhost:8085 (via Docker) ou http://localhost:5173 (si lancé manuellement via `npm run dev`).
Pour lancer uniquement le frontend en mode dev (connecté au backend local) :
```bash
cd apps/web
npm run dev
```
## Configuration (.env)
Créer un fichier `.env.local` dans `apps/web` si nécessaire :
```properties
VITE_API_BASE_URL=http://localhost:8080/api/v1
VITE_WS_BASE_URL=ws://localhost:8081/ws
VITE_STREAM_URL=http://localhost:8082
```
## Tests et Qualité
Vérifier les types TypeScript :
```bash
cd apps/web
npm run typecheck
```
Lancer les tests unitaires :
```bash
cd apps/web
npm test
```
Linter :
```bash
make lint
```