Personal OS Starter Kit

Inspired by @milesdeutscher's 143K-view Personal OS guide. The backend, packaged and ready to drop in.

What's Included

File	What It Does
supabase/migrations/001_personal_os.sql	Full Supabase schema — 10 tables, RLS, enums, indexes, daily_dashboard view
claude-code-master-prompt.md	Paste into Claude Code → get a full Next.js + Tailwind frontend scaffolded
src/app/api/telegram/route.ts	Next.js App Router webhook — routes Telegram messages to Supabase by intent

Quick Start

1. Supabase

1. Create a new Supabase project
2. Open the SQL Editor
3. Paste supabase/migrations/001_personal_os.sql and run it
4. You now have 10 tables with RLS + a daily_dashboard view

2. Frontend (Claude Code)

1. Open a new Claude Code project
2. Paste the entire contents of claude-code-master-prompt.md
3. Claude scaffolds the full Next.js app step by step

3. Telegram Bot

1. Create a bot via @BotFather and get your token
2. Drop src/app/api/telegram/route.ts into your Next.js project
3. Set your webhook: https://api.telegram.org/bot<TOKEN>/setWebhook?url=<YOUR_URL>/api/telegram
4. Messages are classified by intent and written to Supabase automatically

Environment Variables

NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
TELEGRAM_BOT_TOKEN=your-bot-token
TELEGRAM_CHAT_ID=your-chat-id
SUPABASE_USER_ID=your-auth-user-uuid

What Gets Built

• Dashboard — widget layout from daily_dashboard view (tasks, habits, net worth)
• Tasks — Kanban + list view, priority-sorted, Telegram-fed
• Habits — SVG progress rings, streaks, one-tap completion
• Finances — transactions, net worth snapshots
• Journal — daily entries with mood tracking
• Brain — second brain / notes
• Nutrition — meal logging
• Calendar — calendar integration

Database Tables

projects · tasks · habits · habit_logs · journal_entries · finances · finance_snapshots · brain_notes · nutrition_logs · telegram_messages

Tech Stack

Next.js (App Router) · TypeScript · Tailwind CSS · Supabase · Vercel · Telegram Bot API

---

Built by Harel Asaf · Free to use, fork, and adapt.