Skip to content
ayushjoshi0118Public

About

An intelligent, privacy-conscious personal operating system to organize your life, accomplish meaningful goals, develop habits, master skills, manage finances, and make intentional decisions.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

1 Commit

Folders and files

Repository files navigation

LIFE OS

Build your life with intention.

One place to understand where you are, decide where you want to go, and take the next meaningful step.

License: MIT Tests: 22 Passed TypeScript: Strict Privacy: Local--First


🧭 Product Philosophy

Most productivity software devolves into a graveyard of disconnected CRUD records or addictive gamification loops. LIFE OS is built on a different philosophy:

  1. Action over endless planning: Planning is only valuable when it leads to the next practical action.
  2. Meaningful progress over vanity metrics: No manufactured productivity scores designed to induce dopamine.
  3. Consistency without shame: Streaks are measured against your planned schedule. Unscheduled rest days never break your streak, and life disruptions are met with compassionate recovery.
  4. Privacy by design: Your reflections, journal entries, and financial records stay on your local device.
  5. Verified analytics: Insights are grounded in actual recorded data, never fabricated or extrapolated.
  6. Dual AI architecture: Operates 100% offline via a deterministic rule-engine; optionally connects to Google Gemini when configured.
  7. Calm, distraction-free aesthetic: Deep midnight surfaces, emerald accents, and clear typography that support focus rather than distraction.

The Five Questions

Every feature in LIFE OS helps answer at least one fundamental question:

  1. Where am I in my life right now?
  2. What matters most to me?
  3. What should I focus on today?
  4. Am I making meaningful progress?
  5. What should I change next?

🌟 Core Modules

1. The Today Dashboard β€” The Heart of Life OS

  • Daily Command Center: Time-of-day greeting, date, and Top 3 Daily Priorities.
  • Tasks Due Today: Real-time duration estimates, status toggling, and workload capacity health.
  • Overdue Tasks Recovery: Transparent alert with 1-click bulk reschedule to today.
  • Habits Checklist: Today's active routines with streak indicators and 1-click completion or planned skip.
  • Deep Work Focus Widget: Quick-start 25-minute Pomodoro timer with logged minutes summary.
  • Spaced Repetition Target: Prompt when active recall flashcards reach interval dates.
  • Daily Reflection Prompt: 5-point mood selector with one-line gratitude/win logger.
  • Smart Daily Briefing: Contextual analysis of today's schedule with practical next actions.

2. Goals & Life Planning

  • Multi-Category Hierarchies: Career, Education, Health, Finance, Relationships, Creativity, Lifestyle, and Custom.
  • Personal Motivation: Every goal records the deep "Why this matters" reason.
  • Milestones & Decomposition: Goals break into sequential milestones and linked daily tasks.
  • Transparent Calculations: Progress computed directly from milestone and task completion percentages.

3. Tasks & Project Management

  • Flexible Views:
    • List View: Filter by Today, Upcoming, Overdue, Completed, or All with live search.
    • Kanban Board: Drag and move cards across Backlog, To Do, In Progress, and Done.
    • Projects View: Finite initiatives with intended concrete outcomes and task progress.
  • Intelligent Workload Estimation: Calculates sum of task durations against your configurable daily capacity (e.g. 360m / 6h). Warns when scheduled work exceeds feasible capacity.

4. Habits & Behavioral Consistency

  • Flexible Schedules: Daily, selected weekdays (Mon-Fri), or weekly target frequencies.
  • True Streak Engine: Streaks calculate using local dates and scheduled days. Rest days never break a streak.
  • 12-Week Adherence Matrix: GitHub-style consistency heat matrix visualizing habit adherence.
  • Habit Architecture: Explicit cue/trigger, minimum viable version (tiny habit floor), and immediate reward.

5. Personal Learning & Skill Development

  • Skill Curriculums: Multi-module learning paths with sequential lessons and mastery tracking.
  • SuperMemo SM-2 Active Recall Engine:
    • Full implementation of the SuperMemo SM-2 spaced repetition algorithm.
    • Interactive flip study cards with 6-point recall difficulty ratings (0 to 5).
    • Dynamically recalculates intervals, repetitions, and easiness factors (min EF = 1.3).
    • Scheduled review backlog and celebration confetti on completion.

6. Focus Sessions & Time Management

  • Pomodoro & Flowtime Timer: Configurable focus intervals (default 25m), short breaks (5m), and long breaks (15m).
  • Resilient Timekeeping: Calculated via high-resolution performance timestamps (performance.now()), preventing browser background throttling from corrupting timer elapsed time.
  • Pure Web Audio Synthesizer: Procedural acoustic chimes for start and finish without requiring external audio asset downloads.
  • Distraction-Free Zen Mode: Clean, full-screen minimalist overlay.
  • Contextual Association: Link sessions directly to specific tasks and goals.

7. Journal & Self-Reflection

  • Private Local Journal: End-to-end client-side storage.
  • Guided Reflection Prompts: Wins today, lessons learned, obstacles encountered, and moments of gratitude.
  • Mood Tracking: 5-level mood log with visual indicators.
  • Search & Tagging: Instant local search across entries.

8. Personal Finances & Financial Goals

  • Cashflow Tracking: Inflows and outflows with category tagging and recurring flags.
  • Monthly Budget Limits: Pacing progress bars alerting when spending nears or exceeds 85% of caps.
  • Capital Reserve Targets: Financial goals (e.g. 6-Month Emergency Runway, Tuition) connected to overarching goals.
  • CSV Data Portability: 1-click CSV export and CSV import with validation.
  • Donut Chart Breakdown: Visual category spending distribution.

9. Transparent Smart Insights Engine

  • Grounded strictly in verified application data:
    • Stale Goals Alert: Active goals with zero progress over the past 14 days.
    • Approaching Deadlines: Urgent tasks due within 48 hours.
    • Overloaded Schedule Warning: Planned minutes exceeding daily capacity.
    • Due Flashcards: Spaced repetition cards ready for active recall.
    • Budget Alerts: Spending approaching monthly threshold.

10. Weekly & Monthly Reviews

  • Automated Retrospective Aggregation: Sums verified completed tasks, focus hours, habits, and spending over the past 7 days.
  • 4 Guided Reflection Questions: Wins, obstacles, adjustments, and single top priority for the upcoming week.
  • Archived History: Revisit past reviews anytime.

11. Life Balance & Wheel of Life

  • 8 Dimensions: Career, Health, Learning, Wealth, Relationships, Mindset, Creativity, Environment.
  • Interactive SVG Radar Chart: Visual polygon balance representation.
  • Custom Intentions: Define personal intentions for each area without forced uniform equality.

12. AI Copilot & Deterministic Private Engine

  • Dual Engine Architecture:
    • Offline Deterministic Copilot: Works instantly with zero setup, zero cost, and complete privacy. Answers "plan my day", "break down this goal", "summarize my progress", and "explain spending".
    • Optional Google Gemini API: Connects to gemini-2.5-flash or gemini-2.5-pro when user configures an API key.
  • Safe Tool Proposal Cards: Proposed tasks and milestones render as interactive cards with Accept & Add or Dismiss buttons. Never modifies records without confirmation.

πŸ› οΈ Technology Stack

Layer Technology
Framework React 19 + Vite 8
Language TypeScript (Strict mode)
Styling Tailwind CSS v3 with custom design tokens
Persistence Local-First IndexedDB + LocalStorage Fallback
Audio Pure Web Audio API Synthesizer (Zero asset dependencies)
Visualizations Responsive SVG Radar, Bar, Donut, and Heatmap components
Testing Vitest + @testing-library/react
Icons Lucide React

πŸš€ Getting Started

Prerequisites

  • Node.js 18.0.0 or higher
  • npm (or pnpm / yarn)

1. Clone & Install

git clone https://github.com/your-username/LifeOS.git
cd LifeOS
npm install

2. Development Server

npm run dev

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

3. Run Automated Tests

npm run test

4. Build for Production

npm run build

πŸ§ͺ Testing Strategy

LIFE OS includes a comprehensive automated test suite verifying all critical business logic and calculations:

  • SM-2 Spaced Repetition:
    • Quality thresholds (0-5), repetition resets on failed recall (<3), 1-day and 6-day intervals, and minimum easiness factor boundary (1.3).
  • Habit Streaks:
    • Daily schedules, selected weekday schedules, unscheduled rest days preservation, and 30-day adherence rates.
  • Goal Progress:
    • Milestone weighted calculations, task completion shares, and 100% completion states.
  • Workload Capacity:
    • Estimated duration sums, daily capacity thresholds, and overload surplus detection.
  • Backup & Disaster Recovery:
    • Schema validation, malformed JSON rejection, missing field identification.
  • Deterministic Copilot Engine:
    • Natural-language query parsing and tool proposal generation.
# Execute Vitest test runner
npm run test

Result: 3 test files, 22 unit & integration tests passing.


πŸ”’ Privacy & Data Architecture

  • Local-First Storage: Your database resides inside your browser's IndexedDB storage.
  • Zero Required Cloud Backend: No accounts, tracking cookies, or subscription paywalls.
  • Portability: 1-click Export Complete Backup (.json) creates a timestamped JSON file.
  • Safe Recovery: 1-click Restore Backup (.json) validates schema integrity before importing.
  • Reset Controls: Easily switch between a blank workspace or the inspirational sample dataset.

⌨️ Global Keyboard Shortcuts

Shortcut Action
⌘K or Ctrl+K Open Global Command Palette & Search
ESC Close Modal / Command Palette / Exit Zen Mode
↑ ↓ Navigate Command Palette items
↡ (Enter) Select / Execute highlighted command

πŸ—ΊοΈ Roadmap

  • Local-first IndexedDB persistence with JSON export/import
  • Today Command Center with Smart Daily Briefing
  • Goals hierarchy with milestone decomposition
  • Tasks & Kanban board with workload capacity estimation
  • Habits tracker with true streak engine & 12-week heatmap
  • SuperMemo SM-2 active recall flashcard review decks
  • Focus timer with Web Audio chimes & Zen mode
  • Private guided journaling & mood logging
  • Personal finances with budgets, capital goals & CSV import/export
  • Wheel of Life interactive Radar chart
  • Dual AI Copilot (Deterministic offline + optional Google Gemini)
  • End-to-end encrypted peer-to-peer cloud sync (CRDTs)
  • WebAssembly SQLite storage driver option
  • Native desktop packaging via Electron / Tauri

πŸ“„ License

LIFE OS is licensed under the MIT License. Built for humanity with craft and care.

About

An intelligent, privacy-conscious personal operating system to organize your life, accomplish meaningful goals, develop habits, master skills, manage finances, and make intentional decisions.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages