Skip to content

Repository files navigation

Ascend AI

Ascend AI is a production-ready MVP life operating system for a Computer Science student preparing for GATE 2027, placement interviews, AI/ML careers, project delivery, habits, personal development, and fitness.

Features

  • Dashboard with tasks, study hours, streaks, deadlines, weekly progress, habits, fitness, GATE, placement, AI/ML progress, notes, motivation, charts, and quick actions.
  • Goal management with categories, priorities, deadlines, archive-ready status, milestones schema, and progress tracking.
  • Task manager with CRUD, labels, categories, priorities, notes, recurring rules, list, kanban, calendar, search, sorting-ready API, and bulk completion.
  • Habit tracker with daily logs, streak-ready analytics, categories, reports, and heatmap-ready data.
  • Calendar with monthly-style planning, study blocks, tasks, deadlines, and recurrence fields.
  • GATE preparation with subjects, topics, subtopics, PYQs, mocks, formula sheets, revision sessions, weak areas, accuracy, and readiness metrics.
  • DSA tracker with topic, platform, difficulty, revision status, bookmarks, notes, and stats.
  • AI/ML tracker for Python, NumPy, Pandas, Statistics, ML, DL, PyTorch, Transformers, LLMs, RAG, and MLOps.
  • Project management with projects, milestones, tasks, issues, sprints, documents, timelines, and health scores. TrueAble is seeded.
  • Fitness tracking for weight, waist, calories, water, steps, workouts, sleep, measurements, and charts.
  • Notes with folders, tags, markdown, pinned notes, kinds, and search.
  • Analytics dashboards using Recharts.
  • AI Coach mock implementation with persisted chat history and future LLM integration boundary.
  • NextAuth email, Google, and seeded demo login.

Tech Stack

Next.js 15, TypeScript, Tailwind CSS, shadcn-style components, React Query, Zustand, PostgreSQL, Prisma, NextAuth/Auth.js, Recharts, Vitest, and pnpm.

Installation

pnpm install
cp .env.example .env
pnpm db:generate
pnpm db:migrate
pnpm db:seed
pnpm dev

Open http://localhost:3000.

Demo credentials:

student@ascend.ai
ascend123

Database Schema

The Prisma schema is in prisma/schema.prisma. It includes users, auth accounts/sessions, goals, milestones, tasks, habits/logs, calendar events, notes/folders, GATE subjects/topics/subtopics/PYQs/mocks/formulas/revisions, DSA problems, AI/ML learning topics, projects/milestones/tasks/issues/docs/sprints, fitness logs, workouts, and coach messages.

Testing

pnpm test
pnpm typecheck
pnpm build

Deployment

See docs/DEPLOYMENT.md. The app is Vercel compatible and requires PostgreSQL plus the environment variables in docs/ENVIRONMENT.md.

Documentation

  • docs/ARCHITECTURE.md
  • docs/DATABASE.md
  • docs/DEPLOYMENT.md
  • docs/DEVELOPER_GUIDE.md
  • docs/ENVIRONMENT.md

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages