Skip to content

codeyam-ai/wellframe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wellframe

A privacy-first, local-first AI wellness console. The Dashboard "Daily Briefing" answers "How am I doing today?" at a glance — a readiness dial, overnight vitals, an observant coach transmission, and yesterday's activity — all read from data on your own machine. The Activity Timeline answers "what have I been doing?" — a day-grouped, filterable feed of workouts, daily briefings, mood check-ins, and body-weight readings, each opening a dedicated detail view.

Four more consoles round out the picture, all in the same deep-ink language and reachable from the top nav: Trends charts sleep, HRV, resting heart rate, mileage, and training load across weekly / monthly / yearly ranges; the Recovery Center reads those signals into a single recovery score with expandable contributing factors and suggested recovery moves; Goals tracks objectives (mileage, races, sleep, strength cadence) as progress rings and lets you create new ones; and the Daily Check-in captures a morning or evening snapshot — energy, mood, sleep, soreness, stress, and a reflection — that also lands on the Timeline. Every surface starts empty on day one and fills in as data arrives.

Setup

Run the setup script to install dependencies, initialize the database, and seed it with demo data:

npm run setup

Development

Start the dev server:

npm run dev

Open http://localhost:3000 in your browser.

Using CodeYam Editor

This project was built with CodeYam. To launch the editor:

codeyam editor

The editor provides a live preview alongside a Claude Code terminal for iterating on the app.

Database

This project uses SQLite via Prisma. Common commands:

npm run db:push    # Apply schema changes and generate Prisma client
npm run db:seed    # Seed the database with demo data
npm run db:reset   # Reset database: drop, recreate, and re-seed

Scripts

Script Description
npm run setup One-line project setup (install + db + seed)
npm run dev Start the development server
npm run build Build for production
npm run test Run tests
npm run db:push Apply Prisma schema changes
npm run db:seed Seed the database
npm run db:reset Reset and re-seed the database

Develop this project with codeyam-editor

This project is built with codeyam-editor — code and runnable data scenarios are authored side by side against a live preview.

# Launch the editor (split-screen terminal + live preview)
codeyam-editor editor

# Run the app
npm run dev

# Run the tests
npx vitest run

Scenario gallery

States captured as runnable scenarios with codeyam-editor:

Check-in - Day One

Check-in - Day One

Check-in - Logging

Check-in - Logging

Dashboard - Connections Setup

Dashboard - Connections Setup

Dashboard - Day One Empty

Dashboard - Day One Empty

Dashboard - Day One Setup

Dashboard - Day One Setup

Dashboard - Low Readiness

Dashboard - Low Readiness

Dashboard - No Workout Yesterday

Dashboard - No Workout Yesterday

Dashboard - Partial Data

Dashboard - Partial Data

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors