Skip to content
FRX132Public

About

E.O.M (Escape Of Matrix) is a premium, minimalist desktop application designed to gamify and organize every facet of your life. Built with a "local-first" philosophy, it combines productivity with RPG-inspired progression mechanics.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

E.O.M — Life Planner OS 🧠

E.O.M (End of Month / Escape of Matrix / Each One Matters) is a premium, high-performance personal operating system designed to gamify, optimize, and organize every facet of your life. Built with a "local-first" privacy philosophy, it combines productivity with RPG-inspired progression mechanics on Desktop, Web, and Mobile (PWA & iOS).

E.O.M Dashboard

Vercel Deployment PWA Ready License: MIT


🌐 Live Preview & Showcase

Try the interactive web showcase and documentation:


✨ Core Modules & Capabilities

🤖 Agent Hunter (A.H.) & Performance State Engine [0..10]

An integrated autonomous intelligence work-agent coordinating your entire Life OS workspace:

  • Handwritten Blueprint Architecture: Seamlessly links Register Baseline (Age, Weight, Height, Education) ➔ Settings ➔ System Quad (Expense, Targets, Goals, Habits) ➔ Execution Feedback Loop (Tracker, Workout Hub ➔ Journal, Timetable, Skill Tree).
  • Algorithmic Performance State Index [0..10]: Real-time performance calculation from 0 = Basics (0%) to 10 = Professional (100%) across all 7 life pillars.
  • Tages-Jagd & Autonomous Hunter Quests: Identifies life bottlenecks and prescribes 3 immediate high-impact directives.
  • Daily Executive Morning Briefing: Synthesizes habits, timetable blocks, budget radar, fridge meal inventory, and global RSS news into a motivational morning kickoff.
  • Smart Kitchen & Restock Agent: Analyzes in-stock ingredients and invents targeted fitness meals with 1-click grocery restock.
  • Hands-Free Voice Interface: Web Speech API Speech-to-Text (Microphone with pulsing ring) and Text-to-Speech (Audio Voice Readout).
  • Zero-Config Local AI & Cloud Providers: Runs offline via Transformers.js or connects OpenAI, Anthropic Claude, Ollama, and LM Studio.
  • Pseudo-MCP Command Router: Translate natural language prompt commands directly into system state actions.

📰 Global News & Intelligence Hub

A multi-tier real-time news radar and intelligence center powered by top global media:

  • Top 10 Global News Outlets & Agencies:
    • 🏛️ Nachrichtenagenturen (Fakten-Goldstandard): Reuters, Associated Press (AP), Agence France-Presse (AFP).
    • 🌐 Globale Reichweiten-Giganten: BBC News, The New York Times, CNN, The Guardian.
    • 📈 Geopolitik & Wirtschaft: Bloomberg, Financial Times, Al Jazeera English.
    • 🇩🇪 Nationale & Tech-Feeds: Tagesschau, Der Spiegel, Heise Online, Golem.de, The Verge, Wired, TechCrunch, NASA.
  • Media Tier Quick Filters: Filter articles dynamically by Fakten-Agenturen, Globale Giganten, Geopolitik & Märkte, Nationale Leitmedien oder Tech & Science.
  • Live RSS Ingestion: High-throughput parallel feed parser with dual CORS proxy failover.
  • Audio Reader (Text-to-Speech): Listen to breaking headlines and article summaries on the go.
  • Interactive Modals & Ticker: Daily Morning Briefing generator, RSS Feed Manager with toggle switches, bookmarking, and full-screen distraction-free article reader.

🎨 Advanced Design System & Retro Aesthetics

A fully customizable UI engine with 16+ Interface Templates and 8 Typography engines:

  • Modern & Sci-Fi Templates: Cyberpunk Neon, Aero Glassmorphism, Neo-Brutalism, Fallout CRT Terminal, Nordic Minimalist, Obsidian Gold, Claymorphism Soft 3D, Neumorphism, Aurora Glow UI.
  • Retro Website Styles (ReallyGoodDesigns):
    • 🕺 70s Disco Groove & Vinyl: Warm amber/gold gradients, vinyl record radial textures, Playfair serif.
    • 🕹️ 80s Synthwave & Arcade Neon: Outrun laser grids, CRT scanline glow, chamfered corners, VT323 pixel font.
    • 📟 Y2K & Nokia 3310 LCD: Dot-matrix matrix green LCD, stepped pixel borders, Share Tech Mono.
    • 📜 Vintage Editorial & Parchment: Antique Italian letterpress, wax seal mahogany, double-framed borders.
    • 🌐 90s Web 1.0 & Windows 95: Classic Win95 teal desktop, 3D beveled raised/inset frames.
    • 🍸 1920s Art Deco Luxury: Deep obsidian black & champagne gold, Gatsby geometric cutouts, Cinzel serif.
    • 🍦 50s Pastel Diner & Pin-Up: Mint turquoise, strawberry milkshake pink, rounded diner badge curves.
  • Fine-Tuning Controls: Glassmorphism blur slider, corner radius slider, compact mode, neon glow toggle, 1-click Quick Presets, and smart randomizer.

💰 Finance Hub (Expense Tracker)

Professional-grade financial management with:

  • Automatic Calculations: Real-time tracking of income, expenses, and total balance.
  • Performance Optimized: Sub-millisecond interface responsiveness via memoized render-trees and delayed state writes.
  • Recurring Payments: Automated monthly deductions for bills and subscriptions.
  • Budgeting & Visual Analytics: Custom category budgets and interactive cash-flow charts.

🏋️‍♂️ Workout Hub (Anatomical Map)

High-fidelity fitness tracking featuring:

  • Dual Anatomy Support: Toggle between male and female anatomical SVG frames.
  • Muscle Targeting: Interactive body maps to select and log specific muscle group sessions.
  • Smart Sync: Automatically syncs body structure with your user profile gender.

🛡️ Skill Tree & Dynamic Habits

The RPG engine powering your daily progress:

  • 5 Progression Trees: Level up in Health, Social, Career, Spirit, and Mental.
  • Dynamic Habit Syncing: Daily habits directly reward XP and advance your overall agent rank.

📅 Timetable & Big Targets

  • Weekly Schedule Matrix: Time-blocked weekly schedule with task status management.
  • Big Targets Vision Board: Track long-term milestone quests and five-year achievements.

🗺️ Master Project Canvas Visualizer (Full OS Graph)

A connected, interactive 2D node constellation visualizing your entire life operating system:

  • Full OS Element Sync: Automatically reads and displays items from every module in real time:
    • 📝 Markdown Documents: Live rendered snippet cards with word counts, 👁️ quick modal expander, and ✏️ direct 1-click jump into the Markdown Editor (location.state.activeFileId).
    • 🎯 Targets & Goals: Dynamic progress rings, deadline countdowns, and completion states.
    • ⚡ Daily Habits: Live streak indicators and daily check-off triggers.
    • 🏋️ Workouts: Targeted muscle group diagrams, duration, and exercise logs.
    • 📖 Journal Reflections: Introspection excerpts, mood scores, and timestamps.
    • 💳 Finance Ledgers: Categorized income/expense entries and running balances.
    • 📚 Library & Cinema: Books, movies, watchlists, ratings, and travel itineraries.
    • 🛡️ Skill Quests: Level-up milestone trees across all 5 life pillars.
    • 📅 Timetable Routines: Time-blocked weekly schedule items.
    • 📌 Sticky Notes: Color-coded freeform brainstorm notes.
  • Solar Constellation Layout: Radial galaxy structure placing the central OS Core at the center with layered orbital module rings.
  • Instant Layer Filter & Live Search: Fast toggle buttons (All, Docs, Targets, Habits, Sport, Journal, Finanzen, Library, Cinema, Trips, Skills, Routine) and instant keyword filter.

⏳ Cybernetic Loading Screen & Telemetry Engine

A high-tech sci-fi HUD overlay and embedded loading system:

  • Real-Time Telemetry: Numerical percentage readout and pulsing laser gradient progress bar.
  • Byte Stream Telemetry: Dynamic downloaded MB vs total MB counter (e.g. 142.5 MB / 250.0 MB).
  • Autonomous Triggering: Automatically engages during @xenova/transformers local ONNX weight initialization, large PDF document parsing, or async system loads.
  • Cloud Fallback Switch: 1-click override to instantly toggle to Cloud AI if local weight downloads take too long.

🧊 Fridge Stock & Meal Inventory

  • Track pantry and refrigerator food items with expiry countdowns, quantity counters, and grocery list generation.

📚 Media Databases & Secret Locker

  • Library (Books) & Cinema (Movies/Series): Track reading progress, watchlists, and personal ratings.
  • Password Manager & Secrets: Client-side encrypted credential store.
  • Markdown Journal & Note Vault: Creative node canvas and note editor with full OS synchronization.

🔒 Local-First Privacy & Zero-Knowledge Security Architecture

E.O.M is architected around a strict Local-First & Zero-Knowledge Privacy Philosophy:

  • 100% Client-Side Storage: All user credentials, health metrics, financial transactions, habits, workouts, and journal entries are stored exclusively on your physical device hardware.
  • Zero GitHub & Remote Exposure: The public GitHub repository contains only the front-end application code, build scripts, and static assets. No user data, passwords, or personal logs ever leave your machine or touch GitHub.
  • Physical Storage Locations Across Platforms:
    Platform / Shell Local Storage Path Mechanism
    macOS Desktop (Electron) ~/Library/Application Support/eom/Local Storage/leveldb/ Chromium LevelDB Engine
    Windows Desktop (Electron) %APPDATA%\eom\Local Storage\leveldb\ Chromium LevelDB Engine
    Web & PWA Sandboxed browser origin domain storage HTML5 localStorage & IndexedDB
    iOS (iPhone/iPad) Sandboxed native App container Capacitor Native WebKit Storage
    Android Sandboxed internal storage (/data/data/com.eom.os/) Capacitor Android WebStorage / SQLite
  • Credential & State Recovery:
    1. In-App Recovery: Click "Forgot Password" on the Login screen and enter your Username to view your local backup password on screen.
    2. Desktop DevTools: Press Cmd + Shift + I (Mac) or Ctrl + Shift + I (Windows) in the Electron app ➔ open the Application tab ➔ select Local Storage ➔ inspect os_profile.
    3. Encrypted Local Backups: Export encrypted .json snapshots directly to your local filesystem or configure daily auto-backup folders without third-party servers.

🔄 Multi-Device Updates & Synchronization

When code updates or new features are pushed, user data is never overwritten or wiped:

  • Web & PWA: Pushing to GitHub deploys to Vercel instantly. Service Worker reloads fresh assets while preserving browser localStorage.
  • macOS Desktop (.dmg): Running npm run electron:build creates an updated .dmg. Replacing the app in /Applications updates the binary while preserving ~/Library/Application Support/eom/.
  • Windows Desktop (.exe): Running npm run electron:build:win updates the binary while keeping %APPDATA%\eom intact.
  • iOS & Android: Running npm run build && npx cap sync transfers web bundle changes into native projects for Xcode and Android Studio builds.

📱 Mobile & PWA Support (Zero Xcode Needed)

E.O.M is a complete Progressive Web App (PWA) that can be installed instantly on any mobile device:

iOS (iPhone & iPad)

  1. Open the web app or https://eom-preview.vercel.app in Safari.
  2. Tap the Share button (box with upward arrow).
  3. Scroll down and tap Add to Home Screen (Zum Home-Bildschirm).
  4. Launch E.O.M in fullscreen standalone mode.

Android

  1. Open in Google Chrome.
  2. Tap the 3-dots menu ➔ Install app or Add to Home screen.

🚀 Technical Stack

  • Frontend Core: React 19, Vite, React Router v7.
  • State & Local Persistence: Zustand with localStorage fallback and Cloud Sync URL loader.
  • PWA & Offline: vite-plugin-pwa with custom Service Worker caching.
  • Desktop: Electron 34 with cross-platform packaging.
  • Mobile Container: Capacitor iOS & Android.
  • AI & NLP: AgentHunter.js Web Worker Engine (@xenova/transformers & ONNX runtime-web for zero-config offline intelligence).
  • Styling: Vanilla CSS Variables Design System with Google Fonts (Inter, Outfit, JetBrains Mono, Roboto, Playfair Display, Cinzel, VT323, Share Tech Mono).

🛠️ Getting Started

Prerequisites

Installation

  1. Clone the repository:
    git clone https://github.com/FRX132/E.O.M.git
    cd E.O.M
  2. Install dependencies:
    npm install
  3. Start development server:
    npm run dev

📦 Building for Production

Web & PWA Bundle

npm run build
npm run preview

Desktop App (Electron)

  • Mac App (.dmg): npm run electron:build
  • Windows Executable (.exe): npm run electron:build:win

Native iOS (Capacitor Xcode Project)

npm run build
npx cap sync ios
npx cap open ios

Native Android (Capacitor Android Studio Project)

npm run build
npx cap sync android
npx cap open android

📂 Project Structure

E.O.M/
├── Preview Page/            # Interactive Vercel showcase landing page & serverless API
│   ├── api/validate.js      # Serverless validation function
│   ├── index.html           # Landing page with PWA launch modal
│   ├── Documentary.html     # Comprehensive system documentation & guides
│   └── vercel.json          # Deployment & routing configuration
├── electron/                # Electron main process & desktop preload scripts
├── ios/                     # Native Capacitor iOS container
├── android/                 # Native Capacitor Android container
├── src/
│   ├── components/
│   │   ├── Agency/          # NewsHub, Journal, MovieList, PasswordManager, etc.
│   │   ├── Functions/       # AIAssistant, ProjectCanvas, Editor
│   │   ├── Health/          # HabitTracker, FridgeStock, SportHub
│   │   ├── Intelligence/    # GoalPlanner, BookList
│   │   ├── UI/              # LoadingScreen, Modals, Buttons
│   │   ├── Styles/          # Templates_Interface.css, Default.css, NewsHub.css
│   │   └── User/            # ProfileSettings, Overview, ExpenseTracker, Timetable
│   ├── services/            # newsService.js (RSS parser & live channels)
│   ├── App.jsx              # Application router & theme controller
│   ├── store.js             # Zustand store & persistence schema
│   └── index.css            # Design token system & typography imports
├── vite.config.js           # Vite + PWA configuration
├── how_to_build.md          # Multi-platform build & update manual
└── package.json

📜 License

MIT — Created by FRX132.

About

E.O.M (Escape Of Matrix) is a premium, minimalist desktop application designed to gamify and organize every facet of your life. Built with a "local-first" philosophy, it combines productivity with RPG-inspired progression mechanics.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages