MAP - Personal Productivity Platform

Project name: MAP One liner: A personal productivity platform that unifies calendar, tasks, notes, and health data in one workspace. Stack: Next.js 16 + React/TypeScript, Bun, PostgreSQL + Drizzle ORM, Tailwind CSS + Radix UI, iOS SwiftUI + HealthKit, Rust gateway services. Problem: Productivity and health information are fragmented across disconnected tools, making planning and decision-making slower and less informed.

MAP - Personal Productivity Platform

A personal productivity dashboard integrating calendar, tasks, notes, and health data into one unified interface. Includes a native iOS app for Apple Health sync.

Features

Web Dashboard

Calendar - Week view with Google Calendar sync, event management
Tasks - Task management with tags, due dates, and bulk actions
Notes - Folder-organized notes with search
Health - WHOOP integration for recovery, strain, sleep, and workout data
Goals - Goal tracking with completion stats

iOS App

Apple Health Sync - Pulls 25+ health metrics from HealthKit
Background Sync - Automatically syncs when new health data arrives
AI Chat - Chat with an LLM about your health data (OpenAI or Claude)
Sleep Tracking - Full sleep stage analysis (Core, Deep, REM, Awake)
Heart & Recovery - HRV, resting HR, VO2 Max, respiratory rate
Activity - Steps, distance, exercise time, stand time, flights climbed

Tech Stack

Web

Framework: Next.js 16 (App Router)
Database: PostgreSQL with Drizzle ORM
Auth: Google-only OAuth (web uses HTTP-only session cookies, iOS uses Bearer tokens)
Data Fetching: TanStack Query + API routes
Styling: Tailwind CSS 4 + Radix UI
Validation: Zod schemas
Package Manager: Bun

iOS

Platform: iOS 17+ / Swift 5.9
UI: SwiftUI
Health: HealthKit
LLM: OpenAI (device-side, user key)
Build: Xcode 16.2 target + SPM for MapHealthCore

Getting Started

Web Dashboard

# Install dependencies
bun install

# Use the repo's Node version
source ~/.nvm/nvm.sh && nvm use

# Start dev services (Postgres + web)
bun run dev:all

# Public URL via Cloudflare Tunnel (ephemeral)
bun run dev:all -- --tunnel try

# Public URL via named tunnel (stable)
bun run dev:all -- --tunnel named --tunnel-name map-ai

Dashboard runs on http://localhost:3000 (or pass --port)

The dev:all script streams logs from each service in one terminal and shuts everything down on Ctrl+C.

dev:all details:

Defaults to port 3000 and will exit if the port is already in use (use --port 3001 or PORT=3001).
Waits for Postgres health checks, then starts Next.js and waits for HTTP readiness.
--tunnel off|try|named controls Cloudflare Tunnel (default off).
--tunnel-name <name> sets the named tunnel (default map-ai).
NEXT_PUBLIC_APP_URL defaults to http://localhost:<port> if not set.

Public URL (Cloudflare Tunnel)

Use Cloudflare Tunnel when you need a public URL (OAuth callbacks, mobile device testing).

# Install cloudflared (macOS)
brew install cloudflared

# Start tunnel to local dev server (quick, ephemeral URL)
cloudflared tunnel --url http://localhost:3000

# Start named tunnel (stable URL)
cloudflared tunnel run map-ai

For the ephemeral URL: copy the https://*.trycloudflare.com URL and set it in .env.local as NEXT_PUBLIC_APP_URL=https://<your-tunnel-url>.
For a named tunnel: set NEXT_PUBLIC_APP_URL to the hostname you configured in Cloudflare (e.g. https://map-ai.yourdomain.com).
Restart bun run dev after changing NEXT_PUBLIC_APP_URL.
Update Google/WHOOP OAuth redirect URIs to match the tunnel URL.
For a named tunnel, ensure the tunnel exists and is configured to route to http://localhost:<port> before running cloudflared tunnel run <name>.

iOS App

cd ios

# Build MapHealthCore only
swift build

# Build/run the app target
open MapHealth.xcodeproj

Requirements: Xcode 16.2+, physical iOS device (HealthKit requires real device)

Project Structure

src/                            # Web Dashboard
├── app/                        # Next.js pages + API routes
│   ├── api/                    # REST API endpoints
│   ├── calendar/               # Calendar page
│   ├── tasks/                  # Tasks page
│   ├── notes/                  # Notes page
│   ├── health/                 # Health dashboard
│   ├── login/                  # Login page
│   ├── signup/                 # Signup page
│   └── settings/               # Settings page
├── components/
│   ├── calendar/               # Calendar components
│   ├── tasks/                  # Task components
│   ├── notes/                  # Note components
│   └── ui/                     # Radix UI primitives
├── db/                         # Drizzle ORM queries
├── hooks/                      # React Query hooks
│   ├── use-auth.ts             # Authentication
│   ├── use-calendar.ts         # Calendar data
│   ├── use-tasks.ts            # Tasks data
│   ├── use-notes.ts            # Notes data
│   └── use-whoop.ts            # WHOOP health data
├── lib/
│   ├── api/                    # API client + error handling
│   ├── auth/                   # Session management
│   └── validations/            # Zod schemas
└── types/                      # TypeScript types

ios/                            # iOS App
├── Sources/MapHealthCore/      # Shared library
│   ├── HealthKit/              # HealthKit queries
│   ├── Services/               # API client, background sync
│   └── Models/                 # Data models
├── MapHealth/                  # SwiftUI app target (Xcode)
├── MapHealth.xcodeproj         # Xcode project
├── Tests/MapHealthCoreTests/   # Swift Testing
├── MapHealthTests/             # Xcode unit tests
└── MapHealthUITests/           # Xcode UI tests

Authentication

Google-only OAuth for both web and iOS. Web sessions use HTTP-only cookies; iOS sends Authorization: Bearer <session> and stores the token in Keychain.

Route	Method	Description
`/api/auth/google`	GET	Initiate Google Sign-In (includes calendar scopes)
`/api/auth/google/callback`	GET	OAuth callback
`/api/auth/logout`	POST	Logout
`/api/auth/me`	GET	Get current user

Sessions are stored in the database with a 30-day sliding expiry.

Integrations

Google Calendar

OAuth 2.0 integration for calendar sync. Calendar OAuth is handled by the unified Google Sign-In flow.

Setup:

Create OAuth credentials in Google Cloud Console
Add redirect URI: {APP_URL}/api/auth/google/callback

Set environment variables:

GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret

Routes:

Route	Method	Description
`/api/google/status`	GET	Check if calendar is connected
`/api/calendar/sync`	POST	Sync calendars
`/api/calendar/events`	GET, POST	List/create events
`/api/calendar/events/[id]`	PUT, DELETE	Update/delete event

WHOOP

OAuth 2.0 integration for health/fitness data.

Setup:

Create app in WHOOP Developer Portal
Add redirect URI: {APP_URL}/api/whoop/callback

Set environment variables:

WHOOP_CLIENT_ID=your_client_id
WHOOP_CLIENT_SECRET=your_client_secret

Routes:

Route	Method	Description
`/api/whoop/auth`	GET	Initiate OAuth
`/api/whoop/callback`	GET	OAuth callback
`/api/whoop/sync`	POST	Sync health data
`/api/whoop/profile`	GET	User profile
`/api/whoop/recovery`	GET	Recovery scores
`/api/whoop/sleep`	GET	Sleep data
`/api/whoop/cycles`	GET	Strain cycles
`/api/whoop/workouts`	GET	Workout data
`/api/whoop/disconnect`	POST	Disconnect account

Kimi Agent Chat (Legacy Convex Path)

Feature-flagged Kimi integration for the legacy Convex agent path, with clawdbot-style workspace tools and confirm-before-write behavior. The active web /chat UI now targets the Rust gateway.

Behavior:

When CHAT_KIMI_ENABLED=true, /chat uses Kimi for generation.
Data-changing actions only run when the user message starts with confirm:.
If Moonshot embeddings fail and OPENAI_API_KEY is set, embeddings retry on OpenAI.

Environment variables:

# Enable Kimi for Convex /chat
CHAT_KIMI_ENABLED=true

# Moonshot (OpenAI-compatible API)
KIMI_API_KEY=your_moonshot_api_key
KIMI_BASE_URL=https://api.moonshot.ai/v1
KIMI_MODEL=kimi-k2-0711-preview
KIMI_EMBEDDING_MODEL=text-embedding-v4

# Optional embeddings fallback (OpenAI)
OPENAI_API_KEY=your_openai_api_key

Rust Gateway (OpenClaw Parity Rewrite)

/chat now targets a Rust gateway intended to replace Convex and become the OpenClaw-parity backend control plane (Postgres + Rust).

Run locally:

# from repo root
bun run gateway:dev

Required env vars:

RUST_GATEWAY_DATABASE_URL=postgres://...
# Optional:
RUST_GATEWAY_HOST=0.0.0.0
RUST_GATEWAY_PORT=18789
RUST_GATEWAY_AUTH_TOKEN=
# Optional scoped tokens (overrides single token):
# token|gateway.read,gateway.write,gateway.ws|subject-a;token2|gateway.read|subject-b
RUST_GATEWAY_AUTH_SCOPED_TOKENS=
RUST_GATEWAY_AGENT_ID=main
RUST_GATEWAY_MAIN_KEY=main
RUST_GATEWAY_DM_SCOPE=main # main | per-peer | per-channel-peer | per-account-channel-peer
RUST_GATEWAY_PRIMARY_MODEL=moonshot:kimi-k2-0711-preview
RUST_GATEWAY_FALLBACK_MODELS=openai:gpt-4o-mini
RUST_GATEWAY_CRON_POLL_INTERVAL_SECS=10
RUST_GATEWAY_HTTP_RATE_LIMIT_PER_MINUTE=600
RUST_GATEWAY_WS_RATE_LIMIT_PER_MINUTE=240
RUST_GATEWAY_WS_RESUME_MAX_EVENTS=500
RUST_GATEWAY_IDEMPOTENCY_TTL_SECS=86400
RUST_GATEWAY_LOG_FORMAT=json # pretty | json
RUST_GATEWAY_SKILLS_WORKSPACE_DIR=./skills
RUST_GATEWAY_SKILLS_MANAGED_DIR=~/.openclaw/skills
RUST_GATEWAY_SKILLS_BUNDLED_DIR=.ai/refs/openclaw/skills
OPENCLAW_REF_COMMIT=8c963dc5a680f74cd7a7143263e9ec7d047404c0

Gateway API coverage includes:

Session APIs (/v1/sessions, /v1/sessions/:id/messages)
Chat run APIs + SSE (/v1/chat/runs, /v1/chat/runs/:id/stream)
WebSocket chat.abort that cancels in-flight model generation and emits run.aborted
Model auth profiles + failover preview (/v1/models/*)
WebSocket control-plane parity (GET /v1/ws) including agent, agent.wait, send, poll, wake, agents.*, config.*, wizard.*, logs.tail, channels.logout, exec.approvals.*, and richer node.* (describe, invoke, event)
OpenClaw RPC alias compatibility across dot and slash forms for control-plane methods (for example agent.send and agent/send)
Skills discovery/rescan (/v1/skills)
Cron scheduler CRUD/run-now (/v1/cron/jobs*)
Security audit (/v1/security/audit)
Structured metrics snapshot (/v1/metrics)
Node pairing + token verification (/v1/nodes/*, including /v1/nodes/verify) with consistent approve/reject decision payloads
Channel account/route CRUD + inbound + pairing (/v1/channels/*, including DELETE /v1/channels/accounts/:id and DELETE /v1/channels/routes/:id)
Destructive action confirmation parity across chat and channel inbound flows (confirmed: true when required)
Centralized provider alias normalization (kimi, moonshot-ai, moonshotai => moonshot)

API Routes

All routes require authentication except public pages (/, /login, /signup, /auth/error) and the Google OAuth endpoints. Resources verify ownership via userId.

Route	Methods	Description
`/api/tasks`	GET, POST	List/create tasks
`/api/tasks/[id]`	GET, PUT, DELETE	Single task
`/api/tasks/bulk`	PUT, DELETE	Bulk operations
`/api/tags`	GET, POST	List/create tags
`/api/tags/[id]`	PUT, DELETE	Single tag
`/api/notes`	GET, POST	List/create notes
`/api/notes/[id]`	GET, PUT, DELETE	Single note
`/api/notes/[id]/duplicate`	POST	Duplicate note
`/api/folders`	GET, POST	List/create folders
`/api/folders/[id]`	PUT, DELETE	Single folder
`/api/goals`	GET, POST, DELETE	List/create/delete all goals
`/api/goals/[id]`	PUT, DELETE	Single goal
`/api/goals/stats`	GET	Goal statistics

Scripts

bun run dev        # Start dev server
bun run build      # Build for production
bun run lint       # Lint with Biome
bun run typecheck  # TypeScript check
bun run gateway:dev # Run Rust gateway scaffold
bun run gateway:build # Build Rust gateway
bun run db:push    # Push schema to database
bun run db:studio  # Open Drizzle Studio

Environment Variables

# Database
DATABASE_URL=postgres://...

# Google Calendar
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret

# WHOOP
WHOOP_CLIENT_ID=your_client_id
WHOOP_CLIENT_SECRET=your_client_secret

# App
NEXT_PUBLIC_APP_URL=http://localhost:3000
VITE_RUST_GATEWAY_URL=http://localhost:18789
VITE_RUST_GATEWAY_TOKEN=

# Convex /chat Kimi (optional, feature-flagged)
CHAT_KIMI_ENABLED=false
KIMI_API_KEY=
KIMI_BASE_URL=https://api.moonshot.ai/v1
KIMI_MODEL=kimi-k2-0711-preview
KIMI_EMBEDDING_MODEL=text-embedding-v4
OPENAI_API_KEY=

Name		Name	Last commit message	Last commit date
.ai/plans		.ai/plans
.claude		.claude
.github/workflows		.github/workflows
.vscode		.vscode
backend		backend
convex		convex
docs		docs
drizzle		drizzle
example-json		example-json
ios		ios
public		public
scripts		scripts
src		src
.gitignore		.gitignore
.nvmrc		.nvmrc
CLAUDE.md		CLAUDE.md
README.md		README.md
biome.json		biome.json
bun.lock		bun.lock
components.json		components.json
convex.json		convex.json
docker-compose.yml		docker-compose.yml
drizzle.config.ts		drizzle.config.ts
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package.json		package.json
postcss.config.cjs		postcss.config.cjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json
vite.config.mts		vite.config.mts

Navigation Menu

Repository files navigation

MAP - Personal Productivity Platform

Features

Web Dashboard

iOS App

Tech Stack

Web

iOS

Getting Started

Web Dashboard

Public URL (Cloudflare Tunnel)

iOS App

Project Structure

Authentication

Integrations

Google Calendar

WHOOP

Kimi Agent Chat (Legacy Convex Path)

Rust Gateway (OpenClaw Parity Rewrite)

API Routes

Scripts

Environment Variables

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

MAP - Personal Productivity Platform

Features

Web Dashboard

iOS App

Tech Stack

Web

iOS

Getting Started

Web Dashboard

Public URL (Cloudflare Tunnel)

iOS App

Project Structure

Authentication

Integrations

Google Calendar

WHOOP

Kimi Agent Chat (Legacy Convex Path)

Rust Gateway (OpenClaw Parity Rewrite)

API Routes

Scripts

Environment Variables

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages