⚡ PersonalOS

Your Single Operating System for Work & Life.

Stop switching between Notion, Todoist, Bitwarden, and Google Sheets. Unify your digital life in one modular, database-driven workspace.

Live Demo • Bug Report • Feature Request

---

🚀 The Vision

PersonalOS is a modular, highly configurable, database-driven productivity platform designed to become the single operating system for an individual's professional and personal life.

Rather than hardcoding features, PersonalOS is built on a relationship-first architecture where every workspace, category, and entry is dynamically generated. If you change a client record, your projects, task checklists, documents, secure credentials, and calendar events automatically reflect those associations.

---

✨ Features (P0 Modules)

Module	Description
📊 Dynamic Dashboard	Drag, drop, and configure widgets for your daily tasks, meetings, notes, and quick action logs.
📁 Infinite Workspaces	Organize folders with unlimited nesting and customized tags for dynamic indexing.
✅ Task Engine	Full CRUD with priorities, recurring schedules, subtasks, checklists, and file attachments.
📅 Smart Calendar	Interactive Day/Week/Month planner with drag-and-drop rescheduling.
👥 CRM & Client Hub	Keep track of clients, linked projects, logs, credentials, and meetings in one centralized directory.
📝 Rich Note Editor	Autosaving document creator powered by Tiptap with code block syntax highlighting, check-lists, and nested tables.
🔒 Secure Vault	Keep API keys, passwords, and private environment variables encrypted and secure.
📂 File Storage	Upload and preview files inside workspaces with tag-based organization.

---

🛠 Tech Stack

• Frontend: React 18 (TypeScript), Vite
• Styling: Tailwind CSS (Dark-mode first, premium glassmorphism)
• State Management: Zustand (Application State) + TanStack Query v5 (Server State caching)
• Database & Auth: Supabase (PostgreSQL, Row Level Security, Realtime syncing)
• Forms & Validation: React Hook Form + Zod
• Rich Editor: Tiptap Editor Suite

  Browser (React + Vite + Zustand)
       │
       ▼ (Queries / Actions)
  TanStack Query (Client Cache)
       │
       ▼ (Secure API Calls)
  Supabase Backend (Postgres + Auth + Storage)

---

⚡ Quick Start

1. Clone the repository

git clone https://github.com/Abhishek0964/PersonalOS.git
cd PersonalOS/project

2. Install dependencies

npm install

3. Setup environment variables

Create a .env file in the root of the project directory:

VITE_SUPABASE_URL=your_supabase_project_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_public_key

Warning

Never put your service_role secret key in the .env file as it will trigger security errors in the browser environment. Use only the anon public key.

4. Run the development server

npm run dev

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

---

🌐 Deploy to Vercel

If you're deploying this repository to Vercel:

1. Connect your Github repository to Vercel.
2. Add your environment variables in Vercel's Settings > Environment Variables:
   • VITE_SUPABASE_URL
   • VITE_SUPABASE_ANON_KEY (use your public anon key)
3. Deploy! The routing is preconfigured in vercel.json to handle client-side routes seamlessly.

---

🗺️ Roadmap (P1 Features)

• AI Assistant Integration — Personal semantic search and assistant querying your workspace.
• Workflow Automation Engine — Trigger-Condition-Action builder (e.g., "When task is completed -> Update client progress -> Email invoice").
• Advanced Analytics — Time tracking dashboards, client conversion rates, and productivity heatmaps.
• Offline Sync — Local-first caching to allow full functionality when disconnected, syncing back to Supabase automatically when online.

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

Made with ❤️ by Abhishek Choudhary. Star this repo if you love it! ⭐