How knnagesh78/neuroquest works
NeuroQuest is a private, account-backed 3D memory-palace study app. The main journey is sign-in and workspace loading, creating or selecting a palace, adding spatial memory anchors, then exploring notes or practicing recall and saving review progress. Its README also highlights search, learning insights, export, and install/offline support. Edges reflect cited imports and calls or explicit README behavior; several unsampled modules are represented by their exact directories, so internal links for those capabilities are omitted where wiring is not evidenced.
Main entry points: AccountGate.tsx Account gate · NeuroQuest.tsx Workspace shell · usePalaceStore.ts Palace state · Scene.tsx Scene renderer
Components 25
Account & sync
- Account gate
src/components/account/AccountGate.tsx - Firebase services
src/lib/firebase.ts - Account helpers
src/lib/account.ts - Workspace sync
src/lib/workspace-cloud.ts - Save queue
src/lib/save-queue.ts - Account controls
src/components/account/AccountControls.tsx - Account status
src/store/useAccountStore.ts
Palace workspace
- Workspace shell
src/components/NeuroQuest.tsx - Palace state
src/store/usePalaceStore.ts - Starter palaces
src/lib/data.ts - Palace navigation
src/components/ui/Navigation.tsx - Create palace
src/components/ui/AddRoomModal.tsx
Study experience
- Create anchor
src/components/ui/AddAnchorModal.tsx - Study drawer
src/components/ui/AnchorDrawer.tsx - Study mode
src/components/ui/ModeSwitcher.tsx - Search & insights
src/components/NeuroQuest.tsx
3D environment
- Scene renderer
src/components/three/Scene.tsx - Spatial artifacts
src/components/three/MemoryAnchor.tsx - Camera controls
src/components/three/CameraController.tsx
Install & offline
- Install wizard
src/components/pwa/InstallWizard.tsx - Offline worker
public/sw.js
Other components
- Learner
- Firebase Auth
- Cloud Firestore
- Browser
Connections 34
- Learner → Account gate: signs in
src/components/account/AccountGate.tsx - Account gate → Firebase services: initializes
src/components/account/AccountGate.tsx - Account gate → Account helpers: formats errors
src/components/account/AccountGate.tsx - Account gate → Firebase Auth: authenticates
src/components/account/AccountGate.tsx - Account gate → Workspace sync: loads workspace
src/components/account/AccountGate.tsx - Account gate → Save queue: queues saves
src/components/account/AccountGate.tsx - Account gate → Palace state: replaces state
src/components/account/AccountGate.tsx - Account gate → Workspace shell: mounts workspace
src/components/account/AccountGate.tsx - Account gate → Account controls: renders sync controls
src/components/account/AccountGate.tsx - Account gate → Account status: updates status
src/components/account/AccountGate.tsx - Workspace sync → Cloud Firestore: reads and writes
- Save queue → Workspace sync: batches saves
- Learner → Workspace shell: uses workspace
README.md - Workspace shell → Palace state: reads and updates
src/components/NeuroQuest.tsx - Palace state → Starter palaces: initializes from
src/store/usePalaceStore.ts - Workspace shell → Palace navigation: renders
src/components/NeuroQuest.tsx - Workspace shell → Create palace: opens
src/components/NeuroQuest.tsx - Palace navigation → Palace state: selects rooms
src/components/NeuroQuest.tsx - Create palace → Palace state: adds rooms
src/components/NeuroQuest.tsx - Workspace shell → Create anchor: opens
src/components/NeuroQuest.tsx - Create anchor → Palace state: adds anchors
src/components/ui/AddAnchorModal.tsx - Workspace shell → Scene renderer: loads scene
src/components/NeuroQuest.tsx - Workspace shell → Study drawer: opens selected anchor
src/components/NeuroQuest.tsx - Workspace shell → Study mode: renders
src/components/NeuroQuest.tsx - Study drawer → Palace state: records edits and ratings
src/components/ui/AnchorDrawer.tsx - Study mode → Palace state: changes mode
src/components/NeuroQuest.tsx - Workspace shell → Search & insights: provides
README.md - Scene renderer → Palace state: reads scene state
src/components/three/Scene.tsx - Scene renderer → Spatial artifacts: renders anchors
src/components/three/Scene.tsx - Scene renderer → Camera controls: mounts controls
src/components/three/Scene.tsx - Camera controls → Palace state: reads camera targets
src/components/three/CameraController.tsx - Learner → Install wizard: requests installation
README.md - Install wizard → Browser: offers install flow
README.md - Offline worker → Browser: serves fallback