How yusufwav/nexus works
Main is a student learning platform for browsing course modules, using an AI tutor, and managing an account and purchases. The clearest evidenced runtime workflow is authenticated chat: the chat API checks the session, reads or mutates conversation history through database queries, and stores threads and messages in PostgreSQL. Module catalogue, purchase, authentication, dashboard, and PWA capabilities are represented as separate product areas. Source excerpts establish the chat and auth/database links; connections for unsampled routes and integrations are intentionally omitted.
Main entry points: queries.ts Database queries · route.ts Chat API · index.ts Auth service · source.ts Docs content source
Components 27
Learning experience
- Web experience
apps/web/src/app/page.tsx - Module catalogue
apps/web/src/app/modules - Module content
apps/web/src/content/module-content.ts - Topic learning
apps/web/src/content/module-topics.ts - AI tutor
apps/web/src/app/(app)/ai/page.tsx - Chat API
apps/web/src/app/api/chat/route.ts - AI API
apps/web/src/app/api/ai/route.ts - Topic API
apps/web/src/app/api/topics/[slug]/route.ts - PWA support
apps/web/src/components/pwa-registration.tsx
Accounts and commerce
- Sign-in experience
apps/web/src/app/login/page.tsx - Auth API
apps/web/src/app/api/auth/[...all]/route.ts - Auth service
packages/auth/src/index.ts - Student dashboard
apps/web/src/app/dashboard/page.tsx - Purchases
apps/web/src/app/dashboard/purchases/page.tsx - Payment integration
apps/web/src/lib/payments.ts - Trial materials
apps/web/src/app/api/trial/route.ts
Persistence
- Database queries
packages/db/src/queries.ts - Module catalogue data
packages/db/src/module-catalog.ts - Auth schema
packages/db/src/schema/auth.ts - Chat schema
packages/db/src/schema/chat.ts - Module and purchase schema
packages/db/src/schema/modules.ts
Documentation
- Documentation site
apps/fumadocs/src/app/(home)/page.tsx - Docs content source
apps/fumadocs/src/lib/source.ts - Docs URL helpers
apps/fumadocs/src/lib/shared.ts - Docs search
apps/fumadocs/src/app/api/search/route.ts - LLM content export
apps/fumadocs/src/app/llms-full.txt/route.ts
Other components
- Student
Connections 7
- Student → Web experience: uses
README.md - Chat API → Auth service: checks session
apps/web/src/app/api/chat/route.ts - Chat API → Database queries: reads and writes
apps/web/src/app/api/chat/route.ts - Database queries → Chat schema: queries
packages/db/src/queries.ts - Database queries → Module and purchase schema: queries
packages/db/src/queries.ts - Auth service → Auth schema: configures adapter
packages/auth/src/index.ts - Docs content source → Docs URL helpers: uses URL helpers
apps/fumadocs/src/lib/source.ts