veza/docs/FRONTEND_SETUP.md

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 :

make install

Ou spécifiquement pour le frontend :

cd apps/web
npm install --legacy-peer-deps

Lancement (Développement)

Lancer tout l'environnement (Backend + Frontend + DBs) :

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) :

cd apps/web
npm run dev

Configuration (.env)

Créer un fichier .env.local dans apps/web si nécessaire :

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 :

cd apps/web
npm run typecheck

Lancer les tests unitaires :

cd apps/web
npm test

Linter :

make lint