How jocelyncheruel/narval-plus works
Narval+ is a Chrome extension that overlays student results on the Narval portal. The main workflow is to load the portal, read and present academic results, and retain local state; optional branches provide community rankings, device management, and extension-update notices. The sampled implementation is concentrated in content.js, so several internal responsibilities are modeled separately but share that path. The README documents capabilities whose internal call paths were not sampled; those links are shown as unverified where appropriate.
Main entry points: content.js Extension overlay · config.js Update settings
Components 17
Portal experience
- Narval portal
- Extension overlay
content.js - Local state
content.js
Academic results
- Results parser
content.js - Academic model
content.js - Results dashboard
content.js - Period views
content.js
Community ranking
- Ranking controls
content.js - Identity and devices
content.js - Ranking client
content.js - Ranking service
Updates
- Update checker
content.js - Update notice
content.js - Update settings
config.js - ZIP download
Other components
- Student
- Chrome
Connections 19
- Student → Narval portal: opens
README.md - Narval portal → Extension overlay: loads alongside
- Chrome → Extension overlay: hosts extension
- Extension overlay → Local state: reads and writes
content.js - Extension overlay → Update checker: starts check
content.js - Extension overlay → Identity and devices: initializes when enabled
content.js - Student → Ranking controls: enables participation
README.md - Ranking controls → Ranking client: requests rankings
content.js - Ranking client → Ranking service: exchanges aggregates
- Identity and devices → Ranking service: links or revokes devices
- Student → Identity and devices: manages devices
README.md - Update checker → Update notice: shows notice
README.md - Update settings → Update checker: sets endpoints
- Student → ZIP download: downloads update
README.md - Update notice → ZIP download: links to ZIP
README.md - Results dashboard → Period views: offers selection
content.js - Extension overlay → Results parser: extracts portal data
content.js - Results parser → Academic model: builds results
content.js - Academic model → Results dashboard: supplies results
content.js