Cadence

AI-powered voice journaling, habit tracking, and smart scheduling — in one place.

Cadence is a capstone project for the Quantic Master of Science in Software Engineering (MSSE) program. It combines three productivity tools that typically live in separate apps — a voice journal, a habit/goal tracker, and an AI-assisted schedule planner — into a single, cohesive experience powered by AI.

---

What It Does

Feature	Description
Voice Journal	Record spoken entries; AI transcribes and surfaces themes, mood trends, and action items
Goals & Habit Tracking	Set goals with milestones, track daily streaks, and visualize progress
Smart Scheduling	AI suggests optimal times for tasks based on your habits and energy patterns
Analytics Dashboard	Charts and insights across mood, streaks, journal frequency, and schedule adherence
Live Demo	Interactive walkthrough of all features with pre-loaded mock data

---

Tech Stack

Layer	Technology
Framework	React 19 + TypeScript
Build tool	Vite
Styling	Tailwind CSS v4 (CSS-first config)
UI components	shadcn/ui + Radix UI primitives
Routing	Wouter
Charts	Recharts
Animations	Framer Motion
Icons	Lucide React
Forms	React Hook Form + Zod
Data fetching	TanStack React Query
Font	Inter (Google Fonts)
Package manager	pnpm (monorepo workspace)
CI	GitHub Actions (type-check + lint on every PR)
Hosting	Replit

---

Project Structure

artifacts/cadence/
├── src/
│   ├── pages/
│   │   ├── LandingPage.tsx      # Marketing / home
│   │   ├── LoginPage.tsx
│   │   ├── SignupPage.tsx
│   │   ├── JournalPage.tsx      # Voice journal + entry list
│   │   ├── GoalsPage.tsx        # Goals, habits, streaks
│   │   ├── AnalyticsPage.tsx    # Charts & insights dashboard
│   │   ├── SchedulePage.tsx     # AI smart schedule
│   │   └── ExamplePage.tsx      # Live interactive demo
│   ├── components/
│   │   ├── Sidebar.tsx          # Desktop navigation
│   │   ├── MobileNav.tsx        # Mobile bottom nav
│   │   ├── AppLayout.tsx        # Authenticated app shell
│   │   ├── PublicLayout.tsx     # Public page shell
│   │   ├── ProtectedRoute.tsx   # Auth guard
│   │   └── ui/                  # shadcn/ui component library
│   ├── context/
│   │   └── AuthContext.tsx      # Mock auth (localStorage)
│   └── index.css                # Tailwind v4 theme + brand palette
├── .github/
│   └── workflows/
│       └── ci.yml               # Type-check + lint on every PR
└── scripts/
    └── post-merge.sh            # Auto-push to GitHub after every merge

---

Running Locally

Prerequisites: Node.js 22+, pnpm 10+

# Clone the repo
git clone https://github.com/zigzagzilla/MSSE0826-CAPSTONE.git
cd MSSE0826-CAPSTONE

# Install dependencies
pnpm install

# Start the dev server
pnpm --filter @workspace/cadence run dev

The app will be available at http://localhost:5173 (or the port shown in your terminal).

Other useful commands

# Type-check
pnpm --filter @workspace/cadence run typecheck

# Lint
pnpm run lint

# Production build
pnpm --filter @workspace/cadence run build

---

Authentication

Authentication is mocked for the capstone demo — no backend is required. Signing up or logging in stores a user session in localStorage under the key cadence_mock_user. To reset your session, clear localStorage in your browser's developer tools.

---

CI / Quality Gates

Every pull request triggers a GitHub Actions workflow that runs:

1. Type check — tsc --noEmit across all packages
2. Lint — ESLint with TypeScript and React Hooks rules

No PR merges if either check fails.

---

Team

Name	Role
Matt	Project Owner · Frontend · Deployments
Peter	Code Owner · Features
Annelie	Scrum Master · User Stories
Shannon	Project Co-owner · Market Research

Quantic School of Business and Technology — MSSE Capstone, 2025–2026

---

Live Demo

The deployed app is hosted on Replit: https://cadence-ai.replit.app

Visit the Live demo page (/example) for an interactive walkthrough of all features without needing to create an account.