Testing Guide

Comprehensive unit and state tests for models, services, and state management.

Running Tests

# Run all tests
flutter test

# Run with verbose output
flutter test --reporter expanded

# Run specific test file
flutter test test/models/event_model_test.dart

# Run with coverage
flutter test --coverage
lcov -r coverage/lcov.info 'lib/views/*' -o coverage/filtered.info
genhtml coverage/filtered.info -o coverage/html
    

Test Structure

The test suite contains 110+ test files organized into five categories, covering services, models, state management, views, and utilities.

test/
├── core/                              # Core service tests (35 files)
│   ├── services/                      # Nested service tests
│   │   ├── event_sharing_service_test.dart
│   │   ├── free_slot_finder_test.dart
│   │   └── meal_tracker_service_test.dart
│   ├── achievement_service_test.dart
│   ├── agenda_digest_service_test.dart
│   ├── conflict_detector_test.dart
│   ├── correlation_analyzer_service_test.dart
│   ├── daily_review_service_test.dart
│   ├── daily_timeline_service_test.dart
│   ├── date_utils_test.dart
│   ├── decision_journal_service_test.dart
│   ├── dependency_tracker_test.dart
│   ├── eisenhower_matrix_service_test.dart
│   ├── energy_tracker_service_test.dart
│   ├── event_deduplication_service_test.dart
│   ├── event_pattern_service_test.dart
│   ├── event_search_service_test.dart
│   ├── event_service_test.dart
│   ├── focus_time_service_test.dart
│   ├── free_slot_finder_test.dart
│   ├── gratitude_journal_service_test.dart
│   ├── heatmap_service_test.dart
│   ├── ics_export_service_test.dart
│   ├── meditation_tracker_service_test.dart
│   ├── productivity_score_service_test.dart
│   ├── reading_list_service_test.dart
│   ├── routine_builder_service_test.dart
│   ├── screen_time_tracker_service_test.dart
│   ├── snooze_service_test.dart
│   ├── streak_tracker_test.dart
│   ├── template_service_test.dart
│   ├── time_audit_service_test.dart
│   ├── time_budget_service_test.dart
│   ├── travel_time_estimator_test.dart
│   ├── water_tracker_service_test.dart
│   ├── weekly_planner_service_test.dart
│   ├── weekly_report_service_test.dart
│   └── workout_tracker_service_test.dart
├── models/                            # Model tests (16 files)
│   ├── datetime_corruption_test.dart
│   ├── event_attachment_test.dart
│   ├── event_checklist_test.dart
│   ├── event_location_test.dart
│   ├── event_model_recurrence_test.dart
│   ├── event_model_tags_test.dart
│   ├── event_model_test.dart
│   ├── event_tag_test.dart
│   ├── event_template_test.dart
│   ├── goal_test.dart
│   ├── mood_entry_test.dart
│   ├── recurrence_rule_test.dart
│   ├── reminder_settings_test.dart
│   ├── sleep_entry_test.dart
│   ├── sleep_tracker_test.dart
│   └── user_model_test.dart
├── state/                             # State management tests (3 files)
│   ├── event_bloc_test.dart
│   ├── event_provider_test.dart
│   └── user_provider_test.dart
├── views/                             # Widget tests (7 files)
│   ├── home/
│   │   ├── parking_spot_screen_test.dart
│   │   └── weekly_planner_screen_test.dart
│   ├── calendar_screen_test.dart
│   ├── countdown_screen_test.dart
│   ├── focus_time_screen_test.dart
│   ├── routine_builder_screen_test.dart
│   └── screen_time_tracker_screen_test.dart
└── *.dart                             # Feature service tests (50+ files)
    ├── blood_sugar_test.dart
    ├── budget_planner_test.dart
    ├── habit_tracker_test.dart
    ├── kanban_board_service_test.dart
    ├── medication_tracker_test.dart
    ├── pomodoro_service_test.dart
    └── ... (and 44 more)

Test Categories

Model Tests 16 files

Verify serialization round-trips, value equality, and domain logic:

EventModel — fromJson/toJson round-trip, copyWith (including clearRecurrence), == and hashCode, default values
EventTag — Case-insensitive equality, color palette bounds clamping, preset validation
RecurrenceRule — Occurrence generation for all frequencies, month clamping (Jan 31 + 1mo = Feb 28), end date cutoff, summary formatting, JSON string round-trip
EventAttachment / EventChecklist / EventLocation — Serialization and equality for event sub-models
EventTemplate — Template creation, preset defaults
ReminderSettings — Notification scheduling logic
SleepEntry / MoodEntry / Goal — Domain model serialization and validation
DatetimeCorruption — Edge cases: timezone transitions, DST boundaries, epoch edge values

// Example: RecurrenceRule month clamping test
test('monthly recurrence clamps day to valid range', () {
  final rule = RecurrenceRule(
    frequency: RecurrenceFrequency.monthly,
  );
  final start = DateTime(2026, 1, 31); // Jan 31
  final dates = rule.generateOccurrences(start, maxOccurrences: 3);
  
  expect(dates[1].day, 28); // Feb 28 (not 31!)
  expect(dates[2].day, 31); // Mar 31
});
    

Core Service Tests 35 files

Verify coordination between state and persistence across the core service layer:

EventService — add/update/delete coordination, load-once guard (doesn't overwrite non-empty provider), persistence error handling (logged, not thrown)
Calendar & Scheduling — ConflictDetector, FreeSlotFinder, DailyTimeline, SnoozeService, TravelTimeEstimator, WeeklyPlanner
Analytics & Insights — CorrelationAnalyzer, EventPattern, EventSearch, EventDeduplication, HeatmapService, ProductivityScore, StreakTracker
Wellness — MeditationTracker, WaterTracker, WorkoutTracker, EnergyTracker, ScreenTimeTracker
Journaling & Review — DailyReview, DecisionJournal, GratitudeJournal, WeeklyReport, TimeAudit, TimeBudget
Import/Export — IcsExport, EventSharing, TemplateService
Utilities — DateUtils (month arithmetic, week boundaries), AchievementService, DependencyTracker

Feature Service Tests 50+ files

Each of the 100+ features has service-level tests covering CRUD operations, business rules, and edge cases:

Finance — BudgetPlanner, DebtPayoff, ExpenseTracker, SavingsGoal, NetWorthTracker, SubscriptionTracker
Health — BloodSugar, MedicationTracker, SleepTracker, MoodEntry, EnergyTracker
Productivity — PomodoroService, KanbanBoard, HabitTracker, GoalTracker, TimeTracker, SkillTracker
Lifestyle — RecipeBook, GroceryList, PlantCare, PetCareTracker, HomeInventory, VehicleMaintenance
Misc — CommandPalette, RandomDecision, QuickCapture, LoyaltyTracker, WarrantyTracker, Watchlist

State Tests 3 files

Verify reactive state management behavior:

EventProvider — O(1) getEventById, removeEvent index rebuild, UnmodifiableListView enforcement, notifyListeners calls
EventBloc — State machine transitions (EventInitial → EventLoaded), no-op behavior in wrong state, list immutability between emissions
UserProvider — User session lifecycle, authentication state management

View Tests 7 files

Widget-level integration tests for key screens:

CalendarScreen — Month navigation, event display, interaction
FocusTimeScreen — Timer UI, session start/stop
WeeklyPlannerScreen — Week layout, drag-and-drop
RoutineBuilderScreen — Step creation, reordering
CountdownScreen, ParkingSpotScreen, ScreenTimeTrackerScreen

Coverage

Coverage is tracked via Codecov and runs automatically in CI.

Coverage Strategy The project focuses coverage on models, services, and state — the testable business logic. View tests (widget tests) are encouraged but not mandated, as they require more infrastructure and are harder to maintain.

Writing New Tests

Conventions

One test file per source file, mirroring the lib/ structure
Use descriptive group() blocks for related tests
Test edge cases: empty inputs, null fields, malformed JSON, boundary values
Mock external dependencies (repositories, Firebase) — don't hit real services

Example Pattern

import 'package:flutter_test/flutter_test.dart';
import 'package:everything/models/event_model.dart';

void main() {
  group('EventModel', () {
    test('round-trips through JSON', () {
      final original = EventModel(
        id: '1',
        title: 'Test',
        date: DateTime(2026, 1, 15),
      );
      final json = original.toJson();
      final restored = EventModel.fromJson(json);
      expect(restored, equals(original));
    });
  });
}
    