📱 Invisible Life Admin

A comprehensive mobile application designed to manage the invisible mental load of daily life.

Invisible Life Admin is a tracker for the micro-maintenance of your life assets. From appliance upkeep and vehicle servicing to managing digital subscriptions, this app centralizes the background tasks that keep your life running smoothly.

Notably, this application was brought to life entirely through vibe coding—leveraging AI-assisted, natural-language-driven development to rapidly spin up the mobile experience.

✨ Key Features

• Holistic Asset Tracking: Keep tabs on your physical appliances, vehicles, and digital subscriptions in a single, unified dashboard.
• Micro-Maintenance Alerts: Automated reminders so you never miss a water filter change, oil check, or subscription cancellation window.
• Vibe-Coded Frontend: The mobile interface was generated dynamically through iterative AI prompting, proving out a rapid-prototyping development paradigm.
• Robust Backend Core: Under the hood, the system is supported by a lightweight Python and FastAPI architecture, fully containerized with Docker to make deployment to a dedicated VPS completely frictionless.

🛠 Tech Stack

• Development Paradigm: Vibe Coding 🌊💻 (AI-generated architecture and UI)
• Frontend: Mobile Framework (AI-Assisted Expo React Native)
• Backend: Node.js/Express (API) & Python, FastAPI (AI Server)
• Database: PostgreSQL via Drizzle ORM
• Infrastructure: Docker & pnpm Workspaces

How to Run on Windows

To run the whole application locally on Windows as a mobile app, follow these steps:

1. Prerequisites

• Node.js: Install Node.js (version 24 or LTS).
• pnpm: Install pnpm globally (npm install -g pnpm).
• Python: Install Python 3.11+.
• Tesseract OCR: Download and install Tesseract OCR for Windows. Ensure its installation directory is added to your Windows system PATH.
• Database: Have a PostgreSQL database ready (e.g., Neon DB or a local Postgres instance).
• Expo Go / Emulator: Download the "Expo Go" app on your iOS/Android phone, or install Android Studio and set up an Android Emulator on your PC.

2. Environment Setup

1. Open your terminal in the root directory.
2. Run pnpm install to install all dependencies across the monorepo.
3. Set up your environment variables. You'll need to create a .env file or export these in your terminal (used primarily by the API Server and DB):
   • NEON_DATABASE_URL: Your PostgreSQL connection string.
   • AES_SECRET_KEY: A 64-character hex string (32-byte key) for encryption.
   • EXPO_PUBLIC_DOMAIN: Your local IP address and API port (e.g., 192.168.1.100:3000) so the mobile app can reach the backend.

3. Initialize Database

Push the database schema to your PostgreSQL instance:

pnpm --filter @workspace/db run push-force

4. Build and Start the Backend Services

The backend consists of the Node.js API server, which automatically spawns the Python AI service.

1. Build the shared packages:

   pnpm run build

2. Start the API Server (which will also start the AI server on port 8000):

   pnpm --filter @workspace/api-server run dev

5. Start the Mobile App

1. Open a new terminal and navigate to the mobile app directory:

   cd artifacts/mobile

2. Start the Expo development server:

   npx expo start

3. A QR code will appear in your terminal.
   • To run on a physical device: Ensure your phone and PC are on the same Wi-Fi network. Scan the QR code using the Expo Go app.
   • To run on an emulator: Press a in the terminal to launch the app on your running Android Emulator.