How ahmedkhaleel2004/deepend-hackathon works
DeepEnd turns a learner’s goals and experience into project recommendations, then generates actionable project timelines with code examples and progress tracking. The main flow is sign-in, survey, recommendation generation, project selection, timeline generation, and progress review. Firebase supports authentication and persisted user, project, and timeline data. The README also describes personalized recommendations and detailed markdown/code timelines; some implementation files were not excerpted, so those links are included only where the source index or documentation supports them.
Main entry points: firebase.ts Firebase services · survey-questions.tsx Survey experience · page.tsx Learning workspace · sign-in-or-create.ts OAuth account flow
Components 18
Identity and onboarding
- Landing and sign-in
app/page.tsx - OAuth account flow
lib/sign-in-or-create.ts - Auth state
lib/hooks/use-auth.ts - Survey experience
components/component/survey/survey-questions.tsx - Survey answer review
components/component/survey/thanks-survey.tsx
Project discovery
- Project recommendations
app/api/projects/route.ts - Project loading
lib/hooks/use-fetch-projects.ts - Project selection
components/component/sidebar/projects-list.tsx
Timelines and progress
- Learning workspace
app/main/page.tsx - Timeline generation API
app/api/generate-timeline/route.ts - Timeline generator
lib/generate-timeline.ts - Timeline viewer
components/component/timeline/timeline.tsx - Step and code views
components/component/Main/CardTimeline.tsx - Timeline loading
lib/hooks/use-fetch-timelines.ts
Persistence and services
- Firebase services
lib/firebase.ts - User profile lookup
lib/get-user-data.ts - Survey definitions
lib/questions.ts
Other components
- Learner
Connections 24
- Learner → Landing and sign-in: starts at
app/page.tsx - Landing and sign-in → OAuth account flow: opens sign-in
- OAuth account flow → Firebase services: authenticates and writes
lib/sign-in-or-create.ts - OAuth account flow → User profile lookup: checks profile
lib/sign-in-or-create.ts - Auth state → Firebase services: observes auth
lib/hooks/use-auth.ts - Auth state → User profile lookup: loads profile
lib/hooks/use-auth.ts - Learner → Survey experience: answers
- Survey experience → Survey definitions: uses prompts
components/component/survey/survey-questions.tsx - Survey experience → Firebase services: stores answers
components/component/survey/survey-questions.tsx - Survey experience → Project recommendations: requests projects
- Survey answer review → Firebase services: reads answers
components/component/survey/thanks-survey.tsx - Survey answer review → Survey definitions: labels answers
components/component/survey/thanks-survey.tsx - Project recommendations → Firebase services: uses Firebase
app/api/projects/route.ts - Learning workspace → Auth state: checks access
app/main/page.tsx - Learning workspace → Project selection: shows projects
app/main/page.tsx - Learning workspace → Timeline viewer: shows timelines
app/main/page.tsx - Project selection → Project loading: loads projects
components/component/sidebar/projects-list.tsx - Project loading → Firebase services: reads projects
lib/hooks/use-fetch-projects.ts - Project selection → Timeline generation API: posts selection
components/component/sidebar/projects-list.tsx - Timeline generation API → Timeline generator: dispatches generation
app/api/generate-timeline/route.ts - Timeline generator → Firebase services: persists timeline
lib/generate-timeline.ts - Timeline viewer → Timeline loading: loads timeline data
components/component/timeline/timeline.tsx - Timeline loading → Firebase services: reads timelines
lib/hooks/use-fetch-timelines.ts - Timeline viewer → Step and code views: renders steps
components/component/timeline/timeline.tsx