How belheroth/the-verity works
The Verity is presented in the package metadata as a secure examination and learning-management platform. Its visible user workflow is authentication, role-specific classroom and course activity, assignment submissions, and teacher grading or proctoring; administrators have separate management screens. The frontend is routed through App, while server/server.js owns HTTP endpoints and uses a database abstraction. The tree also shows offline mutation syncing and Electron exam lockdown. The README is only the Vite template, and sampled source is partial, so some feature wiring and integrations are not represented.
Main entry points: App.jsx App router · api.js HTTP client · syncService.js Offline sync · main.cjs Electron runtime
Components 21
Web application
- App router
frontend/src/App.jsx - HTTP client
frontend/src/utils/api.js
Learning workflow
- Sign in / register
frontend/src/pages/Login.jsx - Student workspace
frontend/src/pages/StudentDashboard.jsx - Teacher workspace
frontend/src/pages/TeacherDashboard.jsx - Classroom activity
frontend/src/pages/ClassroomView.jsx - Assignments
frontend/src/pages/TeacherClasswork.jsx - Submissions and grading
frontend/src/pages/TeacherGrading.jsx - Exam proctoring
frontend/src/pages/TeacherView.jsx - Admin management
frontend/src/pages/admin/AdminLayout.jsx
Platform services
- API server
server/server.js - Database adapter
server/db/index.js - Application database
server/database.js - Offline sync
frontend/src/services/syncService.js - Local store
frontend/src/services/localStore.js - Email delivery
server/utils/emailService.js
Desktop security
- Electron runtime
electron/main.cjs - Desktop local DB
electron/local-db.cjs - Kiosk lock hook
native/KioskLockHook.cs
Other components
- Student / teacher
- SMTP service
Connections 16
- Student / teacher → App router: uses
- App router → Sign in / register: routes to
- App router → Student workspace: routes to
- App router → Teacher workspace: routes to
- App router → Classroom activity: routes to
- App router → Exam proctoring: routes to
- App router → Admin management: routes to
- App router → HTTP client: calls
- HTTP client → API server: sends requests
- API server → Database adapter: queries
- Database adapter → Application database: reads / writes
- Offline sync → Local store: reads queue
- Offline sync → HTTP client: replays requests
- Electron runtime → Desktop local DB: handles IPC
- Electron runtime → Kiosk lock hook: controls lockdown
- Email delivery → SMTP service: sends mail