Artemis combines three proven methodologies into a single workflow:
Eisenhower Matrix — prioritize by urgency & importance (4 quadrants) 1-3-5 Daily Planning — focus on 1 major, 3 medium, 5 small tasks Pomodoro Timer — 25-minute deep work sessions with breaks Analytics Dashboard — track productivity trends with charts Daily Reflection — end-of-day review with journaling and carry-forward
Self-hosted, dark-themed, keyboard-friendly. Built with FastAPI + React + Supabase.
Designed with a "Deep Cozy Luxury" aesthetic — glassmorphism, Playfair Display typography, champagne gold accents on an obsidian background.
| Feature | Description |
|---|---|
| Eisenhower Matrix | 2x2 quadrant grid with color-coded priorities (indigo / cyan / orange / slate) |
| 1-3-5 Daily Planning | 9 task slots with progress tracking, task selector modal, backlog sidebar |
| Pomodoro Timer | Real-time countdown via WebSocket, circular progress ring, task linking, keyboard shortcuts |
| Analytics | Productivity score, Pomodoro trends, task distribution charts, time range selector |
| Dashboard Hub | 3-column layout: daily plan + live timer + matrix overview + stats bar |
| Daily Reflection | 5-star rating, journal prompt, carry-forward incomplete tasks |
| Onboarding | 3-step welcome wizard for first-time users |
| Settings | 5-category preferences with custom glassmorphism controls |
| Mobile Responsive | Bottom navigation, swipeable matrix tabs, floating action button |
| Celebrations | Confetti on task completion, session complete overlay, break mode breathing screen |
Prerequisites: Docker & Docker Compose, Python 3.12+, Supabase account (free tier)
git clone https://github.com/StratosL/Artemis.git
cd Artemis
cp .env.example .env # Add your Supabase credentials
./setup.sh # Linux/Mac (or setup.bat on Windows)
docker-compose up --build| Service | URL |
|---|---|
| Web UI | http://localhost:3000 |
| API Docs | http://localhost:8000/docs |
Having issues? See TROUBLESHOOTING.md
| Layer | Technology |
|---|---|
| Backend | FastAPI · Python 3.12 · Pydantic v2 · Structlog |
| Frontend | React 18 · Vite 5 · TypeScript · Tailwind CSS |
| Design System | Custom "Deep Cozy Luxury" — glassmorphism, Playfair Display + Inter, motion/react |
| State | TanStack Query (server) · Zustand (timer) · WebSocket (real-time) |
| Data Viz | Recharts |
| Animations | motion/react (Framer Motion) · canvas-confetti |
| Database | Supabase (PostgreSQL) |
| Infra | Docker · Docker Compose |
| Quality | Ruff · MyPy · ESLint · pytest (35 tests) |
Architecture: Vertical Slice Architecture — features organized by capability (tasks/, daily_plan/, pomodoro/, analytics/), not by technical layer. See CLAUDE.md for details.
| Route | Page |
|---|---|
/ |
Dashboard (3-column productivity hub) |
/tasks |
Eisenhower Matrix (grid + list views) |
/daily-plan |
1-3-5 Daily Planning |
/pomodoro |
Focus Timer |
/analytics |
Analytics & Insights |
/settings |
Preferences |
/onboarding |
Welcome Wizard |
/reflection |
Daily Reflection |
# Backend
cd backend && uv run pytest -v # Tests
cd backend && uv run ruff check . && uv run mypy app/ # Lint + types
# Frontend
cd frontend && npm run lint && npx tsc --noEmit # Lint + types
cd frontend && npm run build # Production build| Doc | Purpose |
|---|---|
| CLAUDE.md | Architecture, patterns, coding standards |
| PRD.md | Product requirements |
| DEVLOG.md | Development session log |
| DESIGN_SYSTEM.md | Design system tokens, components, patterns |
| IMPLEMENTATION_ROADMAP.md | Design migration record |
| SCREENS_QUICK_REFERENCE.md | Screen inventory and token cheat sheet |
| TROUBLESHOOTING.md | Setup & runtime issues |
Contributions welcome — report bugs, suggest features, or submit PRs.
MIT — see LICENSE for details.
Made with Focus by Stratos Louvaris
Built with Claude Code