FaceScan
React 18 + Vite frontend, FastAPI backend
Real-time face attribute analysis and identity recognition app. Polls webcam frames from a React SPA, routes them through a FastAPI backend to DeepFace for age/gender/emotion analysis, and optionally matches faces against a JSON registry using face_recognition (dlib). dlib is optional — attribute analysis continues without recognition when absent.
Generated 4 Jun 2026 · 45 files · 11 components · 5 flows
File Architecture
The full source tree as a layered graph — every file with its role, imports, exports and reverse dependencies.
System Design
Runtime topology across the five zones — client, edge, application, data and external services.
Flow Graph
The five most significant application flows, step by step — startup, auth, write, read and error recovery.
Technology
| Component | Technology | Version | Source of Detection |
|---|---|---|---|
| Frontend framework | React + ReactDOM | ^18.3.1 | frontend/package.json |
| Build tool / dev server | Vite | ^6.0.5 | frontend/package.json, vite.config.ts |
| Language (frontend) | TypeScript | ^5.7.2 | frontend/package.json |
| Styling | Tailwind CSS + tailwindcss-animate | ^3.4.17 | frontend/package.json, tailwind.config.js |
| UI primitives | Radix UI (dialog/progress/tooltip…) | ^1.1.x | frontend/package.json |
| Client state | Zustand | ^5.0.2 | src/store/useFaceStore.ts |
| Animation | Framer Motion | ^11.15.0 | frontend/package.json |
| HTTP client | axios | ^1.7.9 | src/lib/api.ts |
| Webcam capture | react-webcam | ^7.2.0 | src/components/WebcamFeed.tsx |
| i18n | i18next + react-i18next | ^24.2.0 / ^15.4.0 | src/i18n/index.ts |
| Backend framework | FastAPI | >=0.110 | backend/requirements.txt, main.py |
| ASGI server | Uvicorn[standard] | >=0.29 | backend/requirements.txt |
| Validation | Pydantic | >=2.6 | backend/models/schemas.py |
| Attribute analysis | DeepFace (+ tf-keras) | >=0.0.92 | services/analyzer.py |
| Identity / landmarks | face-recognition (dlib) | >=1.3.0 | services/recognizer.py |
| Image I/O | OpenCV-python, Pillow, NumPy | >=4.9 / >=10.2 / >=1.26 | backend/requirements.txt |
| Deep-learning runtime | PyTorch + torchvision | >=2.2 / >=0.17 | backend/requirements.txt |
| Identity store | JSON file registry | — | backend/data/registered_faces.json |