How adhikari-arpan/bece_notes works
BECE Vault is a study-notes website for Pokhara University’s BECE program. Its main user workflow is to browse semesters or electives, select a subject and file, then view a PDF in-browser or download it. The website also offers a CGPA calculator and supporting pages, plus visit statistics, consent-aware preferences, and note-library indexing. The README documents the user flow; sampled source confirms app routing, note discovery, prerendering, and tracking. Several component-level integrations are unsampled, so their links are omitted where not established.
Main entry points: App.tsx App router · CgpaView.tsx CGPA calculator · notes.ts Notes indexing · CookieBanner.tsx Cookie consent
Components 26
Study library
- Notes catalog
Website/src/content/notes.ts - Notes indexing
Website/plugins/notes.ts - Browse semesters
Website/src/components/HomeView.tsx - Semester view
Website/src/components/SemesterView.tsx - Subject files
Website/src/components/SubjectView.tsx - PDF viewer
Website/src/components/PdfViewer.tsx - PDF.js assets
Website/plugins/pdfjsAssets.ts - File download
Website/src/components/DownloadButton.tsx
CGPA calculator
- CGPA calculator
Website/src/components/CgpaView.tsx - Grade calculations
Website/src/content/cgpa.ts - Grade scale
Website/src/content/grades.ts - CGPA report
Website/src/content/cgpaReport.ts - Report upload
Website/src/components/CgpaUploadDialog.tsx
Site experience
- App router
Website/src/App.tsx - Cookie consent
Website/src/components/CookieBanner.tsx - Theme preferences
Website/src/content/theme.ts - Consent storage
Website/src/content/consent.ts - Search pages
Website/plugins/prerender.ts - About and policy pages
Website/src/components/AboutView.tsx - Contributor page
Website/src/components/ContributorsView.tsx - Contributing page
Website/src/components/ContributingView.tsx - Support the site
Website/src/components/TipJar.tsx
Site services
- Visit tracking
Website/src/content/visits.ts - Firebase setup
Website/src/firebase.ts - Firebase database
Other components
- Student
Connections 26
- Student → App router: opens site
README.md - App router → Browse semesters: routes to
Website/src/App.tsx - App router → Semester view: routes to
Website/src/App.tsx - App router → Subject files: routes to
Website/src/App.tsx - App router → CGPA calculator: routes to
Website/src/App.tsx - Student → Browse semesters: picks semester
README.md - Student → Subject files: selects subject
README.md - Student → PDF viewer: opens file
README.md - Student → File download: downloads file
README.md - Notes indexing → Notes catalog: exposes manifest
Website/plugins/notes.ts - Search pages → Notes indexing: builds manifest
Website/plugins/prerender.ts - Student → CGPA calculator: enters grades
README.md - CGPA calculator → Grade calculations: calculates grades
- CGPA calculator → Grade scale: uses scale
- CGPA calculator → CGPA report: creates report
- CGPA calculator → Report upload: offers upload
- Student → Cookie consent: sets preference
Website/src/components/CookieBanner.tsx - Cookie consent → Consent storage: stores consent
Website/src/components/CookieBanner.tsx - Student → PDF.js assets: views scanned PDF
- App router → Visit tracking: tracks page
Website/src/App.tsx - Visit tracking → Firebase database: reads and updates
Website/src/content/visits.ts - App router → Support the site: renders support
Website/src/App.tsx - App router → About and policy pages: routes to
Website/src/App.tsx - App router → Contributor page: routes to
Website/src/App.tsx - App router → Contributing page: routes to
Website/src/App.tsx - Firebase setup → Firebase database: initializes analytics