LifeOS

A personal operating system for managing life's essential workflows using the PARA method (Projects, Areas, Resources, Archives). Streamline your finances, schedule, cleaning routines, and daily tasks in one organized, actionable system designed for clarity and focus.

Architecture

This project follows Clean Architecture principles with CQRS pattern:

• Backend: Node.js + TypeScript + Express.js
• Frontend: React + TypeScript + Vite + Material-UI
• Pattern: CQRS (Command Query Responsibility Segregation)
• Structure: Atomic Design for components

Getting Started

Prerequisites

• Docker and Docker Compose
• Node.js 18+ (for local development)

Running with Docker

docker-compose up

Services will be available at:

• Frontend: http://localhost:3000
• Backend API: http://localhost:4000
• API Docs: http://localhost:4000/api-docs
• Health Check: http://localhost:4000/health

Local Development

Backend

cd backend
npm install
npm run dev

Frontend

cd frontend
npm install
npm run dev

Project Structure

├── backend/          # Backend API (Node.js + TypeScript)
│   ├── src/
│   │   ├── domain/        # Business entities and rules
│   │   ├── usecases/      # Application business logic (CQRS)
│   │   ├── interface/     # HTTP routes, controllers, DTOs
│   │   ├── infrastructure/# Database, external services
│   │   └── shared/        # Shared utilities
│   └── openapi.yaml      # API specification
├── frontend/         # Frontend app (React + Vite + MUI)
│   └── src/
│       ├── components/    # Atomic design structure
│       ├── theme/         # MUI theme configuration
│       └── routes/        # Routing configuration
├── database/         # Database schemas and migrations
└── agent/            # AI agent workflows

PARA Method Integration

The system organizes information following PARA:

• Projects: Time-bound efforts with specific goals
• Areas: Ongoing responsibilities and standards
• Resources: Topics of ongoing interest
• Archives: Inactive items

License

GNU General Public License v3.0