# Eva — Calendar & Daily Planner (Full Documentation)

> This is the extended documentation for Eva, a free iOS daily planner app. For a concise summary, see https://evacalendar.app/llms.txt

## Overview

Eva is a free, privacy-first iOS daily planner for iPhone (iOS 17+) built with native SwiftUI. It has no ads, no tracking, no account requirement, and no third-party dependencies. All data is stored locally on the user's device. Eva is available in 42 languages.

**App Store**: https://apps.apple.com/app/calendar-daily-planner-eva/id6759334860
**Website**: https://evacalendar.app
**Price**: Completely free — no in-app purchases, no subscription, no premium tier.

## Feature Categories

### 1. AI Assistant

Eva includes a built-in AI chat assistant accessible from the day view.

**Photo Recognition**: Users can snap a photo of movie tickets, concert passes, flight boarding passes, restaurant receipts, or any event-related document. Eva's AI extracts event details (title, date, time, venue, seat numbers) and offers to create a calendar entry with reminders automatically.

**Natural Language Queries**: Users can ask questions in plain language:
- "Am I free this weekend?"
- "Move tonight's tasks to Saturday"
- "What should I wear today?" (provides weather-based clothing suggestions)
- "When is my next dentist appointment?"

**Fuzzy Search**: The AI-powered search finds tasks even with typos or partial matches.

### 2. Task Management

**Task Creation**: Tasks can be created via text input, voice input (with NLP parsing), AI assistant, or imported from Apple Calendar/Reminders/ICS files.

**Organization**:
- 12 highlight colors: lemon, peach, coral, rose, mocha, mint, sage, sky, lavender, lilac, aqua (plus default)
- Automatic time-of-day categorization: morning (before 12:00), afternoon (12:00-17:00), evening (after 17:00)
- Task checklists: subtasks within a task with completion tracking
- Photo attachments via TaskImageStore
- Drag & drop reordering within and between time sections

**Calendar Views**:
- Month grid with dots, emoji markers, and task previews per day
- Week cards showing daily summaries
- Day detail with three sub-modes: task list, timeline, checklist
- Year overview calendar

**Multi-day Events**: Tasks spanning multiple days display as continuous bars across the calendar grid.

**Soft Trash**: Deleted tasks are retained for 14 days and can be restored.

### 3. Todo Lists

Separate from the main calendar, Eva offers dedicated todo lists for organizing items by category:
- Create lists for shopping, ideas, goals, travel packing, or any topic
- Each list is independent with its own items
- Confetti animation plays when all items in a list are completed
- Quick inline editing and reordering

### 4. "Last Time" Tracker

A unique feature to track recurring activities without a fixed schedule:
- Record when you last did something: haircut, house cleaning, watering plants, oil change, dentist visit
- Eva displays how many days have passed since each activity
- Helps users maintain personal routines without rigid scheduling

### 5. Focus Timer (Pomodoro)

**Timer Modes**: Configurable work interval, short break, and long break durations. Default Pomodoro preset is 25/5/15 minutes.

**Ambient Sounds** (13 options): rain, thunderstorm, fire/fireplace, waves, ocean, forest, birds, crickets, stream, wind, white noise, gentle rain.

**iOS Integration**:
- Do Not Disturb enables automatically when a focus session starts
- Live Activity displays a real-time countdown timer on the lock screen and Dynamic Island
- Full-screen immersive mode for deep focus

**Statistics**: Total deep work time, session counts, daily/weekly streaks, historical charts.

### 6. Lock Screen Wallpaper Generator

Eva generates personalized lock screen wallpapers that display the user's daily plan.

**Canvas Editor**:
- Background options: solid colors, gradients, photos from camera roll
- Font and text color customization
- Layout options for task display

**Wallpaper Content**:
- Today's tasks with times
- Current weather conditions
- Calendar events
- Motivational quote of the day
- Countdown displays

Users save the generated image and set it as their iPhone lock screen background through iOS Settings.

### 7. Daily Digest (27 Configurable Blocks)

The digest is a personalized morning briefing delivered as a horizontal card stack. Each block can be toggled on/off and reordered.

| # | Block | Description |
|---|-------|-------------|
| 1 | Weather | Temperature, wind speed, humidity, precipitation forecast |
| 2 | Atmospheric Pressure | Barometric pressure + magnetic storm index with health impact notes |
| 3 | Clothing Recommendations | What to wear based on weather, with 81 hand-drawn outfit illustrations |
| 4 | Daylight Duration | Hours of daylight + daily change compared to yesterday |
| 5 | Biorhythms | Productivity, sport performance, creativity, and sleep quality levels |
| 6 | Horoscope | Daily horoscope by zodiac sign covering love, career, and health |
| 7 | Moon Phase | Current moon phase, lunar day, and moon zodiac sign |
| 8 | Mercury Retrograde | Whether Mercury is currently retrograde with start/end dates |
| 9 | Allergy/Pollen | Pollen alerts for 6 allergen types: birch, alder, poplar, grass, ragweed, wormwood |
| 10 | Air Quality | AQI index with outdoor activity recommendations |
| 11 | Namedays | Today's nameday celebrations |
| 12 | Daily Facts | Notable historical events and famous birthdays for today's date |
| 13 | Public Holidays | Country-specific official holidays and days off |
| 14 | Folk Observances | Traditional folk holidays (30 Russian observances) |
| 15 | Coffee Ritual | Thursday cinnamon coffee tradition marker |
| 16 | Affirmation | Positive daily affirmation |
| 17 | Countdown | Days until seasonal events (New Year, summer, etc.) + custom user countdowns |
| 18 | Year Progress | Visual percentage of the year completed |
| 19 | Wallpaper of the Day | Featured daily wallpaper |
| 20 | Memories | "This day in history" — user's tasks and moods from the same date in past years |
| 21 | Task Summary | Overview of today's tasks with completion status |
| 22 | Golden Hour | Sunrise, sunset, and golden hour times for photography |
| 23 | Lifehack | Daily practical tip with user rating |
| 24 | Menstrual Cycle | Current cycle phase (period, follicular, ovulation, luteal, PMS) |
| 25 | Tracked Shows | Upcoming movie and TV show releases the user is tracking |
| 26 | Memory Game | Card-matching brain training game with global leaderboard |
| 27 | Kind Message | A warm daily wish to start the morning positively |

Sleep data from HealthKit is also displayed when available.

### 8. Mood Tracking

- 5-level mood scale: awful, bad, okay, good, great
- Each level has a customizable emoji
- Daily entries with optional free-text notes
- Weekly trend charts showing mood patterns
- Monthly statistics with averages
- Configurable daily check-in reminder notifications
- Mood indicators displayed on calendar days

### 9. Habit Tracking

**Repeat Presets** (13): daily, every 2 days, every 3 days, every 5 days, weekdays, weekly, biweekly, monthly, every 2 months, every 3 months, every 6 months, yearly, custom.

**Features**:
- Custom weekday selection (e.g., Mon/Wed/Fri)
- Habit icon picker with categorized icons
- Completion streak tracking
- Habit statistics
- Dedicated habits list view
- Home screen habit widgets (small and medium)

### 10. Smart Reminders

- **15 notification sounds** including 3 cat meow variations
- **9 snooze options**: 10 minutes, 30 minutes, 1 hour, 2 hours, 3 hours, tomorrow, morning (09:00), afternoon (15:00), evening (20:00)
- Complete tasks directly from iOS notification actions
- Custom time picker for precise snooze
- Reminder types: task reminders, digest daily reminder, mood check-in, period start (1-3 days before), birthday (on day, 1/4/7 days before), show release reminders

### 11. Lifestyle Calendar Markers

Seven types of visual markers displayed on the calendar grid:

1. **Public Holidays**: Country-specific official days off, fetched from Nager.Date API
2. **Beauty Calendar**: 3-month schedule of optimal days for haircuts, manicure, and cosmetology appointments
3. **Mercury Retrograde**: Highlighted periods when Mercury is retrograde
4. **Menstrual Cycle**: Color-coded phases — period, PMS, ovulation, fertile window
5. **Coffee Ritual**: Every Thursday marked as cinnamon coffee day
6. **Namedays**: Daily nameday celebrations
7. **Birthdays**: Multi-day reminders imported from Apple Contacts

Each marker type can be toggled independently with custom highlight colors.

### 12. Menstrual Cycle Tracking

- Configurable: cycle length, period duration, PMS days
- Phase calculation: period, follicular, ovulation, luteal, PMS
- Two-way sync with Apple HealthKit menstrual flow data
- Period start notifications 1-3 days in advance
- Custom emoji for each phase
- Calendar visualization with color-coded phases

### 13. Integrations

| Integration | Direction | Details |
|------------|-----------|---------|
| Apple Calendar | Two-way | Events, birthdays. Full sync with CalendarManager |
| Apple Reminders | Two-way | Import and sync reminders |
| Google Calendar | Two-way | OAuth2 authentication via GoogleAuthService |
| Apple HealthKit | Read | Menstrual flow data + sleep data |
| Core Spotlight | Write | Task search indexing for iOS system search |
| Siri Shortcuts | Execute | Add task, check today's schedule, log mood |
| ICS Import | Read | Parse and import .ics calendar files |

### 14. Widgets

Eva provides 35+ widget views across multiple categories:

**Home Screen Widgets**:
- Small: task list
- Medium: task list with pagination, schedule view, agenda view
- Large: task list, month calendar, "My Day" summary

**Lock Screen Widgets**:
- Upcoming task, pinned task, mini calendar, weather, countdown, AQI, add task button, voice input button

**Special Widgets**:
- Countdown (multiple styles), weather, clothing recommendation, quote of the day, date display, task count, time rings, year progress

**Habit Widgets**: Small and medium habit tracker displays

**Live Activities**: Real-time task timer and focus timer on lock screen and Dynamic Island

### 15. Tracked Shows

- Search and track movies and TV shows (TMDB integration)
- Release date reminders
- Show details with cast, overview, posters in digest

### 16. Shift Work Schedule

- Custom shift types with names, colors, and short labels
- Rotating pattern schedules (e.g., 2 day / 2 night / 4 off)
- Preset patterns: 2/2, 1/3, 24h on/off, and more
- Calendar integration as visual markers
- Shift statistics

### 17. Memories

- "This day in history" — user's tasks and moods from the same date in past years
- Shareable with watermark overlay

## Privacy

- **No account**: Eva never asks users to create an account or sign in
- **Local storage**: All data stored on-device
- **No analytics**: No analytics SDKs, no third-party trackers
- **No ads**: No ad networks, no sponsored content
- **Apple frameworks only**: EventKit, HealthKit, WeatherKit, WidgetKit, Core Spotlight

## Technical

- **Platform**: iOS 17+ (iPhone only)
- **Built with**: Native SwiftUI, zero third-party dependencies
- **Languages**: 42

## Comparisons

### Eva vs Apple Calendar
Eva syncs bidirectionally with Apple Calendar but adds: AI assistant, 27-block daily digest, mood tracking, habit tracking, todo lists, lifestyle calendar markers (mercury retrograde, beauty days, cycle), focus timer, and lock screen wallpapers.

### Eva vs Google Calendar
Eva offers Google Calendar sync via OAuth2. Unique Eva features: AI assistant with photo recognition, daily digest, mood/habit tracking, lifestyle markers, focus timer, wallpaper generator, todo lists.

### Eva vs Todoist / Things 3
Eva is 100% free with no premium tier. It combines task management with lifestyle intelligence (digest, mood, biorhythms, mercury retrograde) that pure task managers lack. Eva focuses on daily planning rather than project management.

### Eva vs Structured / Sorted
Eva offers more lifestyle features (digest, mood, beauty calendar, cycle tracking) while maintaining a clean daily planner interface. Eva is free; Structured and Sorted have premium plans.

## Blog & Guides

### Best Free Pomodoro Timer for iPhone
Eva's built-in Pomodoro timer compared to Forest ($3.99), Tide ($59.99/year), and Focus Keeper ($2.99). Eva includes 13 ambient sounds (rain, thunder, fireplace, waves, ocean, forest, birds, crickets, stream, wind, white noise, gentle rain), Live Activity on the lock screen, automatic Do Not Disturb via iOS Shortcuts, session statistics with streak tracking, Apple Health Mindful Minutes integration, and 4 presets (Classic 25/5/15, Deep Work 50/10/20, Sprint 15/3/10, Marathon 90/15/30). All features are free with no subscription.

Full guide: https://evacalendar.app/blog/en/best-free-pomodoro-timer-iphone/

### How to Put Your Daily Plan on iPhone Lock Screen
Eva's wallpaper generator creates a lock screen wallpaper from your daily plan. The wallpaper can include: today's tasks (organized by morning/afternoon/evening), weekly calendar, weather, motivational quotes, holidays, countdowns, habits, and birthdays. Everything is customizable — toggle blocks, reorder, change fonts/colors/backgrounds.

**Setup**: Open Eva → add tasks → Settings → Task Wallpaper → customize in the canvas editor → save to Photos → apply as lock screen in iOS Settings.

**Auto-update**: Install the "Set Task Wallpaper Eva" iOS Shortcut. Set up automation in iOS Shortcuts app: trigger "When Eva is closed" with "Run Immediately" — wallpaper updates every time you leave the app. Alternatively, set a morning time trigger (e.g. 7:00 AM) for a fresh wallpaper each day. Both triggers can be combined.

Full guide: https://evacalendar.app/blog/en/how-to-put-your-daily-plan-on-iphone-lock-screen/

### What the Moon Actually Does to Your Body — Science, Not Astrology
7 lunar myths checked against peer-reviewed studies. The full moon has a small but real effect on sleep (5 minutes longer to fall asleep, 20 minutes less total sleep — Basel 2013 study). The menstrual cycle's similarity to the lunar cycle (29.5 vs ~28 days) shows some synchronization in women with minimal artificial light, but is mostly coincidental in modern life. No evidence supports full moon effects on mood, psychiatric admissions, birth rates (tested on 70 million births), or crime rates. Animal behavior is genuinely affected — coral spawning, owl hunting patterns — but via moonlight levels, not gravitational effects. The moon's pull on a human body is 0.00003% of Earth's gravity. Eva tracks moon phases, lunar days, and moon zodiac signs in the daily digest.

Full guide: https://evacalendar.app/blog/en/what-the-moon-does-to-your-body/

## Contact & Support

- **Developer**: Biser Probirov
- **Email**: probiserov@gmail.com
- **Website**: https://evacalendar.app
- **In-app feedback**: Settings → "Ask a question" (sends to developer via Telegram bot)
- **App Store**: https://apps.apple.com/app/calendar-daily-planner-eva/id6759334860