Meditation Tracker

A Streamlit prototype for timing and tracking meditation sessions. This milestone introduces a fully interactive timer, post-session reflections, and local SQLite persistence.

Getting Started

python -m venv .venv
.venv\Scripts\activate  # Windows
pip install -r requirements.txt
streamlit run app.py

Sessions are stored in data/meditation_tracker.db; delete the file to reset history.

Project Structure

• app.py - Streamlit entry point with sidebar navigation.
• components/ - Shared UI elements (timer panel, stats cards).
• pages/ - Page modules such as Session History and Settings.
• services/ - Configuration helpers and (future) persistence/analytics logic.
• docs/ - Requirements and product documentation.
• data/ - Placeholder directory for SQLite database files.
• assets/ - Static resources (e.g., icons, CSS) to be added later.
• tests/ - Lightweight tests ensuring imports continue to work as features grow.

Current Capabilities

• Interactive countdown timer with start/pause/reset controls and metadata capture.
• Post-session reflection form that saves sessions to a local SQLite database.
• Enhanced highlights (streaks, week-over-week deltas, last session quality) plus daily, technique, and quality charts.
• CSV export and one-click deletion controls for managing the local data set.
• Zen-inspired visual theme with soothing palette and typography.

Next Milestones

1. Add personal goals, reminders, and optional notifications to reinforce habits.
2. Introduce guided audio support and richer preset management.
3. Expand automated tests and accessibility audits to cover the growing feature set.