Auren

One app to manage your life.

Table of Contents

• Architecture
• Features
• Vision
• Setup
• Project Structure
• Roadmap

Architecture

Auren's frontend is built with SwiftUI and communicates with a FastAPI backend through a REST API. The backend handles the business logic (users, accounts, transactions) and persists data in a PostgreSQL database. The backend is fully containerized with Docker, with a clear separation between development and production environments.

Features

Status	Feature
✅	User authentication
✅	Account management (create, view accounts)
✅	Budget/finance tracking module
✅	Security audit logs (transactions, failed logins, etc.)
🔜	Transaction creation from the app
🔜	Todo list module
🔜	Production environment (self-hosted, dev/prod separation)
🔜	Full documentation (module docs, API reference, architecture diagram)

Vision

Auren aims to grow into a complete life-management app, organized around several modules:

📊 Dashboard Expense overview Sleep & mood graphs 💰 Expense Tracking Account creation Transaction creation Tags (friends, group, work, food, etc.) ✅ Todo Project creation Add people to a project Task creation Tags per project

📅 Agenda Reminders 😴 Mood & Sleep Module to log mood and sleep 👥 Contacts Create relationships Track last contact & contact frequency Type field (friend, close, family) Time-since-last-contact indicator Link with money spent

This is the long-term vision — see Roadmap for what's actively being worked on.

Setup

⚠️ Detailed setup instructions coming soon.

Backend

cd Backend
docker-compose up

Frontend

Open the project in Xcode and run on a simulator or device.

Project Structure

Auren/
├── backend/                # FastAPI backend
│   ├── alembic/            # Database migrations
│   ├── app/
│   │   ├── core/           # Core config, settings
│   │   ├── modules/        # Business logic modules
│   │   ├── shared/         # Shared utilities
│   │   └── main.py         # App entry point
│   ├── test/                # Backend tests
│   └── docker-compose.yml
├── docker/                 # Docker-related assets
├── docs/                   # Project documentation
├── ios/
│   └── Auren/               # SwiftUI frontend
└── readme.md

Roadmap

• User authentication
• Account management module
• Security audit logs
• Transaction creation from the app
• Production environment (self-hosted on dedicated hardware)
• Dev/prod environment separation
• Todo list module
• Full project documentation (module docs, API reference, architecture diagram)

Made by Tisa_48