Mira

A personal wellness app for tracking daily mood, journaling, and gaining insights into mental patterns over time.

Structure

mira/
├── mira-api/     # Go REST API (GoFr framework + PostgreSQL)
├── mira-ui/      # React frontend (Vite + TanStack Router + shadcn/ui)
└── docker-compose.yml

Quick Start

Prerequisites: Docker and Docker Compose

cp .env.example .env
docker compose up --build

The UI is available at http://localhost (port 80 by default).

Configuration

Copy .env.example to .env and adjust as needed:

Variable	Default	Description
DB_USER	postgres	PostgreSQL username
DB_PASSWORD	postgres	PostgreSQL password
DB_NAME	mira	PostgreSQL database name
PORT	80	Host port for the UI

API Endpoints

Method	Path	Description
GET	/api/v1/entries	List journal entries
GET	/api/v1/entries/{id}	Get a single entry
POST	/api/v1/entries	Create a journal entry
DELETE	/api/v1/entries/{id}	Delete a journal entry
GET	/api/v1/insights	Get mood insights
GET	/api/v1/preferences	Get user preferences
PUT	/api/v1/preferences	Update user preferences

Development

See mira-api/ and mira-ui/ for service-specific setup and development instructions.