How quran/quran.com-frontend-next works
Quran.com is a Next.js frontend for reading and studying the Quran, with accounts, saved content, courses, audio, media creation, and an embeddable verse widget. A typical visit starts at a page, then uses its product feature to read or act on Quran content. The graph includes major capabilities visible in the tree, but most page-to-feature wiring is not excerpted; those relationships are omitted or marked unverified. The README identifies the product as the Quran.com frontend, not its backend services.
Main entry points: QuranReader Quran reader · index.tsx Homepage · api.ts Account API · Course Courses
Components 22
Quran reading
- Quran reader
src/components/QuranReader - Reading preferences
src/redux/slices/QuranReader/readingPreferences.ts - Quran navigation
src/utils/navigation.ts - Chapter data
src/utils/chapter.ts - Search
src/redux/slices/Search/search.ts
Study and learning
- Courses
src/components/Course - Course enrollment
src/utils/auth/useCourseEnrollment.ts
Account and saved content
- Verse collections
src/components/MyQuran/CollectionDetailView/hooks/useCollectionDetailViewController.ts - Account API
src/utils/auth/api.ts - Authentication
src/utils/auth/login.ts - Notifications
src/components/Notifications/InAppNotifications/index.tsx - Notes and reflections
src/components/Notes/modal/NoteFormModal.tsx
Audio and media
- Audio player
src/components/AudioPlayer/AudioPlayer.tsx - Radio playback
src/xstate/Radio/useCurrentStationInfo.ts - Media maker
src/components/MediaMaker/Root.tsx
Platform features
- Homepage
src/pages/index.tsx - Verse widget
src/components/AyahWidget/getAyahWidgetData.ts - Widget configuration
src/components/AyahWidget/widget-config.ts - Apps portal
src/pages/apps.tsx - Public API client
src/api.ts
Other components
- Reader
- Backend services
Connections 23
- Reader → Homepage: opens
README.md - Homepage → Quran reader: offers reading
- Homepage → Courses: offers learning
- Homepage → Audio player: offers playback
- Quran reader → Reading preferences: uses preferences
src/components/QuranReader/ContextMenu/hooks/useContextMenuState.ts - Quran reader → Quran navigation: navigates verses
src/components/QuranReader/ReadingView/StudyModeModal/PinnedVersesSection/usePinnedVerseHandlers.ts - Quran reader → Chapter data: uses chapter data
src/components/QuranReader/ContextMenu/hooks/useContextMenuState.ts - Quran reader → Search: searches Quran
- Reader → Verse collections: saves verses
- Verse collections → Account API: deletes bookmark
src/components/MyQuran/CollectionDetailView/hooks/useCollectionDetailViewController.ts - Reader → Authentication: signs in
- Courses → Course enrollment: enrolls user
- Course enrollment → Account API: requests enrollment
src/utils/auth/useCourseEnrollment.ts - Reader → Audio player: plays recitation
- Reader → Radio playback: plays radio
- Reader → Media maker: creates media
- Reader → Verse widget: embeds verses
- Verse widget → Widget configuration: uses configuration
src/components/AyahWidget/getAyahWidgetData.ts - Reader → Apps portal: browses apps
src/pages/apps.tsx - Reader → Notifications: views alerts
- Reader → Notes and reflections: writes reflections
- Account API → Backend services: fetches account data
- Public API client → Backend services: fetches Quran data