add filter by network for legs, add full export for traction

assets/logos/pg_logo_v2.svg

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="120"
+   height="120"
+   viewBox="0 0 120 120"
+   version="1.1"
+   id="svg1"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <defs
+     id="defs1" />
+  <g
+     id="layer1">
+    <path
+       style="fill:#00b7fd;stroke-width:4.40315"
+       d="M 42.563242,0 H 92.5 A 27.5,27.5 45 0 1 120,27.5 27.5,27.5 135 0 1 92.5,55 h -50 A 2.5,2.5 45 0 1 40,52.5 v -10 A 2.5,2.5 135 0 1 42.5,40 h 50 A 12.5,12.5 135 0 0 105,27.5 12.5,12.5 45 0 0 92.5,15 l -50,0 A 27.5,27.5 135 0 0 15,42.5 v 50 A 2.5,2.5 135 0 1 12.5,95 H 2.5 A 2.5,2.5 45 0 1 0,92.5 V 42.563242 A 42.563242,42.563242 135 0 1 42.563242,0 Z"
+       id="path1"
+       transform="translate(0,12.5)" />
+    <path
+       style="fill:#999999;stroke-width:4.40315"
+       d="m 42.5,60 h 60 A 17.5,17.5 45 0 1 120,77.5 17.5,17.5 135 0 1 102.5,95 h -60 A 22.5,22.5 45 0 1 20,72.5 v -30 A 22.5,22.5 135 0 1 42.5,20 h 50 a 7.5,7.5 45 0 1 7.5,7.5 7.5,7.5 135 0 1 -7.5,7.5 h -50 A 7.5,7.5 135 0 0 35,42.5 v 30 a 7.5,7.5 45 0 0 7.5,7.5 h 60 A 2.5,2.5 135 0 0 105,77.5 2.5,2.5 45 0 0 102.5,75 h -60 A 2.5,2.5 45 0 1 40,72.5 v -10 A 2.5,2.5 135 0 1 42.5,60 Z"
+       id="path2"
+       transform="translate(0,12.5)" />
+  </g>
+</svg>

lib/components/calculator/calculator.dart

@@ -3,6 +3,7 @@ import 'package:go_router/go_router.dart';
 import 'package:provider/provider.dart';
 import 'package:mileograph_flutter/objects/objects.dart';
 import 'package:mileograph_flutter/services/api_service.dart';
+import 'package:mileograph_flutter/components/widgets/multi_select_filter.dart';
 import 'package:mileograph_flutter/services/data_service.dart';
 import './route_summary_widget.dart';
 
@@ -358,7 +359,7 @@ class _RouteCalculatorState extends State<RouteCalculator> {
             runSpacing: 12,
             crossAxisAlignment: WrapCrossAlignment.center,
             children: [
-              _MultiSelectFilter(
+              MultiSelectFilter(
                 label: 'Countries',
                 options: _countries,
                 selected: _selectedCountries,
@@ -367,7 +368,7 @@ class _RouteCalculatorState extends State<RouteCalculator> {
                   _loadStations();
                 },
               ),
-              _MultiSelectFilter(
+              MultiSelectFilter(
                 label: 'Networks',
                 options: _networks,
                 selected: _selectedNetworks,
@@ -375,6 +376,16 @@ class _RouteCalculatorState extends State<RouteCalculator> {
                   setState(() => _selectedNetworks = vals);
                   _loadStations();
                 },
+                onRefresh: () async {
+                  final data = context.read<DataService>();
+                  await data.fetchStationFilters();
+                  if (!mounted) return;
+                  setState(() {
+                    _networks = data.stationNetworks;
+                    _countries = data.stationCountryNetworks.keys.toList();
+                  });
+                  await _loadStations();
+                },
               ),
               if (_loadingStations)
                 const Padding(
@@ -573,159 +584,3 @@ Widget debugPanel(List<String> stations) {
     ),
   );
 }
-
-class _MultiSelectFilter extends StatefulWidget {
-  const _MultiSelectFilter({
-    required this.label,
-    required this.options,
-    required this.selected,
-    required this.onChanged,
-  });
-
-  final String label;
-  final List<String> options;
-  final List<String> selected;
-  final ValueChanged<List<String>> onChanged;
-
-  @override
-  State<_MultiSelectFilter> createState() => _MultiSelectFilterState();
-}
-
-class _MultiSelectFilterState extends State<_MultiSelectFilter> {
-  late List<String> _tempSelected;
-  String _query = '';
-
-  @override
-  void initState() {
-    super.initState();
-    _tempSelected = List.from(widget.selected);
-  }
-
-  @override
-  void didUpdateWidget(covariant _MultiSelectFilter oldWidget) {
-    super.didUpdateWidget(oldWidget);
-    if (oldWidget.selected != widget.selected) {
-      _tempSelected = List.from(widget.selected);
-    }
-  }
-
-  void _openPicker() async {
-    _tempSelected = List.from(widget.selected);
-    _query = '';
-    await showModalBottomSheet<void>(
-      context: context,
-      isScrollControlled: true,
-      builder: (ctx) {
-        return StatefulBuilder(
-          builder: (ctx, setModalState) {
-            final filtered = widget.options
-                .where((opt) =>
-                    _query.isEmpty || opt.toLowerCase().contains(_query.toLowerCase()))
-                .toList();
-            return SafeArea(
-              child: Padding(
-                padding: const EdgeInsets.all(16.0),
-                child: Column(
-                  mainAxisSize: MainAxisSize.min,
-                  crossAxisAlignment: CrossAxisAlignment.start,
-                  children: [
-                    Row(
-                      children: [
-                        Text(
-                          'Select ${widget.label.toLowerCase()}',
-                          style: Theme.of(context).textTheme.titleMedium?.copyWith(
-                                fontWeight: FontWeight.w700,
-                              ),
-                        ),
-                        const Spacer(),
-                        TextButton(
-                          onPressed: () {
-                            setModalState(() {
-                              _tempSelected.clear();
-                            });
-                            Navigator.of(ctx).pop();
-                            widget.onChanged(const []);
-                          },
-                          child: const Text('Clear'),
-                        ),
-                      ],
-                    ),
-                    const SizedBox(height: 8),
-                    TextField(
-                      decoration: const InputDecoration(
-                        labelText: 'Search',
-                        border: OutlineInputBorder(),
-                      ),
-                      onChanged: (val) {
-                        setModalState(() {
-                          _query = val;
-                        });
-                      },
-                    ),
-                    const SizedBox(height: 12),
-                    SizedBox(
-                      height: 320,
-                      child: ListView.builder(
-                        itemCount: filtered.length,
-                        itemBuilder: (_, index) {
-                          final option = filtered[index];
-                          final selected = _tempSelected.contains(option);
-                          return CheckboxListTile(
-                            value: selected,
-                            title: Text(option),
-                            onChanged: (val) {
-                              setModalState(() {
-                                if (val == true) {
-                                  if (!_tempSelected.contains(option)) {
-                                    _tempSelected.add(option);
-                                  }
-                                } else {
-                                  _tempSelected.removeWhere((e) => e == option);
-                                }
-                              });
-                              widget.onChanged(List.from(_tempSelected.toSet()));
-                            },
-                          );
-                        },
-                      ),
-                    ),
-                    const SizedBox(height: 12),
-                    Align(
-                      alignment: Alignment.centerRight,
-                      child: FilledButton.icon(
-                        onPressed: () {
-                          widget.onChanged(List.from(_tempSelected.toSet()));
-                          Navigator.of(ctx).pop();
-                        },
-                        icon: const Icon(Icons.check),
-                        label: const Text('Apply'),
-                      ),
-                    ),
-                  ],
-                ),
-              ),
-            );
-          },
-        );
-      },
-    );
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    final hasSelection = widget.selected.isNotEmpty;
-    final display =
-        hasSelection ? widget.selected.join(', ') : 'Any ${widget.label.toLowerCase()}';
-    return OutlinedButton.icon(
-      onPressed: _openPicker,
-      icon: const Icon(Icons.filter_alt),
-      label: SizedBox(
-        width: 180,
-        child: Text(
-          '${widget.label}: $display',
-          overflow: TextOverflow.ellipsis,
-        ),
-      ),
-    );
-  }
-}

lib/components/login/login.dart

@@ -1,4 +1,6 @@
 import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_svg/flutter_svg.dart';
 import 'package:go_router/go_router.dart';
 import 'package:mileograph_flutter/services/authservice.dart';
 import 'package:mileograph_flutter/components/pages/settings.dart';
@@ -41,71 +43,101 @@ class _LoginScreenState extends State<LoginScreen> {
       resizeToAvoidBottomInset: true,
       body: Container(
         color: Theme.of(context).scaffoldBackgroundColor,
-        child: Center(
+        child: SafeArea(
           child: Column(
-            mainAxisAlignment: MainAxisAlignment.center,
             children: [
-              Text.rich(
-                TextSpan(
-                  children: [
-                    TextSpan(
-                      text: "Mile",
-                      style: TextStyle(
-                        color: Theme.of(context).textTheme.bodyLarge?.color,
+              Expanded(
+                child: Center(
+                  child: Column(
+                    mainAxisAlignment: MainAxisAlignment.center,
+                    children: [
+                      LayoutBuilder(
+                        builder: (context, constraints) {
+                          return SizedBox(
+                            width: constraints.maxWidth,
+                            child: FittedBox(
+                              fit: BoxFit.scaleDown,
+                              child: Text.rich(
+                                TextSpan(
+                                  children: [
+                                    TextSpan(
+                                      text: "Mile",
+                                      style: TextStyle(
+                                        color: Theme.of(
+                                          context,
+                                        ).textTheme.bodyLarge?.color,
+                                      ),
+                                    ),
+                                    const TextSpan(
+                                      text: "O",
+                                      style: TextStyle(color: Colors.red),
+                                    ),
+                                    TextSpan(
+                                      text: "graph",
+                                      style: TextStyle(
+                                        color: Theme.of(
+                                          context,
+                                        ).textTheme.bodyLarge?.color,
+                                      ),
+                                    ),
+                                  ],
+                                  style: const TextStyle(
+                                    decoration: TextDecoration.none,
+                                    color: Colors.white,
+                                    fontFamily: "Tomatoes",
+                                    fontSize: 50,
+                                  ),
+                                ),
+                                softWrap: false,
+                                overflow: TextOverflow.visible,
+                              ),
+                            ),
+                          );
+                        },
                       ),
-                    ),
-                    const TextSpan(
-                      text: "O",
-                      style: TextStyle(color: Colors.red),
-                    ),
-                    TextSpan(
-                      text: "graph",
-                      style: TextStyle(
-                        color: Theme.of(context).textTheme.bodyLarge?.color,
-                      ),
-                    ),
-                  ],
-                  style: const TextStyle(
-                    decoration: TextDecoration.none,
-                    color: Colors.white,
-                    fontFamily: "Tomatoes",
-                    fontSize: 50,
+                      const SizedBox(height: 40),
+                      if (_checkingSession) ...[
+                        const SizedBox(height: 12),
+                        Row(
+                          mainAxisAlignment: MainAxisAlignment.center,
+                          children: [
+                            const SizedBox(
+                              height: 24,
+                              width: 24,
+                              child: CircularProgressIndicator(strokeWidth: 2),
+                            ),
+                            const SizedBox(width: 8),
+                            Text(
+                              'Trying to log in',
+                              style: Theme.of(context).textTheme.bodyMedium,
+                            ),
+                          ],
+                        ),
+                      ] else ...[
+                        const SizedBox(height: 10),
+                        const LoginPanel(),
+                        const SizedBox(height: 16),
+                        IconButton(
+                          icon: const Icon(Icons.settings, color: Colors.grey),
+                          tooltip: 'Settings',
+                          onPressed: () {
+                            Navigator.of(context).push(
+                              MaterialPageRoute(
+                                fullscreenDialog: true,
+                                builder: (_) => const SettingsPage(),
+                              ),
+                            );
+                          },
+                        ),
+                      ],
+                    ],
                   ),
                 ),
               ),
-              const SizedBox(height: 50),
-              const LoginPanel(),
-              const SizedBox(height: 16),
-              IconButton(
-                icon: const Icon(Icons.settings, color: Colors.grey),
-                tooltip: 'Settings',
-                onPressed: () {
-                  Navigator.of(context).push(
-                    MaterialPageRoute(
-                      fullscreenDialog: true,
-                      builder: (_) => const SettingsPage(),
-                    ),
-                  );
-                },
+              const Padding(
+                padding: EdgeInsets.only(bottom: 12),
+                child: _LoginLogo(),
               ),
-              if (_checkingSession) ...[
-                const SizedBox(height: 12),
-                Row(
-                  mainAxisAlignment: MainAxisAlignment.center,
-                  children: [
-                    const SizedBox(
-                      height: 24,
-                      width: 24,
-                      child: CircularProgressIndicator(strokeWidth: 2),
-                    ),
-                    const SizedBox(width: 8),
-                    Text(
-                      'Trying to log in',
-                      style: Theme.of(context).textTheme.bodyMedium,
-                    ),
-                  ],
-                ),
-              ],
             ],
           ),
         ),
@@ -114,6 +146,57 @@ class _LoginScreenState extends State<LoginScreen> {
   }
 }
 
+class _LoginLogo extends StatefulWidget {
+  const _LoginLogo();
+
+  @override
+  State<_LoginLogo> createState() => _LoginLogoState();
+}
+
+class _LoginLogoState extends State<_LoginLogo> {
+  late final Future<String> _svgFuture;
+
+  @override
+  void initState() {
+    super.initState();
+    _svgFuture = rootBundle.loadString('assets/logos/pg_logo_v2.svg');
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final accent = Theme.of(context).colorScheme.primary;
+    final grey = const Color(0xFF999999);
+    return SizedBox(
+      height: 42,
+      child: Opacity(
+        opacity: 0.75,
+        child: FutureBuilder<String>(
+          future: _svgFuture,
+          builder: (context, snapshot) {
+            final svg = snapshot.data;
+            if (svg == null) {
+              return const SizedBox.shrink();
+            }
+            final tinted = svg
+                .replaceAll('#00b7fd', _colorToHex(accent))
+                .replaceAll('#999999', _colorToHex(grey));
+            return SvgPicture.string(
+              tinted,
+              fit: BoxFit.contain,
+              semanticsLabel: 'Mileograph logo',
+            );
+          },
+        ),
+      ),
+    );
+  }
+
+  String _colorToHex(Color color) {
+    final hex = color.value.toRadixString(16).padLeft(8, '0');
+    return '#${hex.substring(2)}';
+  }
+}
+
 class LoginPanel extends StatefulWidget {
   const LoginPanel({super.key});
 

lib/components/pages/legs.dart

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:mileograph_flutter/components/legs/leg_card.dart';
+import 'package:mileograph_flutter/components/widgets/multi_select_filter.dart';
 import 'package:mileograph_flutter/objects/objects.dart';
 import 'package:mileograph_flutter/services/data_service.dart';
 import 'package:mileograph_flutter/services/distance_unit_service.dart';
@@ -19,6 +20,9 @@ class _LegsPageState extends State<LegsPage> {
   bool _initialised = false;
   bool _unallocatedOnly = false;
   bool _showMoreFilters = false;
+  bool _loadingNetworks = false;
+  List<String> _availableNetworks = [];
+  List<String> _selectedNetworks = [];
 
   @override
   void didChangeDependencies() {
@@ -26,9 +30,21 @@ class _LegsPageState extends State<LegsPage> {
     if (!_initialised) {
       _initialised = true;
       _refreshLegs();
+      _loadNetworks();
     }
   }
 
+  Future<void> _loadNetworks() async {
+    setState(() => _loadingNetworks = true);
+    final data = context.read<DataService>();
+    await data.fetchStationNetworks();
+    if (!mounted) return;
+    setState(() {
+      _availableNetworks = data.stationNetworks;
+      _loadingNetworks = false;
+    });
+  }
+
   Future<void> _refreshLegs() async {
     final data = context.read<DataService>();
     await data.fetchLegs(
@@ -36,6 +52,7 @@ class _LegsPageState extends State<LegsPage> {
       dateRangeStart: _formatDate(_startDate),
       dateRangeEnd: _formatDate(_endDate),
       unallocatedOnly: _unallocatedOnly,
+      networkFilter: _selectedNetworks,
     );
   }
 
@@ -48,6 +65,7 @@ class _LegsPageState extends State<LegsPage> {
       offset: data.legs.length,
       append: true,
       unallocatedOnly: _unallocatedOnly,
+      networkFilter: _selectedNetworks,
     );
   }
 
@@ -90,6 +108,7 @@ class _LegsPageState extends State<LegsPage> {
       _sortDirection = 0;
       _unallocatedOnly = false;
       _showMoreFilters = false;
+      _selectedNetworks = [];
     });
     _refreshLegs();
   }
@@ -209,6 +228,16 @@ class _LegsPageState extends State<LegsPage> {
                         spacing: 12,
                         runSpacing: 12,
                         children: [
+                          MultiSelectFilter(
+                            label: 'Networks',
+                            options: _availableNetworks,
+                            selected: _selectedNetworks,
+                            onChanged: (vals) async {
+                              setState(() => _selectedNetworks = vals);
+                              await _refreshLegs();
+                            },
+                            onRefresh: _loadingNetworks ? null : _loadNetworks,
+                          ),
                           FilterChip(
                             avatar: const Icon(Icons.flash_off),
                             label: const Text('Unallocated only'),
@@ -218,6 +247,15 @@ class _LegsPageState extends State<LegsPage> {
                               await _refreshLegs();
                             },
                           ),
+                          if (_loadingNetworks)
+                            const Padding(
+                              padding: EdgeInsets.only(left: 8.0),
+                              child: SizedBox(
+                                height: 20,
+                                width: 20,
+                                child: CircularProgressIndicator(strokeWidth: 2),
+                              ),
+                            ),
                         ],
                       ),
                     ),

lib/components/pages/traction/traction.dart

@@ -1,13 +1,17 @@
 import 'dart:async';
 import 'dart:convert';
+import 'dart:typed_data';
 
+import 'package:file_selector/file_selector.dart';
 import 'package:flutter/material.dart';
 import 'package:go_router/go_router.dart';
 import 'package:mileograph_flutter/components/traction/traction_card.dart';
 import 'package:mileograph_flutter/objects/objects.dart';
+import 'package:mileograph_flutter/services/api_service.dart';
 import 'package:mileograph_flutter/services/data_service.dart';
 import 'package:mileograph_flutter/services/distance_unit_service.dart';
 import 'package:mileograph_flutter/services/authservice.dart';
+import 'package:mileograph_flutter/utils/download_helper.dart';
 import 'package:provider/provider.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 

lib/components/pages/traction/traction_page.dart

@@ -1,10 +1,12 @@
 part of 'traction.dart';
 
 enum _TractionMoreAction {
+  exportResults,
   classStats,
   classLeaderboard,
   adminPending,
   adminPendingChanges,
+  adminImport,
 }
 
 class TractionPage extends StatefulWidget {
@@ -67,13 +69,14 @@ class _TractionPageState extends State<TractionPage> {
   _ClassLeaderboardScope _classLeaderboardScope = _ClassLeaderboardScope.global;
 
   final Map<String, TextEditingController> _dynamicControllers = {};
-  final Map<String, String?> _enumSelections = {};
+  final Map<String, dynamic> _enumSelections = {};
   bool _restoredFromPrefs = false;
   static const int _pageSize = 100;
   int _lastTractionOffset = 0;
   String? _lastQuerySignature;
   String? _transferFromLabel;
   bool _isSearching = false;
+  bool _exporting = false;
 
   @override
   void initState() {
@@ -167,12 +170,7 @@ class _TractionPageState extends State<TractionPage> {
     ].join(';');
   }
 
-  Future<void> _refreshTraction({
-    bool append = false,
-    bool preservePosition = true,
-  }) async {
-    _setState(() => _isSearching = true);
-    final data = context.read<DataService>();
+  Map<String, dynamic> _buildTractionFilters() {
     final filters = <String, dynamic>{};
     final name = _nameController.text.trim();
     if (name.isNotEmpty) filters['name'] = name;
@@ -185,6 +183,16 @@ class _TractionPageState extends State<TractionPage> {
         filters[key] = value;
       }
     });
+    return filters;
+  }
+
+  Future<void> _refreshTraction({
+    bool append = false,
+    bool preservePosition = true,
+  }) async {
+    _setState(() => _isSearching = true);
+    final data = context.read<DataService>();
+    final filters = _buildTractionFilters();
     final hadOnly = !_hasFilters;
     final signature = _tractionQuerySignature(filters, hadOnly);
     final queryChanged =
@@ -649,8 +657,11 @@ class _TractionPageState extends State<TractionPage> {
     return content;
   }
 
+  String get _currentClassLabel =>
+      (_selectedClass ?? _classController.text).trim();
+
   bool get _hasClassQuery {
-    return (_selectedClass ?? _classController.text).trim().isNotEmpty;
+    return _currentClassLabel.isNotEmpty;
   }
 
   Widget _buildHeaderActions(BuildContext context, bool isMobile) {
@@ -688,7 +699,7 @@ class _TractionPageState extends State<TractionPage> {
     );
 
     final hasAdminActions = isElevated;
-    final hasMoreMenu = hasClassActions || hasAdminActions;
+    final hasMoreMenu = true;
 
     final moreButton = !hasMoreMenu
         ? null
@@ -696,6 +707,9 @@ class _TractionPageState extends State<TractionPage> {
             tooltip: 'More options',
             onSelected: (action) async {
               switch (action) {
+                case _TractionMoreAction.exportResults:
+                  await _exportTractionResults();
+                  break;
                 case _TractionMoreAction.classStats:
                   _toggleClassStatsPanel();
                   break;
@@ -730,10 +744,32 @@ class _TractionPageState extends State<TractionPage> {
                     );
                   }
                   break;
+                case _TractionMoreAction.adminImport:
+                  await _showTractionImportSheet();
+                  break;
               }
             },
             itemBuilder: (context) {
               final items = <PopupMenuEntry<_TractionMoreAction>>[];
+              items.add(
+                PopupMenuItem(
+                  value: _TractionMoreAction.exportResults,
+                  child: Row(
+                    children: [
+                      if (_exporting)
+                        const SizedBox(
+                          height: 16,
+                          width: 16,
+                          child: CircularProgressIndicator(strokeWidth: 2),
+                        )
+                      else
+                        const Icon(Icons.download, size: 18),
+                      const SizedBox(width: 8),
+                      Text(_exporting ? 'Exporting...' : 'Export'),
+                    ],
+                  ),
+                ),
+              );
               if (hasClassActions) {
                 items.add(
                   PopupMenuItem(
@@ -793,6 +829,12 @@ class _TractionPageState extends State<TractionPage> {
                     child: Text('Pending changes'),
                   ),
                 );
+                items.add(
+                  const PopupMenuItem(
+                    value: _TractionMoreAction.adminImport,
+                    child: Text('Import traction'),
+                  ),
+                );
               }
               return items;
             },
@@ -849,6 +891,344 @@ class _TractionPageState extends State<TractionPage> {
     );
   }
 
+  Future<void> _exportTractionResults() async {
+    if (_exporting) return;
+    setState(() => _exporting = true);
+    final messenger = ScaffoldMessenger.of(context);
+    try {
+      final data = context.read<DataService>();
+      final filters = _buildTractionFilters();
+      final hadOnly = !_hasFilters;
+      final limit = data.traction.length;
+      final params = StringBuffer('?limit=$limit&offset=0');
+      if (hadOnly) params.write('&had_only=true');
+      if (!_mileageFirst) params.write('&mileage_first=false');
+
+      final payload = <String, dynamic>{};
+      final classLabel = (_selectedClass ?? _classController.text).trim();
+      if (classLabel.isNotEmpty) payload['class'] = classLabel;
+      final numberLabel = _numberController.text.trim();
+      if (numberLabel.isNotEmpty) payload['number'] = numberLabel;
+      filters.forEach((key, value) {
+        if (value == null) return;
+        if (value is String && value.trim().isEmpty) return;
+        payload[key] = value;
+      });
+
+      final response = await data.api.postBytes(
+        '/locos/search/v2/export${params.toString()}',
+        payload.isEmpty ? null : payload,
+        headers: const {'accept': '*/*'},
+      );
+      final filename = response.filename ?? 'traction-export.xlsx';
+      final saveResult = await saveBytes(
+        Uint8List.fromList(response.bytes),
+        filename,
+        mimeType: response.contentType,
+      );
+      if (!mounted) return;
+      if (saveResult.canceled) {
+        messenger.showSnackBar(
+          const SnackBar(content: Text('Export canceled.')),
+        );
+      } else {
+        final path = saveResult.path;
+        messenger.showSnackBar(
+          SnackBar(
+            content: Text(
+              path == null || path.isEmpty
+                  ? 'Export started.'
+                  : 'Export saved to $path',
+            ),
+          ),
+        );
+      }
+    } on ApiException catch (e) {
+      if (!mounted) return;
+      messenger.showSnackBar(
+        SnackBar(content: Text('Export failed: ${e.message}')),
+      );
+    } catch (e) {
+      if (!mounted) return;
+      messenger.showSnackBar(
+        SnackBar(content: Text('Export failed: $e')),
+      );
+    } finally {
+      if (mounted) setState(() => _exporting = false);
+    }
+  }
+
+  Future<void> _showTractionImportSheet() async {
+    final isElevated = context.read<AuthService>().isElevated;
+    if (!isElevated) {
+      ScaffoldMessenger.of(context).showSnackBar(
+        const SnackBar(content: Text('Import is available to admins only.')),
+      );
+      return;
+    }
+
+    XFile? selectedFile;
+    bool uploading = false;
+    Map<String, dynamic>? importResult;
+    String? statusMessage;
+    String? errorMessage;
+
+    await showModalBottomSheet<void>(
+      context: context,
+      isScrollControlled: true,
+      builder: (sheetContext) {
+        final theme = Theme.of(sheetContext);
+        return StatefulBuilder(
+          builder: (context, setModalState) {
+            Future<void> pickFile() async {
+              final file = await openFile(
+                acceptedTypeGroups: const [
+                  XTypeGroup(
+                    label: 'Spreadsheets',
+                    extensions: ['xlsx', 'xls', 'ods', 'odf'],
+                  ),
+                ],
+              );
+              if (file == null) return;
+              setModalState(() {
+                selectedFile = file;
+                importResult = null;
+                statusMessage = null;
+                errorMessage = null;
+              });
+            }
+
+            Future<void> uploadFile() async {
+              final file = selectedFile;
+              if (file == null || uploading) return;
+              setModalState(() {
+                uploading = true;
+                importResult = null;
+                statusMessage = null;
+                errorMessage = null;
+              });
+              try {
+                final data = context.read<DataService>();
+                final bytes = await file.readAsBytes();
+                final response = await data.api.postMultipartFile(
+                  '/loco/class/import',
+                  bytes: bytes,
+                  filename: file.name,
+                  headers: const {'accept': 'application/json'},
+                );
+                if (!mounted) return;
+                final parsed = response is Map
+                    ? Map<String, dynamic>.from(response)
+                    : null;
+                if (parsed != null) {
+                  final imported = _importCount(parsed['imported']);
+                  final updated = _importCount(parsed['updated']);
+                  final errors = _importErrors(parsed);
+                  final errorNote =
+                      errors.isNotEmpty ? ' (${errors.length} error(s))' : '';
+                  statusMessage =
+                      'Import complete. Imported $imported, updated $updated$errorNote.';
+                  importResult = parsed;
+                } else {
+                  statusMessage = 'Import complete.';
+                }
+                await data.fetchClassList();
+                await _refreshTraction(preservePosition: true);
+              } on ApiException catch (e) {
+                if (!mounted) return;
+                errorMessage = e.message;
+              } catch (e) {
+                if (!mounted) return;
+                errorMessage = e.toString();
+              } finally {
+                if (!mounted) return;
+                setModalState(() => uploading = false);
+              }
+            }
+
+            return SafeArea(
+              child: Padding(
+                padding: EdgeInsets.fromLTRB(
+                  16,
+                  16,
+                  16,
+                  16 + MediaQuery.of(context).viewInsets.bottom,
+                ),
+                child: SingleChildScrollView(
+                  child: Column(
+                    crossAxisAlignment: CrossAxisAlignment.start,
+                    mainAxisSize: MainAxisSize.min,
+                    children: [
+                      Text(
+                        'Import traction data',
+                        style: theme.textTheme.titleLarge,
+                      ),
+                      const SizedBox(height: 8),
+                      Text(
+                        'Upload a spreadsheet to import traction records.',
+                        style: theme.textTheme.bodyMedium,
+                      ),
+                      const SizedBox(height: 12),
+                      Row(
+                        children: [
+                          Expanded(
+                            child: Text(
+                              selectedFile?.name ?? 'No file selected',
+                              overflow: TextOverflow.ellipsis,
+                            ),
+                          ),
+                          const SizedBox(width: 8),
+                          OutlinedButton.icon(
+                            onPressed: uploading ? null : pickFile,
+                            icon: const Icon(Icons.upload_file),
+                            label: const Text('Choose file'),
+                          ),
+                        ],
+                      ),
+                      const SizedBox(height: 12),
+                      FilledButton.icon(
+                        onPressed:
+                            selectedFile == null || uploading ? null : uploadFile,
+                        icon: uploading
+                            ? const SizedBox(
+                                width: 16,
+                                height: 16,
+                                child: CircularProgressIndicator(strokeWidth: 2),
+                              )
+                            : const Icon(Icons.file_upload),
+                        label: Text(
+                          uploading ? 'Importing...' : 'Upload and import',
+                        ),
+                      ),
+                      if (statusMessage != null) ...[
+                        const SizedBox(height: 12),
+                        Text(
+                          statusMessage!,
+                          style: theme.textTheme.bodyMedium,
+                        ),
+                      ],
+                      if (errorMessage != null) ...[
+                        const SizedBox(height: 12),
+                        Text(
+                          errorMessage!,
+                          style: theme.textTheme.bodyMedium?.copyWith(
+                            color: theme.colorScheme.error,
+                          ),
+                        ),
+                      ],
+                      if (importResult != null)
+                        _buildImportSummary(context, importResult!),
+                    ],
+                  ),
+                ),
+              ),
+            );
+          },
+        );
+      },
+    );
+  }
+
+  int _importCount(dynamic value) {
+    if (value is num) return value.toInt();
+    return int.tryParse(value?.toString() ?? '') ?? 0;
+  }
+
+  List<dynamic> _importErrors(Map<String, dynamic> result) {
+    final errors = result['errors'];
+    if (errors == null) return const [];
+    if (errors is List) return errors;
+    return [errors];
+  }
+
+  String _stringifyImportError(dynamic err) {
+    if (err == null) return '';
+    if (err is String) return err;
+    try {
+      return jsonEncode(err);
+    } catch (_) {
+      return err.toString();
+    }
+  }
+
+  Widget _buildImportSummary(
+    BuildContext context,
+    Map<String, dynamic> result,
+  ) {
+    final imported = _importCount(result['imported']);
+    final updated = _importCount(result['updated']);
+    final errors = _importErrors(result);
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        const SizedBox(height: 12),
+        Text(
+          'Import summary',
+          style: Theme.of(context).textTheme.titleMedium,
+        ),
+        const SizedBox(height: 8),
+        Wrap(
+          spacing: 12,
+          runSpacing: 8,
+          children: [
+            _buildImportChip(context, 'Imported', imported.toString()),
+            _buildImportChip(context, 'Updated', updated.toString()),
+            _buildImportChip(context, 'Errors', errors.length.toString()),
+          ],
+        ),
+        if (errors.isNotEmpty) ...[
+          const SizedBox(height: 8),
+          Text(
+            'Errors',
+            style: Theme.of(context).textTheme.labelLarge,
+          ),
+          const SizedBox(height: 6),
+          Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: errors
+                .map(
+                  (err) => Padding(
+                    padding: const EdgeInsets.only(bottom: 4),
+                    child: Text(_stringifyImportError(err)),
+                  ),
+                )
+                .toList(),
+          ),
+        ],
+      ],
+    );
+  }
+
+  Widget _buildImportChip(
+    BuildContext context,
+    String label,
+    String value,
+  ) {
+    final scheme = Theme.of(context).colorScheme;
+    return Container(
+      padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
+      decoration: BoxDecoration(
+        color: scheme.surfaceContainerHighest,
+        borderRadius: BorderRadius.circular(8),
+        border: Border.all(color: scheme.outlineVariant),
+      ),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          Text(
+            label,
+            style: Theme.of(context).textTheme.labelSmall,
+          ),
+          const SizedBox(height: 4),
+          Text(
+            value,
+            style: const TextStyle(fontWeight: FontWeight.w700),
+          ),
+        ],
+      ),
+    );
+  }
+
   Future<void> _toggleClassStatsPanel() async {
     if (!_hasClassQuery) return;
     final targetState = !_showClassStatsPanel;
@@ -1489,13 +1869,44 @@ class _TractionPageState extends State<TractionPage> {
     bool isMobile,
   ) {
     final width = isMobile ? double.infinity : 220.0;
+    final type = field.type?.toLowerCase() ?? '';
+    final isBooleanField =
+        type == 'bool' || type == 'boolean' || type.contains('bool');
+    if (isBooleanField) {
+      final currentValue = _enumSelections[field.name];
+      final safeValue = currentValue is bool ? currentValue : null;
+      return SizedBox(
+        width: width,
+        child: DropdownButtonFormField<bool?>(
+          value: safeValue,
+          decoration: InputDecoration(
+            labelText: field.display,
+            border: const OutlineInputBorder(),
+          ),
+          items: const [
+            DropdownMenuItem(value: null, child: Text('Any')),
+            DropdownMenuItem(value: true, child: Text('Yes')),
+            DropdownMenuItem(value: false, child: Text('No')),
+          ],
+          onChanged: (val) {
+            setState(() {
+              _enumSelections[field.name] = val;
+            });
+            _refreshTraction();
+          },
+        ),
+      );
+    }
     if (field.enumValues != null && field.enumValues!.isNotEmpty) {
       final options = field.enumValues!
           .map((e) => e.toString())
           .toSet()
           .toList();
       final currentValue = _enumSelections[field.name];
-      final safeValue = options.contains(currentValue) ? currentValue : null;
+      final safeValue =
+          currentValue is String && options.contains(currentValue)
+              ? currentValue
+              : null;
       return SizedBox(
         width: width,
         child: DropdownButtonFormField<String?>(
@@ -1525,7 +1936,6 @@ class _TractionPageState extends State<TractionPage> {
     _dynamicControllers[field.name] = controller;
     TextInputType? inputType;
     if (field.type != null) {
-      final type = field.type!.toLowerCase();
       if (type.contains('int') ||
           type.contains('num') ||
           type.contains('double')) {

lib/components/widgets/multi_select_filter.dart

@@ -0,0 +1,166 @@
+import 'package:flutter/material.dart';
+
+class MultiSelectFilter extends StatefulWidget {
+  const MultiSelectFilter({
+    super.key,
+    required this.label,
+    required this.options,
+    required this.selected,
+    required this.onChanged,
+    this.onRefresh,
+  });
+
+  final String label;
+  final List<String> options;
+  final List<String> selected;
+  final ValueChanged<List<String>> onChanged;
+  final VoidCallback? onRefresh;
+
+  @override
+  State<MultiSelectFilter> createState() => _MultiSelectFilterState();
+}
+
+class _MultiSelectFilterState extends State<MultiSelectFilter> {
+  late List<String> _tempSelected;
+  String _query = '';
+
+  @override
+  void initState() {
+    super.initState();
+    _tempSelected = List.from(widget.selected);
+  }
+
+  @override
+  void didUpdateWidget(covariant MultiSelectFilter oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    if (oldWidget.selected != widget.selected) {
+      _tempSelected = List.from(widget.selected);
+    }
+  }
+
+  void _openPicker() async {
+    _tempSelected = List.from(widget.selected);
+    _query = '';
+    await showModalBottomSheet<void>(
+      context: context,
+      isScrollControlled: true,
+      builder: (ctx) {
+        return StatefulBuilder(
+          builder: (ctx, setModalState) {
+            final filtered = widget.options
+                .where((opt) =>
+                    _query.isEmpty || opt.toLowerCase().contains(_query.toLowerCase()))
+                .toList();
+            return SafeArea(
+              child: Padding(
+                padding: const EdgeInsets.all(16.0),
+                child: Column(
+                  mainAxisSize: MainAxisSize.min,
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    Row(
+                      children: [
+                        Text(
+                          'Select ${widget.label.toLowerCase()}',
+                          style: Theme.of(context).textTheme.titleMedium?.copyWith(
+                                fontWeight: FontWeight.w700,
+                              ),
+                        ),
+                        const Spacer(),
+                        if (widget.onRefresh != null)
+                          IconButton(
+                            tooltip: 'Refresh',
+                            onPressed: widget.onRefresh,
+                            icon: const Icon(Icons.refresh),
+                          ),
+                        TextButton(
+                          onPressed: () {
+                            setModalState(() {
+                              _tempSelected.clear();
+                            });
+                            Navigator.of(ctx).pop();
+                            widget.onChanged(const []);
+                          },
+                          child: const Text('Clear'),
+                        ),
+                      ],
+                    ),
+                    const SizedBox(height: 8),
+                    TextField(
+                      decoration: const InputDecoration(
+                        labelText: 'Search',
+                        border: OutlineInputBorder(),
+                      ),
+                      onChanged: (val) {
+                        setModalState(() {
+                          _query = val;
+                        });
+                      },
+                    ),
+                    const SizedBox(height: 12),
+                    SizedBox(
+                      height: 320,
+                      child: ListView.builder(
+                        itemCount: filtered.length,
+                        itemBuilder: (_, index) {
+                          final option = filtered[index];
+                          final selected = _tempSelected.contains(option);
+                          return CheckboxListTile(
+                            value: selected,
+                            title: Text(option),
+                            onChanged: (val) {
+                              setModalState(() {
+                                if (val == true) {
+                                  if (!_tempSelected.contains(option)) {
+                                    _tempSelected.add(option);
+                                  }
+                                } else {
+                                  _tempSelected.removeWhere((e) => e == option);
+                                }
+                              });
+                              widget.onChanged(List.from(_tempSelected.toSet()));
+                            },
+                          );
+                        },
+                      ),
+                    ),
+                    const SizedBox(height: 12),
+                    Align(
+                      alignment: Alignment.centerRight,
+                      child: FilledButton.icon(
+                        onPressed: () {
+                          widget.onChanged(List.from(_tempSelected.toSet()));
+                          Navigator.of(ctx).pop();
+                        },
+                        icon: const Icon(Icons.check),
+                        label: const Text('Apply'),
+                      ),
+                    ),
+                  ],
+                ),
+              ),
+            );
+          },
+        );
+      },
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final hasSelection = widget.selected.isNotEmpty;
+    final display =
+        hasSelection ? widget.selected.join(', ') : 'Any ${widget.label.toLowerCase()}';
+    return OutlinedButton.icon(
+      onPressed: _openPicker,
+      icon: const Icon(Icons.filter_alt),
+      label: SizedBox(
+        width: 180,
+        child: Text(
+          '${widget.label}: $display',
+          overflow: TextOverflow.ellipsis,
+        ),
+      ),
+    );
+  }
+}

lib/services/api_service.dart

@@ -2,7 +2,7 @@ import 'dart:convert';
 import 'package:http/http.dart' as http;
 
 typedef TokenProvider = String? Function();
-typedef UnauthorizedHandler = Future<void> Function();
+typedef UnauthorizedHandler = Future<bool> Function();
 
 class ApiService {
   String _baseUrl;
@@ -36,35 +36,47 @@ class ApiService {
     _client.close();
   }
 
-  Map<String, String> _buildHeaders(Map<String, String>? extra) {
+  Map<String, String> _buildHeaders(
+    Map<String, String>? extra, {
+    bool includeAuth = true,
+  }) {
     final token = _getToken?.call();
     final headers = {'accept': 'application/json', ...?extra};
-    if (token != null && token.isNotEmpty) {
+    if (includeAuth && token != null && token.isNotEmpty) {
       headers['Authorization'] = 'Bearer $token';
     }
     return headers;
   }
 
-  Future<dynamic> get(String endpoint, {Map<String, String>? headers}) async {
-    final response = await _client
-        .get(
-          Uri.parse('$baseUrl$endpoint'),
-          headers: _buildHeaders(headers),
-        )
-        .timeout(timeout);
+  Future<dynamic> get(
+    String endpoint, {
+    Map<String, String>? headers,
+    bool includeAuth = true,
+    bool allowRetry = true,
+  }) async {
+    final response = await _sendWithRetry(
+      () => _client.get(
+        Uri.parse('$baseUrl$endpoint'),
+        headers: _buildHeaders(headers, includeAuth: includeAuth),
+      ),
+      allowRetry: allowRetry,
+    );
     return _processResponse(response);
   }
 
   Future<ApiBinaryResponse> getBytes(
     String endpoint, {
     Map<String, String>? headers,
+    bool includeAuth = true,
+    bool allowRetry = true,
   }) async {
-    final response = await _client
-        .get(
-          Uri.parse('$baseUrl$endpoint'),
-          headers: _buildHeaders(headers),
-        )
-        .timeout(timeout);
+    final response = await _sendWithRetry(
+      () => _client.get(
+        Uri.parse('$baseUrl$endpoint'),
+        headers: _buildHeaders(headers, includeAuth: includeAuth),
+      ),
+      allowRetry: allowRetry,
+    );
 
     if (response.statusCode >= 200 && response.statusCode < 300) {
       final contentDisposition = response.headers['content-disposition'];
@@ -76,10 +88,6 @@ class ApiService {
       );
     }
 
-    if (response.statusCode == 401 && _onUnauthorized != null) {
-      await _onUnauthorized!();
-    }
-
     final body = _decodeBody(response);
     final message = _extractErrorMessage(body);
     throw ApiException(
@@ -93,29 +101,117 @@ class ApiService {
     String endpoint,
     dynamic data, {
     Map<String, String>? headers,
+    bool includeAuth = true,
+    bool allowRetry = true,
   }) async {
     final hasBody = data != null;
-    final response = await _client
-        .post(
-          Uri.parse('$baseUrl$endpoint'),
-          headers: _buildHeaders(hasBody ? _jsonHeaders(headers) : headers),
-          body: hasBody ? jsonEncode(data) : null,
-        )
-        .timeout(timeout);
+    final response = await _sendWithRetry(
+      () => _client.post(
+        Uri.parse('$baseUrl$endpoint'),
+        headers: _buildHeaders(
+          hasBody ? _jsonHeaders(headers) : headers,
+          includeAuth: includeAuth,
+        ),
+        body: hasBody ? jsonEncode(data) : null,
+      ),
+      allowRetry: allowRetry,
+    );
     return _processResponse(response);
   }
 
-  Future<dynamic> postForm(String endpoint, Map<String, String> data) async {
-    final response = await _client
-        .post(
-          Uri.parse('$baseUrl$endpoint'),
-          headers: _buildHeaders({
+  Future<ApiBinaryResponse> postBytes(
+    String endpoint,
+    dynamic data, {
+    Map<String, String>? headers,
+    bool includeAuth = true,
+    bool allowRetry = true,
+  }) async {
+    final hasBody = data != null;
+    final response = await _sendWithRetry(
+      () => _client.post(
+        Uri.parse('$baseUrl$endpoint'),
+        headers: _buildHeaders(
+          hasBody ? _jsonHeaders(headers) : headers,
+          includeAuth: includeAuth,
+        ),
+        body: hasBody ? jsonEncode(data) : null,
+      ),
+      allowRetry: allowRetry,
+    );
+
+    if (response.statusCode >= 200 && response.statusCode < 300) {
+      final contentDisposition = response.headers['content-disposition'];
+      return ApiBinaryResponse(
+        bytes: response.bodyBytes,
+        statusCode: response.statusCode,
+        contentType: response.headers['content-type'],
+        filename: _extractFilename(contentDisposition),
+      );
+    }
+
+    final body = _decodeBody(response);
+    final message = _extractErrorMessage(body);
+    throw ApiException(
+      statusCode: response.statusCode,
+      message: message,
+      body: body,
+    );
+  }
+
+  Future<dynamic> postMultipartFile(
+    String endpoint, {
+    required List<int> bytes,
+    required String filename,
+    String fieldName = 'file',
+    Map<String, String>? fields,
+    Map<String, String>? headers,
+    bool includeAuth = true,
+    bool allowRetry = true,
+  }) async {
+    Future<http.Response> send() async {
+      final request = http.MultipartRequest(
+        'POST',
+        Uri.parse('$baseUrl$endpoint'),
+      );
+      request.headers.addAll(_buildHeaders(headers, includeAuth: includeAuth));
+      if (fields != null && fields.isNotEmpty) {
+        request.fields.addAll(fields);
+      }
+      request.files.add(
+        http.MultipartFile.fromBytes(
+          fieldName,
+          bytes,
+          filename: filename,
+        ),
+      );
+      final streamed = await _client.send(request);
+      return http.Response.fromStream(streamed);
+    }
+
+    final response = await _sendWithRetry(send, allowRetry: allowRetry);
+    return _processResponse(response);
+  }
+
+  Future<dynamic> postForm(
+    String endpoint,
+    Map<String, String> data, {
+    bool includeAuth = true,
+    bool allowRetry = true,
+  }) async {
+    final response = await _sendWithRetry(
+      () => _client.post(
+        Uri.parse('$baseUrl$endpoint'),
+        headers: _buildHeaders(
+          {
             'Content-Type': 'application/x-www-form-urlencoded',
             'accept': 'application/json',
-          }),
-          body: data, // http package handles form-encoding for Map<String, String>
-        )
-        .timeout(timeout);
+          },
+          includeAuth: includeAuth,
+        ),
+        body: data, // http package handles form-encoding for Map<String, String>
+      ),
+      allowRetry: allowRetry,
+    );
     return _processResponse(response);
   }
 
@@ -123,28 +219,37 @@ class ApiService {
     String endpoint,
     dynamic data, {
     Map<String, String>? headers,
+    bool includeAuth = true,
+    bool allowRetry = true,
   }) async {
     final hasBody = data != null;
-    final response = await _client
-        .put(
-          Uri.parse('$baseUrl$endpoint'),
-          headers: _buildHeaders(hasBody ? _jsonHeaders(headers) : headers),
-          body: hasBody ? jsonEncode(data) : null,
-        )
-        .timeout(timeout);
+    final response = await _sendWithRetry(
+      () => _client.put(
+        Uri.parse('$baseUrl$endpoint'),
+        headers: _buildHeaders(
+          hasBody ? _jsonHeaders(headers) : headers,
+          includeAuth: includeAuth,
+        ),
+        body: hasBody ? jsonEncode(data) : null,
+      ),
+      allowRetry: allowRetry,
+    );
     return _processResponse(response);
   }
 
   Future<dynamic> delete(
     String endpoint, {
     Map<String, String>? headers,
+    bool includeAuth = true,
+    bool allowRetry = true,
   }) async {
-    final response = await _client
-        .delete(
-          Uri.parse('$baseUrl$endpoint'),
-          headers: _buildHeaders(headers),
-        )
-        .timeout(timeout);
+    final response = await _sendWithRetry(
+      () => _client.delete(
+        Uri.parse('$baseUrl$endpoint'),
+        headers: _buildHeaders(headers, includeAuth: includeAuth),
+      ),
+      allowRetry: allowRetry,
+    );
     return _processResponse(response);
   }
 
@@ -158,10 +263,6 @@ class ApiService {
       return body;
     }
 
-    if (res.statusCode == 401 && _onUnauthorized != null) {
-      await _onUnauthorized!();
-    }
-
     final message = _extractErrorMessage(body);
     throw ApiException(
       statusCode: res.statusCode,
@@ -211,6 +312,20 @@ class ApiService {
     return body.toString();
   }
 
+  Future<http.Response> _sendWithRetry(
+    Future<http.Response> Function() send, {
+    required bool allowRetry,
+  }) async {
+    var response = await send().timeout(timeout);
+    if (response.statusCode == 401 && allowRetry && _onUnauthorized != null) {
+      final refreshed = await _onUnauthorized!();
+      if (refreshed) {
+        response = await send().timeout(timeout);
+      }
+    }
+    return response;
+  }
+
   String? _extractFilename(String? contentDisposition) {
     if (contentDisposition == null || contentDisposition.isEmpty) return null;
     final utf8Match =

lib/services/authservice.dart

@@ -6,18 +6,20 @@ import 'package:mileograph_flutter/services/token_storage_service.dart';
 class AuthService extends ChangeNotifier {
   final ApiService api;
   bool _restoring = false;
+  String? _accessToken;
+  Future<bool>? _refreshFuture;
 
   final TokenStorageService _tokenStorage = TokenStorageService();
 
   AuthService({required this.api}) {
     api.setTokenProvider(() => token);
-    api.setUnauthorizedHandler(handleTokenExpired);
+    api.setUnauthorizedHandler(_handleUnauthorized);
   }
 
   AuthenticatedUserData? _user;
 
   bool get isLoggedIn => _user != null;
-  String? get token => _user?.accessToken;
+  String? get token => _accessToken;
   String? get userId => _user?.userId;
   String? get username => _user?.username;
   String? get fullName => _user?.fullName;
@@ -33,11 +35,13 @@ class AuthService extends ChangeNotifier {
     required String fullName,
     required String accessToken,
     required String email,
+    String? refreshToken,
     String entriesVisibility = 'private',
     String mileageVisibility = 'private',
     bool isElevated = false,
     bool isDisabled = false,
   }) {
+    _accessToken = accessToken;
     _user = AuthenticatedUserData(
       userId: userId,
       username: username,
@@ -49,7 +53,7 @@ class AuthService extends ChangeNotifier {
       isElevated: isElevated,
       disabled: isDisabled,
     );
-    _persistToken(accessToken);
+    _persistTokens(accessToken, refreshToken);
     notifyListeners();
   }
 
@@ -64,8 +68,9 @@ class AuthService extends ChangeNotifier {
     };
 
     // 1. Get token
-    final tokenResponse = await api.postForm('/token', formData);
+    final tokenResponse = await api.postForm('/token', formData, includeAuth: false);
     final accessToken = tokenResponse['access_token'];
+    final refreshToken = tokenResponse['refresh_token'];
 
     // 2. Get user details
     final userResponse = await api.get(
@@ -83,6 +88,7 @@ class AuthService extends ChangeNotifier {
       fullName: userResponse['full_name'],
       accessToken: accessToken,
       email: userResponse['email'],
+      refreshToken: refreshToken,
       entriesVisibility: _parseVisibility(
         userResponse['user_entries_visibility'] ?? userResponse['entries_visibility'],
         'private',
@@ -103,33 +109,31 @@ class AuthService extends ChangeNotifier {
       // read token from secure storage (with fallback)
       final token = await _tokenStorage.getToken();
       if (token == null || token.isEmpty) return;
+      _accessToken = token;
 
       final userResponse = await api.get(
         '/users/me',
-        headers: {
-          'Authorization': 'Bearer $token',
-          'accept': 'application/json',
-        },
       );
 
-    setLoginData(
-      userId: userResponse['user_id'],
-      username: userResponse['username'],
-      fullName: userResponse['full_name'],
-      accessToken: token,
-      email: userResponse['email'],
-      entriesVisibility: _parseVisibility(
-        userResponse['user_entries_visibility'] ?? userResponse['entries_visibility'],
-        'private',
-      ),
-      mileageVisibility: _parseVisibility(
-        userResponse['user_mileage_visibility'] ?? userResponse['mileage_visibility'],
-        'private',
-      ),
-      isElevated: _parseIsElevated(userResponse),
-      isDisabled: _parseIsDisabled(userResponse),
-    );
-  } catch (_) {
+      final restoredAccessToken = _accessToken ?? token;
+      setLoginData(
+        userId: userResponse['user_id'],
+        username: userResponse['username'],
+        fullName: userResponse['full_name'],
+        accessToken: restoredAccessToken,
+        email: userResponse['email'],
+        entriesVisibility: _parseVisibility(
+          userResponse['user_entries_visibility'] ?? userResponse['entries_visibility'],
+          'private',
+        ),
+        mileageVisibility: _parseVisibility(
+          userResponse['user_mileage_visibility'] ?? userResponse['mileage_visibility'],
+          'private',
+        ),
+        isElevated: _parseIsElevated(userResponse),
+        isDisabled: _parseIsDisabled(userResponse),
+      );
+    } catch (_) {
       await _clearToken();
     } finally {
       _restoring = false;
@@ -140,12 +144,9 @@ class AuthService extends ChangeNotifier {
     final token = await _tokenStorage.getToken();
     if (token == null || token.isEmpty) return false;
     try {
+      _accessToken = token;
       await api.get(
         '/validate',
-        headers: {
-          'Authorization': 'Bearer $token',
-          'accept': 'application/json',
-        },
       );
       return true;
     } catch (_) {
@@ -154,11 +155,15 @@ class AuthService extends ChangeNotifier {
     }
   }
 
-  Future<void> _persistToken(String token) async {
-    await _tokenStorage.setToken(token);
+  Future<void> _persistTokens(String accessToken, String? refreshToken) async {
+    await _tokenStorage.setToken(accessToken);
+    if (refreshToken != null && refreshToken.isNotEmpty) {
+      await _tokenStorage.setRefreshToken(refreshToken);
+    }
   }
 
   Future<void> _clearToken() async {
+    _accessToken = null;
     await _tokenStorage.clearToken();
   }
 
@@ -181,6 +186,61 @@ class AuthService extends ChangeNotifier {
     await api.postForm('/register', formData);
   }
 
+  Future<bool> _handleUnauthorized() async {
+    if (_refreshFuture != null) {
+      return _refreshFuture!;
+    }
+    _refreshFuture = _refreshTokens();
+    final refreshed = await _refreshFuture!;
+    _refreshFuture = null;
+    return refreshed;
+  }
+
+  Future<bool> _refreshTokens() async {
+    final refreshToken = await _tokenStorage.getRefreshToken();
+    if (refreshToken == null || refreshToken.isEmpty) {
+      await handleTokenExpired();
+      return false;
+    }
+    try {
+      final response = await api.post(
+        '/token/refresh',
+        {'refresh_token': refreshToken},
+        includeAuth: false,
+        allowRetry: false,
+      );
+      final accessToken = response['access_token'];
+      final newRefreshToken = response['refresh_token'];
+      if (accessToken is! String ||
+          accessToken.isEmpty ||
+          newRefreshToken is! String ||
+          newRefreshToken.isEmpty) {
+        await handleTokenExpired();
+        return false;
+      }
+      _accessToken = accessToken;
+      await _persistTokens(accessToken, newRefreshToken);
+      if (_user != null) {
+        _user = AuthenticatedUserData(
+          userId: _user!.userId,
+          username: _user!.username,
+          fullName: _user!.fullName,
+          accessToken: accessToken,
+          email: _user!.email,
+          entriesVisibility: _user!.entriesVisibility,
+          mileageVisibility: _user!.mileageVisibility,
+          isElevated: _user!.isElevated,
+          isDisabled: _user!.disabled,
+        );
+      }
+      notifyListeners();
+      return true;
+    } catch (_) {
+      await handleTokenExpired();
+      return false;
+    }
+  }
+
   Future<void> handleTokenExpired() async {
     _user = null;
     await _clearToken();

lib/services/data_service/data_service_badges.dart

@@ -55,7 +55,6 @@ extension DataServiceBadges on DataService {
     bool onlyIncomplete = false,
   }) async {
     _isClassClearanceProgressLoading = true;
-    if (!append) _classClearanceProgress = [];
     try {
       final onlyIncompleteParam =
           onlyIncomplete ? '&only_incomplete=true' : '';
@@ -84,7 +83,6 @@ extension DataServiceBadges on DataService {
       _classClearanceHasMore = items.length >= limit;
     } catch (e) {
       debugPrint('Failed to fetch class clearance progress: $e');
-      if (!append) _classClearanceProgress = [];
       _classClearanceHasMore = false;
     } finally {
       _isClassClearanceProgressLoading = false;

lib/services/data_service/data_service_core.dart

@@ -7,6 +7,7 @@ class _LegFetchOptions {
   final String? dateRangeStart;
   final String? dateRangeEnd;
   final bool unallocatedOnly;
+  final List<String> networkFilter;
 
   const _LegFetchOptions({
     this.limit = 100,
@@ -15,6 +16,7 @@ class _LegFetchOptions {
     this.dateRangeStart,
     this.dateRangeEnd,
     this.unallocatedOnly = false,
+    this.networkFilter = const [],
   });
 }
 
@@ -118,6 +120,7 @@ class DataService extends ChangeNotifier {
   List<String> _stationNetworks = [];
   Map<String, List<String>> _stationCountryNetworks = {};
   DateTime? _stationFiltersFetchedAt;
+  DateTime? _stationNetworksFetchedAt;
   List<String> get stationNetworks => _stationNetworks;
   Map<String, List<String>> get stationCountryNetworks =>
       _stationCountryNetworks;
@@ -391,9 +394,14 @@ class DataService extends ChangeNotifier {
     String? dateRangeEnd,
     bool append = false,
     bool unallocatedOnly = false,
+    List<String> networkFilter = const [],
   }) async {
     _isLegsLoading = true;
     if (!append) {
+      final normalizedNetworks = networkFilter
+          .map((network) => network.trim())
+          .where((network) => network.isNotEmpty)
+          .toList();
       _lastLegsFetch = _LegFetchOptions(
         limit: limit,
         sortBy: sortBy,
@@ -401,6 +409,7 @@ class DataService extends ChangeNotifier {
         dateRangeStart: dateRangeStart,
         dateRangeEnd: dateRangeEnd,
         unallocatedOnly: unallocatedOnly,
+        networkFilter: normalizedNetworks,
       );
     }
     final buffer = StringBuffer(
@@ -415,6 +424,13 @@ class DataService extends ChangeNotifier {
     if (unallocatedOnly) {
       buffer.write('&unallocated_only=true');
     }
+    final networks = networkFilter
+        .map((network) => network.trim())
+        .where((network) => network.isNotEmpty)
+        .toList();
+    for (final network in networks) {
+      buffer.write('&network_filter=${Uri.encodeQueryComponent(network)}');
+    }
     try {
       final json = await api.get('/user/legs${buffer.toString()}');
 
@@ -444,6 +460,7 @@ class DataService extends ChangeNotifier {
       dateRangeStart: _lastLegsFetch.dateRangeStart,
       dateRangeEnd: _lastLegsFetch.dateRangeEnd,
       unallocatedOnly: _lastLegsFetch.unallocatedOnly,
+      networkFilter: _lastLegsFetch.networkFilter,
     );
   }
 
@@ -669,6 +686,7 @@ class DataService extends ChangeNotifier {
     _stationNetworks = [];
     _stationCountryNetworks = {};
     _stationFiltersFetchedAt = null;
+    _stationNetworksFetchedAt = null;
     _notifications = [];
     _isNotificationsLoading = false;
     _userEntriesVisibility = 'private';
@@ -736,6 +754,9 @@ class DataService extends ChangeNotifier {
         final networks = (map['networks'] as List? ?? const [])
             .whereType<String>()
             .toList();
+        networks.sort(
+          (a, b) => a.toLowerCase().compareTo(b.toLowerCase()),
+        );
         final countryNetworksRaw =
             map['country_networks'] as Map? ?? const <String, dynamic>{};
         final countryNetworks = <String, List<String>>{};
@@ -753,6 +774,31 @@ class DataService extends ChangeNotifier {
     }
   }
 
+  Future<void> fetchStationNetworks() async {
+    final now = DateTime.now();
+    final recent = _stationNetworks.isNotEmpty &&
+        ((_stationNetworksFetchedAt != null &&
+                now.difference(_stationNetworksFetchedAt!) <
+                    const Duration(minutes: 30)) ||
+            (_stationFiltersFetchedAt != null &&
+                now.difference(_stationFiltersFetchedAt!) <
+                    const Duration(minutes: 30)));
+    if (recent) return;
+    try {
+      final response = await api.get('/stations/networks');
+      if (response is List) {
+        final networks = response.whereType<String>().toList();
+        networks.sort(
+          (a, b) => a.toLowerCase().compareTo(b.toLowerCase()),
+        );
+        _stationNetworks = networks;
+        _stationNetworksFetchedAt = now;
+      }
+    } catch (e) {
+      debugPrint('Failed to fetch station networks: $e');
+    }
+  }
+
   String _stationKey(List<String> countries, List<String> networks) {
     final c = countries..sort();
     final n = networks..sort();

lib/services/token_storage_service.dart

@@ -10,7 +10,8 @@ class TokenStorageService {
 
   factory TokenStorageService() => _instance;
 
-  static const _tokenKey = 'auth_token';
+  static const _accessTokenKey = 'auth_token';
+  static const _refreshTokenKey = 'refresh_token';
   final FlutterSecureStorage _secureStorage = const FlutterSecureStorage();
 
   Future<SharedPreferences> get _prefs async =>
@@ -18,17 +19,17 @@ class TokenStorageService {
 
   Future<void> setToken(String token) async {
     try {
-      await _secureStorage.write(key: _tokenKey, value: token);
+      await _secureStorage.write(key: _accessTokenKey, value: token);
     } catch (_) {
       // ignore secure storage failures in debug/unsupported environments
     }
     final prefs = await _prefs;
-    await prefs.setString(_tokenKey, token);
+    await prefs.setString(_accessTokenKey, token);
   }
 
   Future<String?> getToken() async {
     try {
-      final secured = await _secureStorage.read(key: _tokenKey);
+      final secured = await _secureStorage.read(key: _accessTokenKey);
       if (secured != null && secured.isNotEmpty) {
         return secured;
       }
@@ -36,22 +37,48 @@ class TokenStorageService {
       // ignore and fall back
     }
     final prefs = await _prefs;
-    final token = prefs.getString(_tokenKey);
+    final token = prefs.getString(_accessTokenKey);
     return (token == null || token.isEmpty) ? null : token;
   }
 
   Future<void> clearToken() async {
     try {
-      await _secureStorage.delete(key: _tokenKey);
+      await _secureStorage.delete(key: _accessTokenKey);
+      await _secureStorage.delete(key: _refreshTokenKey);
     } catch (_) {
       // ignore
     }
     final prefs = await _prefs;
-    await prefs.remove(_tokenKey);
+    await prefs.remove(_accessTokenKey);
+    await prefs.remove(_refreshTokenKey);
   }
 
   Future<bool> hasToken() async {
     final token = await getToken();
     return token != null && token.isNotEmpty;
   }
+
+  Future<void> setRefreshToken(String token) async {
+    try {
+      await _secureStorage.write(key: _refreshTokenKey, value: token);
+    } catch (_) {
+      // ignore secure storage failures in debug/unsupported environments
+    }
+    final prefs = await _prefs;
+    await prefs.setString(_refreshTokenKey, token);
+  }
+
+  Future<String?> getRefreshToken() async {
+    try {
+      final secured = await _secureStorage.read(key: _refreshTokenKey);
+      if (secured != null && secured.isNotEmpty) {
+        return secured;
+      }
+    } catch (_) {
+      // ignore and fall back
+    }
+    final prefs = await _prefs;
+    final token = prefs.getString(_refreshTokenKey);
+    return (token == null || token.isEmpty) ? null : token;
+  }
 }

pubspec.lock

@@ -262,6 +262,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "4.1.0"
+  flutter_svg:
+    dependency: "direct main"
+    description:
+      name: flutter_svg
+      sha256: "87fbd7c534435b6c5d9d98b01e1fd527812b82e68ddd8bd35fc45ed0fa8f0a95"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.2.3"
   flutter_test:
     dependency: "direct dev"
     description: flutter
@@ -400,6 +408,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.9.1"
+  path_parsing:
+    dependency: transitive
+    description:
+      name: path_parsing
+      sha256: "883402936929eac138ee0a45da5b0f2c80f89913e6dc3bf77eb65b84b409c6ca"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.0"
   path_provider:
     dependency: transitive
     description:
@@ -605,6 +621,30 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.4.0"
+  vector_graphics:
+    dependency: transitive
+    description:
+      name: vector_graphics
+      sha256: a4f059dc26fc8295b5921376600a194c4ec7d55e72f2fe4c7d2831e103d461e6
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.19"
+  vector_graphics_codec:
+    dependency: transitive
+    description:
+      name: vector_graphics_codec
+      sha256: "99fd9fbd34d9f9a32efd7b6a6aae14125d8237b10403b422a6a6dfeac2806146"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.13"
+  vector_graphics_compiler:
+    dependency: transitive
+    description:
+      name: vector_graphics_compiler
+      sha256: d354a7ec6931e6047785f4db12a1f61ec3d43b207fc0790f863818543f8ff0dc
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.19"
   vector_math:
     dependency: transitive
     description:

pubspec.yaml

@@ -16,7 +16,7 @@ publish_to: "none" # Remove this line if you wish to publish to pub.dev
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
 # In Windows, build-name is used as the major, minor, and patch parts
 # of the product and file versions while build-number is used as the build suffix.
-version: 0.7.5+13
+version: 0.7.8+16
 
 environment:
   sdk: ^3.8.1
@@ -42,6 +42,7 @@ dependencies:
   file_selector_macos: ^0.9.4
   file_selector_windows: ^0.9.3
   file_selector_web: ^0.9.4
+  flutter_svg: ^2.0.10
 
   # The following adds the Cupertino Icons font to your application.
   # Use with the CupertinoIcons class for iOS style icons.
@@ -73,6 +74,8 @@ flutter:
     - family: Tomatoes
       fonts:
         - asset: lib/assets/fonts/Tomatoes-O8L8.ttf
+  assets:
+    - assets/logos/pg_logo_v2.svg
   # To add assets to your application, add an assets section, like this:
   # assets:
   #   - images/a_dot_burr.jpeg

test/helpers/fake_services.dart

@@ -0,0 +1,269 @@
+import 'package:flutter/foundation.dart';
+import 'package:mileograph_flutter/objects/objects.dart';
+import 'package:mileograph_flutter/services/api_service.dart';
+import 'package:mileograph_flutter/services/authservice.dart';
+import 'package:mileograph_flutter/services/data_service.dart';
+import 'package:mileograph_flutter/services/distance_unit_service.dart';
+
+import 'test_data.dart';
+
+class FakeApiService extends ApiService {
+  FakeApiService({String baseUrl = 'https://example.com'})
+      : super(baseUrl: baseUrl);
+
+  final Map<String, dynamic> getResponses = {};
+  final Map<String, dynamic> postResponses = {};
+
+  @override
+  Future<dynamic> get(String endpoint, {Map<String, String>? headers}) async {
+    return getResponses[endpoint];
+  }
+
+  @override
+  Future<dynamic> post(
+    String endpoint,
+    dynamic data, {
+    Map<String, String>? headers,
+  }) async {
+    return postResponses[endpoint] ?? {};
+  }
+}
+
+class FakeAuthService extends AuthService {
+  FakeAuthService({
+    required super.api,
+    this.userIdValue = 'user-123',
+    this.usernameValue = 'railfan',
+    this.fullNameValue = 'Alex Rider',
+    this.isElevatedValue = true,
+    this.isLoggedInValue = true,
+  });
+
+  final String? userIdValue;
+  final String? usernameValue;
+  final String? fullNameValue;
+  final bool isElevatedValue;
+  final bool isLoggedInValue;
+
+  @override
+  bool get isLoggedIn => isLoggedInValue;
+
+  @override
+  String? get userId => userIdValue;
+
+  @override
+  String? get username => usernameValue;
+
+  @override
+  String? get fullName => fullNameValue;
+
+  @override
+  bool get isElevated => isElevatedValue;
+}
+
+class FakeDataService extends DataService {
+  FakeDataService({ApiService? api})
+      : super(api: api ?? FakeApiService());
+
+  HomepageStats? homepageStatsValue;
+  bool isHomepageLoadingValue = false;
+  List<TripSummary> tripsValue = [];
+  List<Leg> onThisDayValue = [];
+  bool isOnThisDayLoadingValue = false;
+  List<ClassClearanceProgress> classClearanceProgressValue = [];
+  bool isClassClearanceProgressLoadingValue = false;
+  List<LocoSummary> tractionValue = [];
+  bool isTractionLoadingValue = false;
+  bool tractionHasMoreValue = false;
+  List<LocoChange> latestLocoChangesValue = [];
+  bool isLatestLocoChangesLoadingValue = false;
+  bool latestLocoChangesHasMoreValue = false;
+  List<Leg> legsValue = [];
+  bool isLegsLoadingValue = false;
+  bool legsHasMoreValue = false;
+  List<TripDetail> tripDetailsValue = [];
+  List<TripSummary> tripListValue = [];
+  bool isTripDetailsLoadingValue = false;
+  List<String> locoClassesValue = [];
+  List<EventField> eventFieldsValue = [];
+  bool isEventFieldsLoadingValue = false;
+  int pendingLocoCountValue = 0;
+  double currentYearMileageValue = 0;
+
+  @override
+  HomepageStats? get homepageStats => homepageStatsValue;
+
+  @override
+  bool get isHomepageLoading => isHomepageLoadingValue;
+
+  @override
+  List<TripSummary> get trips => tripsValue;
+
+  @override
+  List<Leg> get onThisDay => onThisDayValue;
+
+  @override
+  bool get isOnThisDayLoading => isOnThisDayLoadingValue;
+
+  @override
+  List<ClassClearanceProgress> get classClearanceProgress =>
+      classClearanceProgressValue;
+
+  @override
+  bool get isClassClearanceProgressLoading =>
+      isClassClearanceProgressLoadingValue;
+
+  @override
+  List<LocoSummary> get traction => tractionValue;
+
+  @override
+  bool get isTractionLoading => isTractionLoadingValue;
+
+  @override
+  bool get tractionHasMore => tractionHasMoreValue;
+
+  @override
+  List<LocoChange> get latestLocoChanges => latestLocoChangesValue;
+
+  @override
+  bool get isLatestLocoChangesLoading => isLatestLocoChangesLoadingValue;
+
+  @override
+  bool get latestLocoChangesHasMore => latestLocoChangesHasMoreValue;
+
+  @override
+  List<Leg> get legs => legsValue;
+
+  @override
+  bool get isLegsLoading => isLegsLoadingValue;
+
+  @override
+  bool get legsHasMore => legsHasMoreValue;
+
+  @override
+  List<TripDetail> get tripDetails => tripDetailsValue;
+
+  @override
+  List<TripSummary> get tripList => tripListValue;
+
+  @override
+  bool get isTripDetailsLoading => isTripDetailsLoadingValue;
+
+  @override
+  List<String> get locoClasses => locoClassesValue;
+
+  @override
+  List<EventField> get eventFields => eventFieldsValue;
+
+  @override
+  bool get isEventFieldsLoading => isEventFieldsLoadingValue;
+
+  @override
+  int get pendingLocoCount => pendingLocoCountValue;
+
+  @override
+  double getMileageForCurrentYear() => currentYearMileageValue;
+
+  @override
+  Future<void> fetchHomepageStats() async {}
+
+  @override
+  Future<void> fetchOnThisDay({DateTime? date}) async {}
+
+  @override
+  Future<void> fetchTripDetails() async {}
+
+  @override
+  Future<void> fetchHadTraction({int offset = 0, int limit = 100}) async {}
+
+  @override
+  Future<void> fetchLatestLocoChanges({
+    int limit = 100,
+    int offset = 0,
+    bool append = false,
+  }) async {}
+
+  @override
+  Future<void> fetchClassClearanceProgress({
+    int offset = 0,
+    int limit = 20,
+    bool append = false,
+    bool onlyIncomplete = false,
+  }) async {}
+
+  @override
+  Future<void> fetchLegs({
+    int offset = 0,
+    int limit = 100,
+    String sortBy = 'date',
+    int sortDirection = 0,
+    String? dateRangeStart,
+    String? dateRangeEnd,
+    bool append = false,
+    bool unallocatedOnly = false,
+    List<String> networkFilter = const [],
+  }) async {}
+
+  @override
+  Future<List<TripLocoStat>> fetchTripLocoStats(int tripId) async {
+    return const [];
+  }
+
+  @override
+  Future<void> fetchTraction({
+    bool hadOnly = false,
+    int offset = 0,
+    int limit = 100,
+    String? locoClass,
+    String? locoNumber,
+    bool mileageFirst = true,
+    bool append = false,
+    Map<String, dynamic>? filters,
+  }) async {}
+
+  @override
+  Future<List<String>> fetchClassList({bool force = false}) async {
+    return locoClassesValue;
+  }
+
+  @override
+  Future<void> fetchEventFields({bool force = false}) async {}
+
+  @override
+  Future<void> fetchPendingLocoCount() async {}
+
+  @override
+  Future<void> fetchStationNetworks() async {}
+
+  @override
+  Future<Map<String, dynamic>?> fetchClassStats(String locoClass) async {
+    return TestData.classStats;
+  }
+
+  @override
+  Future<List<LeaderboardEntry>> fetchClassLeaderboard(
+    String locoClass, {
+    bool friends = false,
+  }) async {
+    return TestData.classLeaderboard;
+  }
+}
+
+class FakeDistanceUnitService extends DistanceUnitService {
+  FakeDistanceUnitService({this.unitOverride});
+
+  final DistanceUnit? unitOverride;
+
+  @override
+  DistanceUnit get unit => unitOverride ?? super.unit;
+
+  @override
+  String format(
+    double miles, {
+    int decimals = 1,
+    bool includeUnit = true,
+  }) {
+    final formatter = DistanceFormatter(unitOverride ?? super.unit);
+    return formatter.format(miles, decimals: decimals, includeUnit: includeUnit);
+  }
+}

test/helpers/test_app.dart

@@ -0,0 +1,42 @@
+import 'package:flutter/material.dart';
+import 'package:go_router/go_router.dart';
+import 'package:mileograph_flutter/services/authservice.dart';
+import 'package:mileograph_flutter/services/data_service.dart';
+import 'package:mileograph_flutter/services/distance_unit_service.dart';
+import 'package:provider/provider.dart';
+
+Widget buildTestApp({
+  required Widget child,
+  required DataService dataService,
+  required AuthService authService,
+  DistanceUnitService? distanceUnitService,
+}) {
+  return MultiProvider(
+    providers: [
+      ChangeNotifierProvider<AuthService>.value(value: authService),
+      ChangeNotifierProvider<DataService>.value(value: dataService),
+      ChangeNotifierProvider<DistanceUnitService>.value(
+        value: distanceUnitService ?? DistanceUnitService(),
+      ),
+    ],
+    child: MaterialApp(home: child),
+  );
+}
+
+Widget buildTestRouterApp({
+  required GoRouter router,
+  required DataService dataService,
+  required AuthService authService,
+  DistanceUnitService? distanceUnitService,
+}) {
+  return MultiProvider(
+    providers: [
+      ChangeNotifierProvider<AuthService>.value(value: authService),
+      ChangeNotifierProvider<DataService>.value(value: dataService),
+      ChangeNotifierProvider<DistanceUnitService>.value(
+        value: distanceUnitService ?? DistanceUnitService(),
+      ),
+    ],
+    child: MaterialApp.router(routerConfig: router),
+  );
+}

test/helpers/test_data.dart

@@ -0,0 +1,328 @@
+import 'package:mileograph_flutter/objects/objects.dart';
+
+class TestData {
+  static final user = UserData(
+    username: 'railfan',
+    fullName: 'Alex Rider',
+    userId: 'user-123',
+    email: 'alex@example.com',
+    entriesVisibility: 'public',
+    mileageVisibility: 'public',
+    elevated: true,
+    disabled: false,
+  );
+
+  static final topLocos = [
+    LocoSummary(
+      locoId: 100,
+      locoType: 'D',
+      locoNumber: '001',
+      locoName: 'Atlas',
+      locoClass: '67',
+      locoOperator: 'TestRail',
+      mileage: 1200.5,
+      journeys: 18,
+      trips: 6,
+      status: 'Active',
+      domain: 'mainline',
+      owner: 'TestRail',
+      livery: 'Blue',
+      location: 'Depot',
+    ),
+    LocoSummary(
+      locoId: 101,
+      locoType: 'D',
+      locoNumber: '002',
+      locoName: 'Orion',
+      locoClass: '68',
+      locoOperator: 'TestRail',
+      mileage: 980.2,
+      journeys: 12,
+      trips: 4,
+      status: 'Active',
+      domain: 'mainline',
+      owner: 'TestRail',
+      livery: 'Orange',
+      location: 'Central',
+    ),
+  ];
+
+  static final leaderboard = [
+    LeaderboardEntry(
+      userId: 'u1',
+      username: 'driver_one',
+      userFullName: 'Driver One',
+      mileage: 3456.7,
+    ),
+    LeaderboardEntry(
+      userId: 'u2',
+      username: 'driver_two',
+      userFullName: 'Driver Two',
+      mileage: 2999.1,
+    ),
+  ];
+
+  static final tripSummaries = [
+    TripSummary(
+      tripId: 1,
+      tripName: 'North Run',
+      tripMileage: 220.4,
+      legCount: 3,
+      locoStats: [
+        TripLocoStat(locoClass: '67', number: '001', won: true),
+        TripLocoStat(locoClass: '68', number: '002', won: false),
+      ],
+      startDate: DateTime(2023, 10, 11),
+      endDate: DateTime(2023, 10, 13),
+    ),
+    TripSummary(
+      tripId: 2,
+      tripName: 'Harbor Loop',
+      tripMileage: 85.6,
+      legCount: 1,
+      locoStats: const [],
+      startDate: DateTime(2023, 11, 5),
+      endDate: DateTime(2023, 11, 5),
+    ),
+  ];
+
+  static final tripDetails = [
+    TripDetail(
+      id: 1,
+      name: 'North Run',
+      mileage: 220.4,
+      legCount: 3,
+      locoStats: [
+        TripLocoStat(locoClass: '67', number: '001', won: true),
+      ],
+      legs: [
+        TripLeg(
+          id: 10,
+          start: 'London',
+          end: 'Leeds',
+          beginTime: DateTime(2023, 10, 11, 9, 15),
+          network: 'National',
+          route: 'London → Leeds',
+          mileage: 185.2,
+          notes: 'Clear run',
+          locos: [
+            Loco(
+              id: 100,
+              type: 'D',
+              number: '001',
+              name: 'Atlas',
+              locoClass: '67',
+              operator: 'TestRail',
+              notes: '',
+              evn: '',
+            ),
+          ],
+        ),
+      ],
+    ),
+  ];
+
+  static final legs = [
+    Leg(
+      id: 501,
+      tripId: 1,
+      start: 'London',
+      end: 'Oxford',
+      beginTime: DateTime(2023, 9, 12, 7, 45),
+      timezone: 0,
+      network: 'National',
+      route: ['London', 'Oxford'],
+      mileage: 62.3,
+      notes: 'Morning service',
+      headcode: '1A00',
+      driving: 0,
+      user: 'railfan',
+      locos: [
+        Loco(
+          id: 100,
+          type: 'D',
+          number: '001',
+          name: 'Atlas',
+          locoClass: '67',
+          operator: 'TestRail',
+          notes: '',
+          evn: '',
+        ),
+      ],
+    ),
+    Leg(
+      id: 502,
+      tripId: 2,
+      start: 'Oxford',
+      end: 'Bristol',
+      beginTime: DateTime(2023, 9, 13, 16, 10),
+      timezone: 0,
+      network: 'National',
+      route: ['Oxford', 'Bristol'],
+      mileage: 74.8,
+      notes: 'Evening run',
+      headcode: '1B10',
+      driving: 0,
+      user: 'railfan',
+      locos: [
+        Loco(
+          id: 101,
+          type: 'D',
+          number: '002',
+          name: 'Orion',
+          locoClass: '68',
+          operator: 'TestRail',
+          notes: '',
+          evn: '',
+        ),
+      ],
+    ),
+  ];
+
+  static List<Leg> onThisDayLegs() {
+    final pastYear = DateTime.now().year - 1;
+    return [
+      Leg(
+        id: 900,
+        tripId: 3,
+        start: 'York',
+        end: 'Durham',
+        beginTime: DateTime(pastYear, 7, 4, 10, 30),
+        timezone: 0,
+        network: 'National',
+        route: ['York', 'Durham'],
+        mileage: 60.0,
+        notes: 'Anniversary run',
+        headcode: '1C11',
+        driving: 0,
+        user: 'railfan',
+        locos: [
+          Loco(
+            id: 102,
+            type: 'D',
+            number: '003',
+            name: 'Nova',
+            locoClass: '66',
+            operator: 'TestRail',
+            notes: '',
+            evn: '',
+          ),
+        ],
+      ),
+    ];
+  }
+
+  static final latestLocoChanges = [
+    LocoChange(
+      locoId: 200,
+      locoClass: '67',
+      locoNumber: '001',
+      locoName: 'Atlas',
+      attrCode: 'loco_status',
+      attrDisplay: 'Status',
+      valueDisplay: 'Active',
+      validFrom: DateTime(2023, 10, 1),
+      approvedAt: DateTime(2023, 10, 2),
+      approvedBy: 'moderator',
+    ),
+  ];
+
+  static final classClearance = [
+    ClassClearanceProgress(
+      className: 'Class 67',
+      completed: 12,
+      total: 30,
+      percentComplete: 40.0,
+      activeCompleted: 8,
+      activeTotal: 20,
+      activePercent: 40.0,
+    ),
+  ];
+
+  static final traction = [
+    LocoSummary(
+      locoId: 100,
+      locoType: 'D',
+      locoNumber: '001',
+      locoName: 'Atlas',
+      locoClass: '67',
+      locoOperator: 'TestRail',
+      mileage: 1200.5,
+      journeys: 18,
+      trips: 6,
+      status: 'Active',
+      domain: 'mainline',
+      owner: 'TestRail',
+      livery: 'Blue',
+      location: 'Depot',
+    ),
+    LocoSummary(
+      locoId: 101,
+      locoType: 'D',
+      locoNumber: '002',
+      locoName: 'Orion',
+      locoClass: '68',
+      locoOperator: 'TestRail',
+      mileage: 980.2,
+      journeys: 12,
+      trips: 4,
+      status: 'Active',
+      domain: 'mainline',
+      owner: 'TestRail',
+      livery: 'Orange',
+      location: 'Central',
+    ),
+  ];
+
+  static final eventFields = [
+    const EventField(name: 'power_unit', display: 'Power Unit', type: 'text'),
+    const EventField(
+      name: 'cab_air_conditioning',
+      display: 'Cab A/C',
+      enumValues: ['Yes', 'No'],
+    ),
+  ];
+
+  static final classStats = <String, dynamic>{
+    'loco_class': '67',
+    'total_mileage_with_class': 5500.5,
+    'avg_mileage_per_entry': 80.2,
+    'avg_mileage_per_loco_had': 420.0,
+    'had_count': 12,
+    'entries_with_class': 42,
+    'class_stats': {
+      'total': 30,
+      'status': [
+        {'status': 'Active', 'count': 18},
+        {'status': 'Stored', 'count': 12},
+      ],
+      'domain': [
+        {'domain': 'mainline', 'count': 20},
+        {'domain': 'heritage', 'count': 10},
+      ],
+    },
+  };
+
+  static final classLeaderboard = [
+    LeaderboardEntry(
+      userId: 'u3',
+      username: 'fan_three',
+      userFullName: 'Fan Three',
+      mileage: 1500.0,
+    ),
+  ];
+
+  static final homepageStats = HomepageStats(
+    totalMileage: 4523.8,
+    yearlyMileage: [
+      YearlyMileage(year: DateTime.now().year, mileage: 1200.5),
+      YearlyMileage(year: DateTime.now().year - 1, mileage: 990.2),
+    ],
+    topLocos: topLocos,
+    leaderboard: leaderboard,
+    friendsLeaderboard: leaderboard,
+    trips: tripSummaries,
+    legCount: 27,
+    user: user,
+  );
+}

test/pages/dashboard_page_test.dart

@@ -0,0 +1,84 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:go_router/go_router.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+
+import 'package:mileograph_flutter/components/pages/dashboard.dart';
+
+import '../helpers/fake_services.dart';
+import '../helpers/test_app.dart';
+import '../helpers/test_data.dart';
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+
+  setUpAll(() {
+    SharedPreferences.setMockInitialValues({});
+  });
+
+  testWidgets('Dashboard renders stats and panels', (tester) async {
+    final data = FakeDataService()
+      ..homepageStatsValue = TestData.homepageStats
+      ..tripsValue = TestData.tripSummaries
+      ..onThisDayValue = TestData.onThisDayLegs()
+      ..classClearanceProgressValue = TestData.classClearance
+      ..latestLocoChangesValue = TestData.latestLocoChanges
+      ..tractionValue = TestData.traction
+      ..currentYearMileageValue = 1200.5;
+    final auth = FakeAuthService(api: FakeApiService());
+    final router = GoRouter(
+      routes: [
+        GoRoute(
+          path: '/',
+          builder: (context, state) => const Dashboard(),
+        ),
+      ],
+    );
+
+    await tester.pumpWidget(
+      buildTestRouterApp(
+        router: router,
+        dataService: data,
+        authService: auth,
+      ),
+    );
+    await tester.pumpAndSettle();
+
+    expect(find.text('Dashboard'), findsOneWidget);
+    expect(find.textContaining('Welcome back, Alex Rider'), findsOneWidget);
+    expect(find.text('Top traction'), findsOneWidget);
+    expect(find.text('67 001'), findsOneWidget);
+    expect(find.text('On this day'), findsOneWidget);
+    expect(find.text('York → Durham'), findsOneWidget);
+    expect(find.text('Latest Loco Changes'), findsOneWidget);
+    expect(find.text('Status'), findsWidgets);
+    expect(find.text('Active'), findsWidgets);
+  });
+
+  testWidgets('Dashboard shows loading overlay without stats', (tester) async {
+    final data = FakeDataService()
+      ..homepageStatsValue = null
+      ..isHomepageLoadingValue = true;
+    final auth = FakeAuthService(api: FakeApiService());
+    final router = GoRouter(
+      routes: [
+        GoRoute(
+          path: '/',
+          builder: (context, state) => const Dashboard(),
+        ),
+      ],
+    );
+
+    await tester.pumpWidget(
+      buildTestRouterApp(
+        router: router,
+        dataService: data,
+        authService: auth,
+      ),
+    );
+    await tester.pump();
+
+    expect(find.text('Loading dashboard data...'), findsOneWidget);
+    expect(find.byType(CircularProgressIndicator), findsWidgets);
+  });
+}

test/pages/entries_page_test.dart

@@ -0,0 +1,60 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+
+import 'package:mileograph_flutter/components/pages/legs.dart';
+import 'package:mileograph_flutter/services/distance_unit_service.dart';
+
+import '../helpers/fake_services.dart';
+import '../helpers/test_app.dart';
+import '../helpers/test_data.dart';
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+
+  setUpAll(() {
+    SharedPreferences.setMockInitialValues({});
+  });
+
+  testWidgets('Entries page shows legs and mileage summary', (tester) async {
+    final data = FakeDataService()..legsValue = TestData.legs;
+    final auth = FakeAuthService(api: FakeApiService());
+    final distanceUnits = FakeDistanceUnitService(
+      unitOverride: DistanceUnit.milesDecimal,
+    );
+
+    await tester.pumpWidget(
+      buildTestApp(
+        child: const LegsPage(),
+        dataService: data,
+        authService: auth,
+        distanceUnitService: distanceUnits,
+      ),
+    );
+    await tester.pumpAndSettle();
+
+    expect(find.text('Entries'), findsOneWidget);
+    expect(find.text('Page mileage'), findsOneWidget);
+    expect(find.textContaining('mi'), findsWidgets);
+    expect(find.text('London'), findsOneWidget);
+    expect(find.text('Oxford'), findsOneWidget);
+  });
+
+  testWidgets('Entries page shows empty state', (tester) async {
+    final data = FakeDataService()
+      ..legsValue = []
+      ..isLegsLoadingValue = false;
+    final auth = FakeAuthService(api: FakeApiService());
+
+    await tester.pumpWidget(
+      buildTestApp(
+        child: const LegsPage(),
+        dataService: data,
+        authService: auth,
+      ),
+    );
+    await tester.pumpAndSettle();
+
+    expect(find.text('No entries found'), findsOneWidget);
+    expect(find.text('Adjust the filters or add a new leg.'), findsOneWidget);
+  });
+}

test/pages/traction_page_test.dart

@@ -0,0 +1,114 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:go_router/go_router.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+
+import 'package:mileograph_flutter/components/pages/traction.dart';
+
+import '../helpers/fake_services.dart';
+import '../helpers/test_app.dart';
+import '../helpers/test_data.dart';
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+
+  setUpAll(() {
+    SharedPreferences.setMockInitialValues({});
+  });
+
+  testWidgets('Traction page shows list data', (tester) async {
+    final data = FakeDataService()
+      ..tractionValue = TestData.traction
+      ..locoClassesValue = ['67', '68']
+      ..eventFieldsValue = TestData.eventFields;
+    final auth = FakeAuthService(api: FakeApiService(), isElevatedValue: true);
+    final router = GoRouter(
+      routes: [
+        GoRoute(
+          path: '/',
+          builder: (context, state) => const TractionPage(),
+        ),
+      ],
+    );
+
+    await tester.pumpWidget(
+      buildTestRouterApp(
+        router: router,
+        dataService: data,
+        authService: auth,
+      ),
+    );
+    await tester.pumpAndSettle();
+
+    expect(find.text('Traction'), findsOneWidget);
+    expect(find.text('67'), findsWidgets);
+    expect(find.text('001'), findsWidgets);
+  });
+
+  testWidgets('Traction page shows export when class filter set', (tester) async {
+    final data = FakeDataService()
+      ..tractionValue = TestData.traction
+      ..locoClassesValue = ['67', '68']
+      ..eventFieldsValue = TestData.eventFields;
+    final auth = FakeAuthService(api: FakeApiService(), isElevatedValue: true);
+    final router = GoRouter(
+      routes: [
+        GoRoute(
+          path: '/',
+          builder: (context, state) => const TractionPage(),
+        ),
+      ],
+    );
+
+    await tester.pumpWidget(
+      buildTestRouterApp(
+        router: router,
+        dataService: data,
+        authService: auth,
+      ),
+    );
+    await tester.pumpAndSettle();
+
+    expect(find.textContaining('Export'), findsNothing);
+
+    final classField = find.byWidgetPredicate(
+      (widget) =>
+          widget is TextField && widget.decoration?.labelText == 'Class',
+    );
+    await tester.enterText(classField, '67');
+    await tester.pump();
+
+    expect(find.text('Export 67'), findsOneWidget);
+  });
+
+  testWidgets('Traction page shows admin import option', (tester) async {
+    final data = FakeDataService()
+      ..tractionValue = TestData.traction
+      ..locoClassesValue = ['67', '68']
+      ..eventFieldsValue = TestData.eventFields
+      ..pendingLocoCountValue = 2;
+    final auth = FakeAuthService(api: FakeApiService(), isElevatedValue: true);
+    final router = GoRouter(
+      routes: [
+        GoRoute(
+          path: '/',
+          builder: (context, state) => const TractionPage(),
+        ),
+      ],
+    );
+
+    await tester.pumpWidget(
+      buildTestRouterApp(
+        router: router,
+        dataService: data,
+        authService: auth,
+      ),
+    );
+    await tester.pumpAndSettle();
+
+    await tester.tap(find.byType(PopupMenuButton));
+    await tester.pumpAndSettle();
+
+    expect(find.text('Import traction'), findsOneWidget);
+  });
+}

test/pages/trips_page_test.dart

@@ -0,0 +1,64 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+
+import 'package:mileograph_flutter/components/pages/trips.dart';
+import 'package:mileograph_flutter/services/distance_unit_service.dart';
+
+import '../helpers/fake_services.dart';
+import '../helpers/test_app.dart';
+import '../helpers/test_data.dart';
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+
+  setUpAll(() {
+    SharedPreferences.setMockInitialValues({});
+  });
+
+  testWidgets('Trips page shows trip details', (tester) async {
+    final data = FakeDataService()
+      ..tripDetailsValue = TestData.tripDetails
+      ..tripListValue = TestData.tripSummaries;
+    final auth = FakeAuthService(api: FakeApiService());
+    final distanceUnits = FakeDistanceUnitService(
+      unitOverride: DistanceUnit.milesDecimal,
+    );
+
+    await tester.pumpWidget(
+      buildTestApp(
+        child: const TripsPage(),
+        dataService: data,
+        authService: auth,
+        distanceUnitService: distanceUnits,
+      ),
+    );
+    await tester.pumpAndSettle();
+
+    expect(find.text('Trips'), findsOneWidget);
+    expect(find.text('North Run'), findsOneWidget);
+    expect(find.textContaining('mi'), findsWidgets);
+  });
+
+  testWidgets('Trips page shows empty state', (tester) async {
+    final data = FakeDataService()
+      ..tripDetailsValue = []
+      ..tripListValue = []
+      ..isTripDetailsLoadingValue = false;
+    final auth = FakeAuthService(api: FakeApiService());
+
+    await tester.pumpWidget(
+      buildTestApp(
+        child: const TripsPage(),
+        dataService: data,
+        authService: auth,
+      ),
+    );
+    await tester.pumpAndSettle();
+
+    expect(find.text('No trips yet'), findsOneWidget);
+    expect(
+      find.text('Use the Add entry flow to start grouping legs into trips.'),
+      findsOneWidget,
+    );
+  });
+}