Skip to content
BranchesTags

Repository files navigation

Personal Hub

A modern, premium command center for your digital life.

Personal Hub is a cross-platform, AI-powered productivity suite designed for individuals who demand a fast, beautiful, and fully-featured digital workspace. Built in 2026, it merges aesthetics (brutalist UI) and functionality to offer an unparalleled user experience, running seamlessly on Android, Desktop (Linux/Windows/macOS), and the Web.

Key Features

  • Brutalist, Premium UI: A stunning, high-contrast edge-to-edge visual design (oklch colors) built with Tailwind CSS 4, offering fluid micro-animations (Framer Motion) and deep customizability.
  • AI Schedule Assistant (Powered by Gemini): Automatically build an optimized daily schedule around your classes, to-do lists, and weekly goals with one click.
  • AI Receipt & Timetable Scanner: Upload a photo of your schedule or a receipt and Gemini automatically parses the data to organize your life.
  • Advanced Financial Tracking: Visualize your income and expenses effortlessly using beautiful Recharts diagrams and manage data smoothly with intelligent case-insensitive categorization. Get intelligent summaries of your spending habits with the AI Advisor.
  • PDF & Excel Exports: Generate and download/share detailed financial reports in standard PDF or Excel formats with a single click.
  • Goals & Habits Tracking: Set, monitor, and crush your daily habits and monthly goals with intuitive progress indicators.
  • Real-Time Sync: Never lose your data. Firebase Realtime Database synchronizes your habits, tasks, finances, and goals instantly across all your devices.
  • Secure Authentication: Safe, reliable email/password authentication via Firebase Auth to protect your private data, with robust cross-session data wiping to prevent leakage.
  • Automated Workflow Monitoring: Built-in CronKeeper GitHub Actions workflow automatically tracks scheduled background tasks and sends Slack alerts if runs fail or miss their window.

Tech Stack

Personal Hub is engineered with cutting-edge tools to maximize performance and cross-platform reach.

  • Frontend: React 19, TypeScript, Vite
  • Styling: Tailwind CSS 4, Framer Motion, Lucide React
  • State Management: Zustand (with local persistence & safe cross-account boundaries)
  • Backend & Sync: Firebase (Auth & Realtime Database)
  • AI Integration: Google GenAI (Gemini 3.1 Flash)
  • Mobile Build: Capacitor (Android/iOS)
  • Desktop Build: Electron & Capacitor-Community Electron (Windows/macOS/Linux)
  • CI/CD: GitHub Actions (Automated multi-platform releases)

Architecture & Pipeline

How It Works (Simple Explanation)

Personal Hub is designed to work everywhere you do. Here is a simple breakdown of how the different pieces fit together:

  1. The Apps (Frontend): You can use the app on the Web, on your Android phone, or as a Desktop app. They are built to share the exact same code and design.
  2. The Memory (State Management): When you do something in the app (like adding a task), it gets saved in a local memory bank immediately (Zustand LocalStorage). This makes the app feel incredibly fast because it doesn't have to wait for the internet.
  3. The Brain (AI Integration): When you need a schedule made or a timetable scanned, the app securely sends that request to Google's Gemini AI, which acts as the smart brain to organize your life.
  4. The Cloud (Backend Services): To make sure your phone and laptop have the exact same data, the app securely backs up your memory to a real-time Cloud Database. It also talks to Google Calendar to automatically add your classes to your schedule!
  5. The Factory (CI/CD Pipeline): Every time new code is tagged, GitHub Actions spins up automated servers to build, package, and release the Desktop installers (.exe, .deb, .AppImage) and Android APKs.
graph TD
    %% Frontend Apps
    Web[Web App]
    Android[Android App]
    Desktop[Desktop App]

    %% Memory
    Zustand[Local App Memory]

    %% Backend
    FirebaseDB[(Cloud Database)]
    FirebaseAuth{Secure Login}
    GoogleCalendar[Google Calendar]

    %% AI
    Gemini((Gemini AI Brain))

    %% Connections
    Web --> Zustand
    Android --> Zustand
    Desktop --> Zustand

    Zustand <--> FirebaseDB
    
    Web --> FirebaseAuth
    Android --> FirebaseAuth
    Desktop --> FirebaseAuth

    Web --> GoogleCalendar
    Android --> GoogleCalendar
    Desktop --> GoogleCalendar

    Web --> Gemini
    Android --> Gemini
    Desktop --> Gemini
Loading

Detailed Architecture (With Technologies)

flowchart TB
    subgraph Clients["Client Applications (React 19 + TypeScript + Vite)"]
        Web[" Web Browser<br/>(Vite PWA)"]
        Android[" Android App<br/>(Capacitor)"]
        Desktop[" Desktop App<br/>(Electron)"]
    end

    subgraph State["Frontend State Management"]
        Zustand[" Local State<br/>(Zustand + Persist)"]
        Styling[" UI & Styling<br/>(Tailwind CSS 4, Motion, Lucide)"]
    end

    subgraph Backend["Cloud & Authentication"]
        Auth[" Authentication<br/>(Firebase Auth)"]
        DB[" Realtime Sync<br/>(Firebase Realtime DB)"]
    end

    subgraph ThirdParty["External APIs & AI"]
        Gemini[" AI Processing<br/>(Google Gemini API)"]
        GCal[" Calendar Sync<br/>(Google Calendar API)"]
    end

    subgraph Pipeline["CI/CD Pipeline (GitHub Actions)"]
        GH[" Automated Releases<br/>(APK, EXE, DEB, AppImage)"]
    end

    %% Client routing to state
    Web -->|Renders UI| Styling
    Android -->|Renders UI| Styling
    Desktop -->|Renders UI| Styling

    Styling <-->|Reads/Writes| Zustand

    %% State and direct client API connections
    Zustand <-->|Syncs Data| DB
    Clients -->|Login/Tokens| Auth

    Zustand -->|Schedule Gen/Parsing| Gemini
    Zustand -->|Push Classes| GCal
    
    GH -.->|Builds| Clients

    classDef client fill:#3b82f6,stroke:#1d4ed8,stroke-width:2px,color:#fff;
    classDef state fill:#8b5cf6,stroke:#6d28d9,stroke-width:2px,color:#fff;
    classDef cloud fill:#f59e0b,stroke:#b45309,stroke-width:2px,color:#fff;
    classDef api fill:#10b981,stroke:#047857,stroke-width:2px,color:#fff;
    classDef ci fill:#ef4444,stroke:#b91c1c,stroke-width:2px,color:#fff;

    class Web,Android,Desktop client;
    class Zustand,Styling state;
    class Auth,DB cloud;
    class Gemini,GCal api;
    class GH ci;
Loading

Getting Started

1. Prerequisites

  • Node.js (v18+)
  • A Gemini API Key (You can configure this inside the app's Settings page!)
  • Firebase Project configured (with Realtime Database and Auth enabled).

2. Installation

# Clone the repository
git clone https://github.com/your-username/personal-hub.git
cd personal-hub

# Install all dependencies
npm install

3. Running Locally (Web)

npm run dev

4. Building for Windows (Desktop)

Personal Hub supports Windows via Electron, packaging into a native .exe installer.

Prerequisites:

  • Windows 10 or later
  • Node.js v18+
npm run build:windows

Your compiled .exe installer will be in the electron/dist/ folder. You can install it directly — no need to uninstall a previous version.

5. Building for Linux (Desktop)

Personal Hub fully supports Linux, producing both an AppImage (portable, no install needed) and a .deb package (for Debian/Ubuntu-based systems).

Prerequisites:

  • Linux (Ubuntu 20.04+ / Debian 11+ recommended)
  • Node.js v18+
  • fakeroot and dpkg (for .deb builds): sudo apt install fakeroot dpkg
npm run build:linux

Output files in electron/dist/:

Format File Use case
.AppImage Personal-Hub-x.x.x.AppImage Portable — runs on any Linux distro, no install
.deb personal-hub_x.x.x_amd64.deb Debian/Ubuntu install via dpkg -i

Running the AppImage:

chmod +x Personal-Hub-*.AppImage
./Personal-Hub-*.AppImage

Installing the .deb package:

sudo dpkg -i personal-hub_*.deb
# If dependencies are missing:
sudo apt-get install -f

Note

The AppImage is the easiest option — just download and run it. No installation required and it works on virtually all modern Linux distributions.

6. Building for Android

npm run build:android
npx cap open android

(Requires Android Studio. Build the APK or AAB from within Android Studio.)

Configuration

Say goodbye to messy .env files. Personal Hub features a built-in Settings page! Simply navigate to the Settings tab within the app to:

  • Enter and securely save your Gemini API Key.
  • Set your Profile Name and Codeforces Handle.
  • Toggle high-performance Animations on or off.

License

This project is licensed under the MIT License — see the LICENSE file for details.

Support the Project

If Personal Hub makes your life even a little bit more organized, the best way to show support is to star this repository! It takes one second and genuinely means a lot.

Star this repo

Click here to star Personal Hub on GitHub — it helps the project grow and reach more people!

Reporting Issues

Found a bug? Have a feature request? I'd love to hear from you!

Before opening an issue, please:

  1. Check if the issue already exists in the issue tracker.
  2. Make sure you are on the latest release.

To report a bug, open a new issue and include:

  • A clear title describing the problem
  • Steps to reproduce it
  • What you expected to happen vs. what actually happened
  • Your platform (Web / Android / Desktop) and OS version
  • Screenshots or screen recordings if possible

For feature requests, open an issue with the label enhancement and describe what you'd like to see added and why it would be useful.

Contributing

Contributions are welcome! If you'd like to fix a bug or add a feature:

  1. Fork the repository
  2. Create a new branch: git checkout -b feature/your-feature-name
  3. Make your changes and commit: git commit -m "Add: your feature description"
  4. Push to your fork: git push origin feature/your-feature-name
  5. Open a Pull Request against the main branch

Please keep PRs focused and well-described. Large changes should be discussed in an issue first.

Developed by Mansoju Vivekananda Mail at Email

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

4 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages