Skip to content

Mr-OpenR/pfos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

PFOS - Personal & Family Operating System

A unified, deterministic, offline-first life management platform that solves real, recurring problems without AI hype or unnecessary complexity.

🎯 Core Features

  • One app, one login, multi-domain control
  • Offline-first: All data lives locally first; sync optional
  • Zero-knowledge: User owns keys; no backdoors
  • Rule-driven, not AI-driven: Predictable automation
  • Universal utility: Works for students, migrants, parents, freelancers, small businesses

πŸš€ Quick Start (Windows & Web)

Prerequisites

  • Node.js 16+ installed
  • npm or yarn package manager

Installation

  1. Navigate to the project directory:
cd pfos
  1. Install dependencies:
npm install
  1. Start the development server:
npm start
  1. Open your browser to http://localhost:3000

πŸ“Š Dashboard Features

βœ… Implemented Features

  1. Summary Cards

    • Total Expenses tracking
    • Pending Tasks counter
    • Expiring Documents alerts
    • Vault Items count
  2. Filters & Reports

    • Date range filtering (Today, Week, Month, Year, Custom)
    • Category filtering (All, Documents, Finance, Tasks, Vault)
    • Export to PDF, Excel, CSV
  3. Custom Dashboard

    • Toggle widgets on/off
    • Available widgets:
      • Upcoming Expiries
      • Pending Tasks
      • Recent Expenses
      • Summary Cards
      • Analytics Charts
  4. Upcoming Expiries

    • Color-coded alerts (Critical, Warning, Info)
    • Days remaining counter
    • Quick renew action
  5. Pending Tasks

    • Priority levels (High, Medium, Low)
    • Due date tracking
    • Quick complete action
  6. Recent Expenses

    • Multi-currency support (USD, SCU, PKR, etc.)
    • Category tagging
    • Date tracking
    • Detailed view option

πŸ—„οΈ Database Schema

The application uses SQLite with the following core tables:

  • users - User identity and emergency contacts
  • devices - Device trust management
  • documents - Scanned documents with expiry tracking
  • currency_units - Custom currency definitions
  • expenses - Multi-currency expense tracking
  • tasks - Tasks and appointments
  • vault_items - Encrypted password storage
  • emergency_records - Digital will and emergency data
  • rules - Automation rules engine

🎨 Customization

Custom Currency Units

The system supports custom currency units for:

  • Site-specific currencies (e.g., "Site Cash Units")
  • Family tokens
  • Barter systems
  • Asset tracking

Dashboard Widgets

Users can customize their dashboard by:

  1. Clicking "Customize Dashboard" button
  2. Selecting/deselecting widgets
  3. Widgets automatically rearrange

πŸ“± Platform Support

  • βœ… Web Browser (Chrome, Firefox, Edge, Safari)
  • βœ… Windows Desktop (via browser or Electron build)
  • πŸ”„ Mobile (React Native - Coming in Phase 2)
  • πŸ”„ Linux/Mac (via browser or Tauri build)

πŸ” Security Features

  • Local-first data storage
  • Encrypted vault for passwords
  • Device trust levels
  • Emergency access controls
  • Zero-knowledge architecture

πŸ“ˆ Roadmap

Phase 1 (Current - 8 weeks)

  • βœ… Local SQLite DB
  • βœ… Dashboard UI
  • βœ… Custom Currency support
  • πŸ”„ Document Scan + OCR
  • πŸ”„ Expiry Tracker
  • πŸ”„ Basic Rules

Phase 2 (6 weeks)

  • Family sharing
  • Cloud sync (encrypted)
  • Backup/Export
  • Mobile app

Phase 3 (4 weeks)

  • Password Vault
  • Digital Will
  • Advanced Rules
  • Queue estimation

πŸ’° Monetization

Tier Features Price
Free Single user, local-only, 5 custom units, basic rules $0
Family Family sharing (5 users), cloud backup, 20 custom units, expiry alerts $0/month
Pro Unlimited rules, audit logs, export to Excel/PDF, queue API integrations $0/month

πŸ› οΈ Technology Stack

  • Frontend: React 18
  • State Management: Zustand
  • Database: SQLite (better-sqlite3)
  • Styling: CSS3 with modern gradients
  • Build Tool: Create React App
  • Future: Tauri for desktop, React Native for mobile

πŸ“ Development

Project Structure

pfos/
β”œβ”€β”€ public/
β”‚   └── index.html
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   └── dashboard/
β”‚   β”‚       β”œβ”€β”€ DashboardScreen.js
β”‚   β”‚       └── Dashboard.css
β”‚   β”œβ”€β”€ database/
β”‚   β”‚   └── schema.sql
β”‚   β”œβ”€β”€ App.js
β”‚   β”œβ”€β”€ App.css
β”‚   β”œβ”€β”€ index.js
β”‚   └── index.css
└── package.json

Build for Production

npm run build

This creates an optimized production build in the build/ folder.

🀝 Contributing

This is a personal project blueprint. Feel free to fork and customize for your needs.

πŸ“„ License

MIT License - Use freely for personal or commercial projects.

🎯 Why PFOS Wins

  • Solves fragmentation: One place for docs, money, tasks, IDs, passwords
  • Works offline: Critical for global users (migrants, rural, travelers)
  • Custom Currency: Enables informal economies (construction, family budgets, barter)
  • No AI dependency: No hallucinations, no subscriptions to LLMs
  • Emergency-ready: Digital will unlocks only when needed
  • Family-first: Not just personal productivityβ€”family resilience

πŸ“§ Contact Author: khrehankashmiri GitHub: @khrehankashmiri Issues: GitHub Issues

Built with ❀️ for real-world utility

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors