Mapa do Voter

A web app for majority judgment voting. Voters evaluate each candidate on a scale of mentions (Excellent, Very Good, Good, Fair, Insufficient) and the winner is the one with the best median mention.

The app consumes the Mieux Voter REST API.

Stack

• React Router v7 (framework mode, SSR with Vite)
• React 19 + TypeScript (strict)
• PrimeReact 11 + PrimeIcons for UI components (Aura theme)
• SASS + CSS Modules for styling
• better-sqlite3 for local storage (top N results, admin tokens)
• ESLint 9 + Prettier

Getting started

Prerequisites

• Node.js >= 20
• npm

Installation

npm install

Development

npm run dev

The app will be available at http://localhost:5173.

Mock mode

Run the app with an in-memory mock API (no calls to api.mieuxvoter.fr):

npm run dev:mock

This lets you test the full workflow (create, vote, results, admin) without creating real elections.

Production build

npm run build
npm start

Other commands

Command	Description
npm run typecheck	Type checking (route types + tsc)
npm run lint	ESLint
npm run format	Prettier (write mode)