make carousel more stable

.gitea/workflows/release.yml

@@ -18,7 +18,7 @@ env:
 jobs:
   meta:
     runs-on:
-      - mileograph
+      - tgj-arc
     outputs:
       base_version: ${{ steps.meta.outputs.base }}
       release_tag: ${{ steps.meta.outputs.release_tag }}
@@ -317,7 +317,7 @@ jobs:
 
   release-dev:
     runs-on:
-      - mileograph
+      - tgj-arc
     needs:
       - meta
       - android-build
@@ -423,7 +423,7 @@ jobs:
 
   release-master:
     runs-on:
-      - mileograph
+      - tgj-arc
     needs:
       - meta
       - android-build

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/dashboard/leaderboard_panel.dart

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:go_router/go_router.dart';
+import 'package:mileograph_flutter/components/widgets/animated_count_text.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';
@@ -136,11 +137,10 @@ class _LeaderboardPanelState extends State<LeaderboardPanel> {
                         crossAxisAlignment: WrapCrossAlignment.center,
                         spacing: 8,
                         children: [
-                          Text(
-                            distanceUnits.format(
-                              leaderboard[index].mileage,
-                              decimals: 1,
-                            ),
+                          AnimatedCountText(
+                            value: leaderboard[index].mileage,
+                            formatter: (val) =>
+                                distanceUnits.format(val, decimals: 1),
                             style: textTheme.labelLarge?.copyWith(
                               fontWeight: FontWeight.w700,
                             ),

lib/components/dashboard/top_traction_panel.dart

@@ -1,4 +1,5 @@
 import 'package:flutter/material.dart';
+import 'package:mileograph_flutter/components/widgets/animated_count_text.dart';
 import 'package:mileograph_flutter/services/data_service.dart';
 import 'package:mileograph_flutter/services/distance_unit_service.dart';
 import 'package:provider/provider.dart';
@@ -78,11 +79,10 @@ class TopTractionPanel extends StatelessWidget {
                                 fontStyle: FontStyle.italic,
                               ),
                       ),
-                      trailing: Text(
-                        distanceUnits.format(
-                          locos[index].mileage ?? 0,
-                          decimals: 1,
-                        ),
+                      trailing: AnimatedCountText(
+                        value: (locos[index].mileage ?? 0).toDouble(),
+                        formatter: (val) =>
+                            distanceUnits.format(val, decimals: 1),
                         style: textTheme.labelLarge?.copyWith(
                           fontWeight: FontWeight.w700,
                         ),

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,99 @@ 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,
+                      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(),
+                            ),
+                          );
+                        },
                       ),
-                    ),
-                  ],
-                  style: const TextStyle(
-                    decoration: TextDecoration.none,
-                    color: Colors.white,
-                    fontFamily: "Tomatoes",
-                    fontSize: 50,
+                      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,
+                            ),
+                          ],
+                        ),
+                      ],
+                    ],
                   ),
                 ),
               ),
-              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 +144,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/badges.dart

@@ -449,6 +449,23 @@ class _BadgesPageState extends State<BadgesPage> {
     ClassClearanceProgress progress,
   ) {
     final pct = progress.percentComplete.clamp(0, 100);
+    final activePct = progress.activePercent.clamp(0, 100);
+    final showActive =
+        progress.activeTotal > 0 || progress.activeCompleted > 0;
+    final showActiveCrest =
+        progress.activeTotal > 0 && progress.activeCompleted == progress.activeTotal;
+    final scheme = Theme.of(context).colorScheme;
+    final total = progress.total;
+    final activeTotal = progress.activeTotal.clamp(0, total);
+    final had = progress.completed.clamp(0, total);
+    final activeHad = progress.activeCompleted.clamp(0, activeTotal).clamp(0, had);
+    final activeRemaining =
+        (activeTotal - activeHad).clamp(0, total - had);
+    final remaining =
+        (total - activeTotal - (had - activeHad)).clamp(0, total);
+    final hadColor = scheme.primary;
+    final activeColor = scheme.primary.withValues(alpha: 0.4);
+    final remainingColor = scheme.primary.withValues(alpha: 0.18);
     return Card(
       margin: const EdgeInsets.symmetric(vertical: 4.0),
       child: Padding(
@@ -471,9 +488,55 @@ class _BadgesPageState extends State<BadgesPage> {
               ],
             ),
             const SizedBox(height: 4),
-            LinearProgressIndicator(
-              value: progress.total == 0 ? 0 : pct / 100,
-              minHeight: 6,
+            if (showActive)
+              Padding(
+                padding: const EdgeInsets.only(bottom: 6.0),
+                child: Row(
+                  children: [
+                    Text(
+                      'Active: ${progress.activeCompleted}/${progress.activeTotal} (${activePct.toStringAsFixed(0)}%)',
+                      style: Theme.of(context)
+                          .textTheme
+                          .labelSmall
+                          ?.copyWith(color: Theme.of(context).hintColor),
+                    ),
+                    if (showActiveCrest) ...[
+                      const SizedBox(width: 6),
+                      Icon(
+                        Icons.verified,
+                        size: 14,
+                        color: scheme.primary,
+                      ),
+                    ],
+                  ],
+                ),
+              ),
+            ClipRRect(
+              borderRadius: BorderRadius.circular(6),
+              child: SizedBox(
+                height: 6,
+                child: total <= 0
+                    ? Container(color: remainingColor)
+                    : Row(
+                        children: [
+                          if (had > 0)
+                            Expanded(
+                              flex: had,
+                              child: Container(color: hadColor),
+                            ),
+                          if (showActive && activeRemaining > 0)
+                            Expanded(
+                              flex: activeRemaining,
+                              child: Container(color: activeColor),
+                            ),
+                          if (remaining > 0)
+                            Expanded(
+                              flex: remaining,
+                              child: Container(color: remainingColor),
+                            ),
+                        ],
+                      ),
+              ),
             ),
             if (progress.total > 0)
               Padding(

lib/components/pages/dashboard.dart

@@ -1,9 +1,13 @@
+import 'dart:async';
+import 'dart:math';
+
 import 'package:flutter/material.dart';
 import 'package:go_router/go_router.dart';
 import 'package:intl/intl.dart';
 import 'package:mileograph_flutter/components/dashboard/latest_loco_changes_panel.dart';
 import 'package:mileograph_flutter/components/dashboard/leaderboard_panel.dart';
 import 'package:mileograph_flutter/components/dashboard/top_traction_panel.dart';
+import 'package:mileograph_flutter/components/widgets/animated_count_text.dart';
 import 'package:mileograph_flutter/objects/objects.dart';
 import 'package:mileograph_flutter/services/authservice.dart';
 import 'package:mileograph_flutter/services/data_service.dart';
@@ -19,6 +23,18 @@ class Dashboard extends StatefulWidget {
 
 class _DashboardState extends State<Dashboard> {
   bool _showAllOnThisDay = false;
+  bool _isCurrent = false;
+  Timer? _carouselTimer;
+  int _carouselIndex = 0;
+  int _carouselItemCount = 0;
+  final Random _carouselRandom = Random();
+  List<ClassClearanceProgress> _carouselItems = const [];
+  String _carouselSignature = '';
+
+  @override
+  void initState() {
+    super.initState();
+  }
 
   @override
   Widget build(BuildContext context) {
@@ -31,16 +47,11 @@ class _DashboardState extends State<Dashboard> {
 
     return RefreshIndicator(
       onRefresh: () async {
-        await data.fetchHomepageStats();
-        await Future.wait([
-          data.fetchOnThisDay(),
-          data.fetchTripDetails(),
-          data.fetchHadTraction(),
-          data.fetchLatestLocoChanges(),
-        ]);
+        await _refreshDashboardData(force: true);
       },
       child: LayoutBuilder(
         builder: (context, constraints) {
+          _handleRouteFocus();
           const spacing = 16.0;
           final maxWidth = constraints.maxWidth;
           return Stack(
@@ -97,9 +108,6 @@ class _DashboardState extends State<Dashboard> {
     final totalMileage = stats?.totalMileage ?? 0;
     final currentYearMileage = data.getMileageForCurrentYear();
     final legCount = stats?.legCount ?? data.trips.length;
-    final progress = totalMileage == 0
-        ? 0.0
-        : (currentYearMileage / totalMileage).clamp(0, 1).toDouble();
 
     return Card(
       clipBehavior: Clip.antiAlias,
@@ -125,62 +133,248 @@ class _DashboardState extends State<Dashboard> {
               spacing: 12,
               runSpacing: 12,
               children: [
-                _metricTile(
+                _animatedMetricTile(
                   context,
                   label: 'Total mileage',
-                  value: distanceUnits.format(totalMileage, decimals: 1),
+                  value: totalMileage.toDouble(),
+                  formatter: (val) =>
+                      distanceUnits.format(val, decimals: 1),
                   icon: Icons.route,
                   color: colorScheme.onPrimaryContainer,
                 ),
-                _metricTile(
+                _animatedMetricTile(
                   context,
                   label: 'This year',
-                  value: distanceUnits.format(currentYearMileage, decimals: 1),
+                  value: currentYearMileage.toDouble(),
+                  formatter: (val) =>
+                      distanceUnits.format(val, decimals: 1),
                   icon: Icons.calendar_today,
                   color: colorScheme.onPrimaryContainer,
                 ),
-                _metricTile(
+                _animatedMetricTile(
                   context,
                   label: 'Entries logged',
-                  value: legCount.toString(),
+                  value: legCount.toDouble(),
+                  formatter: (val) => val.round().toString(),
                   icon: Icons.format_list_bulleted,
                   color: colorScheme.onPrimaryContainer,
                 ),
               ],
             ),
             const SizedBox(height: 16),
-            ClipRRect(
-              borderRadius: BorderRadius.circular(12),
-              child: LinearProgressIndicator(
-                value: progress.isNaN ? 0 : progress,
-                minHeight: 10,
-                backgroundColor: colorScheme.onPrimaryContainer.withValues(
-                  alpha: 0.2,
-                ),
-                valueColor: AlwaysStoppedAnimation<Color>(
-                  colorScheme.onPrimaryContainer,
-                ),
-              ),
-            ),
-            const SizedBox(height: 6),
-            Text(
-              totalMileage == 0
-                  ? 'Log a new entry to start your timeline.'
-                  : 'Year-to-date is ${(progress * 100).toStringAsFixed(0)}% of all mileage.',
-              style: Theme.of(context).textTheme.labelSmall?.copyWith(
-                color: colorScheme.onPrimaryContainer.withValues(alpha: 0.8),
-              ),
-            ),
+            _buildClassClearanceCarousel(context, data, colorScheme),
           ],
         ),
       ),
     );
   }
 
-  Widget _metricTile(
+  Widget _buildClassClearanceCarousel(
+    BuildContext context,
+    DataService data,
+    ColorScheme colorScheme,
+  ) {
+    final items = data.classClearanceProgress;
+    final loading = data.isClassClearanceProgressLoading;
+    _refreshCarouselItems(items);
+    _startCarouselIfNeeded(_carouselItems.length);
+
+    if (loading && _carouselItems.isEmpty) {
+      return const Padding(
+        padding: EdgeInsets.symmetric(vertical: 8.0),
+        child: Center(
+          child: SizedBox(
+            height: 16,
+            width: 16,
+            child: CircularProgressIndicator(strokeWidth: 2),
+          ),
+        ),
+      );
+    }
+
+    if (_carouselItems.isEmpty) {
+      return Text(
+        'No class clearance progress yet.',
+        style: Theme.of(context).textTheme.labelSmall?.copyWith(
+              color: colorScheme.onPrimaryContainer.withValues(alpha: 0.8),
+            ),
+      );
+    }
+
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        Text(
+          'Class clearance (in progress)',
+          style: Theme.of(context).textTheme.labelSmall?.copyWith(
+                color: colorScheme.onPrimaryContainer.withValues(alpha: 0.8),
+              ),
+        ),
+        const SizedBox(height: 6),
+        SizedBox(
+          height: 58,
+          child: AnimatedSwitcher(
+            duration: const Duration(milliseconds: 450),
+            switchInCurve: Curves.easeOutCubic,
+            switchOutCurve: Curves.easeInCubic,
+            transitionBuilder: (child, animation) {
+              final tween = Tween<Offset>(
+                begin: const Offset(0, 0.4),
+                end: Offset.zero,
+              );
+              return ClipRect(
+                child: SlideTransition(
+                  position: animation.drive(tween),
+                  child: FadeTransition(opacity: animation, child: child),
+                ),
+              );
+            },
+            child: _buildClassClearanceSlide(
+              context,
+              _carouselItems[_carouselIndex % _carouselItems.length],
+              colorScheme,
+              key: ValueKey(_carouselIndex),
+            ),
+          ),
+        ),
+      ],
+    );
+  }
+
+  Widget _buildClassClearanceSlide(
+    BuildContext context,
+    ClassClearanceProgress progress,
+    ColorScheme colorScheme,
+    {Key? key}
+  ) {
+    final pct = progress.percentComplete.clamp(0, 100);
+    final textTheme = Theme.of(context).textTheme;
+    final ratio = progress.total == 0
+        ? 0.0
+        : (progress.completed / progress.total).clamp(0.0, 1.0);
+    final activeRatio = progress.total == 0
+        ? 0.0
+        : (progress.activeTotal / progress.total).clamp(0.0, 1.0);
+    return TweenAnimationBuilder<double>(
+      key: key ?? ValueKey(progress.className),
+      tween: Tween(begin: 0, end: ratio),
+      duration: const Duration(milliseconds: 1200),
+      curve: Curves.easeOutCubic,
+      builder: (context, value, child) {
+        final ratioValue = ratio == 0 ? 0.0 : (value / ratio).clamp(0.0, 1.0);
+        final animatedHad = (progress.completed * ratioValue).round();
+        final animatedActive = (progress.activeTotal * ratioValue).round();
+        final animatedActiveRatio =
+            (activeRatio * ratioValue).clamp(0.0, activeRatio);
+        return Column(
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            Row(
+              children: [
+                Expanded(
+                  child: Text(
+                    progress.className,
+                    style: textTheme.labelLarge?.copyWith(
+                      color: colorScheme.onPrimaryContainer,
+                      fontWeight: FontWeight.w700,
+                    ),
+                    overflow: TextOverflow.ellipsis,
+                  ),
+                ),
+                const SizedBox(width: 8),
+                Text(
+                  '${pct.toStringAsFixed(0)}% • $animatedHad/$animatedActive/${progress.total}',
+                  style: textTheme.labelSmall?.copyWith(
+                    color: colorScheme.onPrimaryContainer
+                        .withValues(alpha: 0.8),
+                  ),
+                ),
+              ],
+            ),
+            const SizedBox(height: 6),
+            ClipRRect(
+              borderRadius: BorderRadius.circular(10),
+              child: SizedBox(
+                height: 8,
+                child: Stack(
+                  children: [
+                    Container(
+                      color: colorScheme.onPrimaryContainer.withValues(
+                        alpha: 0.2,
+                      ),
+                    ),
+                    FractionallySizedBox(
+                      alignment: Alignment.centerLeft,
+                      widthFactor: animatedActiveRatio.isNaN
+                          ? 0
+                          : animatedActiveRatio,
+                      child: Container(
+                        color:
+                            colorScheme.onPrimaryContainer.withValues(alpha: 0.5),
+                      ),
+                    ),
+                    FractionallySizedBox(
+                      alignment: Alignment.centerLeft,
+                      widthFactor: value.isNaN ? 0 : value,
+                      child: Container(
+                        color: colorScheme.onPrimaryContainer,
+                      ),
+                    ),
+                  ],
+                ),
+              ),
+            ),
+          ],
+        );
+      },
+    );
+  }
+
+  void _startCarouselIfNeeded(int count) {
+    if (count <= 1) {
+      _stopCarousel();
+      return;
+    }
+    if (_carouselItemCount != count) {
+      _carouselItemCount = count;
+      _carouselIndex = 0;
+    }
+    if (_carouselTimer != null) return;
+    _carouselTimer = Timer.periodic(const Duration(seconds: 8), (_) {
+      if (!mounted || _carouselItemCount == 0) return;
+      setState(() {
+        _carouselIndex = (_carouselIndex + 1) % _carouselItemCount;
+      });
+    });
+  }
+
+  void _stopCarousel() {
+    _carouselTimer?.cancel();
+    _carouselTimer = null;
+  }
+
+  void _refreshCarouselItems(List<ClassClearanceProgress> items) {
+    final signature = items
+        .map((item) =>
+            '${item.className}:${item.completed}:${item.activeTotal}:${item.total}')
+        .join('|');
+    if (signature == _carouselSignature) return;
+    _carouselSignature = signature;
+    _carouselItems = List<ClassClearanceProgress>.from(items)
+      ..shuffle(_carouselRandom);
+  }
+
+  @override
+  void dispose() {
+    _stopCarousel();
+    super.dispose();
+  }
+
+  Widget _animatedMetricTile(
     BuildContext context, {
     required String label,
-    required String value,
+    required double value,
+    required String Function(double) formatter,
     required IconData icon,
     required Color color,
   }) {
@@ -207,8 +401,9 @@ class _DashboardState extends State<Dashboard> {
                   letterSpacing: 0.4,
                 ),
               ),
-              Text(
-                value,
+              AnimatedCountText(
+                value: value,
+                formatter: formatter,
                 style: Theme.of(context).textTheme.titleMedium?.copyWith(
                   fontWeight: FontWeight.w800,
                   color: color,
@@ -555,8 +750,10 @@ class _DashboardState extends State<Dashboard> {
                               style: Theme.of(context).textTheme.titleSmall
                                   ?.copyWith(fontWeight: FontWeight.w700),
                             ),
-                            Text(
-                              distanceUnits.format(trip.tripMileage, decimals: 1),
+                            AnimatedCountText(
+                              value: trip.tripMileage,
+                              formatter: (val) =>
+                                  distanceUnits.format(val, decimals: 1),
                               style: Theme.of(context).textTheme.labelMedium,
                             ),
                           ],
@@ -573,4 +770,31 @@ class _DashboardState extends State<Dashboard> {
   String _formatTime(DateTime date) {
     return DateFormat('HH:mm').format(date);
   }
+
+  Future<void> _refreshDashboardData({bool force = false}) async {
+    final data = context.read<DataService>();
+    await data.fetchHomepageStats();
+    await Future.wait([
+      data.fetchOnThisDay(),
+      data.fetchTripDetails(),
+      data.fetchHadTraction(),
+      data.fetchLatestLocoChanges(),
+      data.fetchClassClearanceProgress(limit: 75, onlyIncomplete: true),
+    ]);
+  }
+
+  void _handleRouteFocus() {
+    final isCurrent = ModalRoute.of(context)?.isCurrent ?? true;
+    if (isCurrent && !_isCurrent) {
+      _isCurrent = true;
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        if (!mounted) return;
+        _refreshDashboardData();
+      });
+      return;
+    }
+    if (!isCurrent && _isCurrent) {
+      _isCurrent = false;
+    }
+  }
 }

lib/components/pages/profile.dart

@@ -1,3 +1,5 @@
+import 'dart:typed_data';
+
 import 'package:flutter/material.dart';
 import 'package:go_router/go_router.dart';
 import 'package:provider/provider.dart';
@@ -5,6 +7,7 @@ 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/utils/download_helper.dart';
 
 class ProfilePage extends StatefulWidget {
   const ProfilePage({super.key});
@@ -31,6 +34,10 @@ class _ProfilePageState extends State<ProfilePage> {
   bool _showAccountSettings = false;
   bool _changingPassword = false;
   static const List<String> _visibilityOptions = ['private', 'friends', 'public'];
+  static const List<String> _exportFormats = ['xlsx', 'json', 'csv'];
+  bool _exporting = false;
+  String _exportFormat = 'xlsx';
+  String? _exportError;
 
   UserSummary? _selectedUser;
   Friendship? _status;
@@ -71,6 +78,54 @@ class _ProfilePageState extends State<ProfilePage> {
     super.dispose();
   }
 
+  Future<void> _exportLogEntries() async {
+    if (_exporting) return;
+    setState(() {
+      _exporting = true;
+      _exportError = null;
+    });
+    try {
+      final data = context.read<DataService>();
+      final response = await data.api.getBytes(
+        '/legs/export?export_format=$_exportFormat',
+        headers: const {'accept': '*/*'},
+      );
+      final timestamp = DateTime.now()
+          .toIso8601String()
+          .replaceAll(':', '')
+          .replaceAll('.', '');
+      final fallbackName = 'log_entries_$timestamp.$_exportFormat';
+      final filename = response.filename ?? fallbackName;
+      final saveResult = await saveBytes(
+        Uint8List.fromList(response.bytes),
+        filename,
+        mimeType: response.contentType,
+      );
+      if (!mounted) return;
+      if (saveResult.canceled) {
+        ScaffoldMessenger.of(context).showSnackBar(
+          const SnackBar(content: Text('Export canceled.')),
+        );
+      } else {
+        final path = saveResult.path;
+        final message = path == null || path.isEmpty
+            ? 'Download started.'
+            : 'Export saved to $path';
+        ScaffoldMessenger.of(context).showSnackBar(
+          SnackBar(content: Text(message)),
+        );
+      }
+    } on ApiException catch (e) {
+      if (!mounted) return;
+      setState(() => _exportError = e.message);
+    } catch (e) {
+      if (!mounted) return;
+      setState(() => _exportError = e.toString());
+    } finally {
+      if (mounted) setState(() => _exporting = false);
+    }
+  }
+
   Future<void> _searchUsers() async {
     final query = _searchController.text.trim();
     if (query.isEmpty) {
@@ -829,6 +884,8 @@ class _ProfilePageState extends State<ProfilePage> {
               firstChild: Column(
                 crossAxisAlignment: CrossAxisAlignment.start,
                 children: [
+                  _buildExportSection(theme),
+                  const SizedBox(height: 12),
                   if (showPrivacySpinner)
                     const Padding(
                       padding: EdgeInsets.symmetric(vertical: 8.0),
@@ -1023,6 +1080,60 @@ class _ProfilePageState extends State<ProfilePage> {
     );
   }
 
+  Widget _buildExportSection(ThemeData theme) {
+    return ExpansionTile(
+      tilePadding: EdgeInsets.zero,
+      childrenPadding: const EdgeInsets.only(top: 8),
+      title: Text(
+        'Export log entries',
+        style: theme.textTheme.titleMedium?.copyWith(fontWeight: FontWeight.w700),
+      ),
+      subtitle: const Text('Download your log as a file.'),
+      children: [
+        DropdownButtonFormField<String>(
+          value: _exportFormat,
+          decoration: const InputDecoration(
+            labelText: 'Export format',
+            border: OutlineInputBorder(),
+          ),
+          items: _exportFormats
+              .map(
+                (format) => DropdownMenuItem(
+                  value: format,
+                  child: Text(format.toUpperCase()),
+                ),
+              )
+              .toList(),
+          onChanged: _exporting
+              ? null
+              : (value) {
+                  if (value == null) return;
+                  setState(() => _exportFormat = value);
+                },
+        ),
+        const SizedBox(height: 12),
+        FilledButton.icon(
+          onPressed: _exporting ? null : _exportLogEntries,
+          icon: _exporting
+              ? const SizedBox(
+                  width: 18,
+                  height: 18,
+                  child: CircularProgressIndicator(strokeWidth: 2),
+                )
+              : const Icon(Icons.download),
+          label: Text(_exporting ? 'Exporting...' : 'Export'),
+        ),
+        if (_exportError != null) ...[
+          const SizedBox(height: 8),
+          Text(
+            _exportError!,
+            style: TextStyle(color: theme.colorScheme.error),
+          ),
+        ],
+      ],
+    );
+  }
+
   UserSummary? _otherUser(Friendship friendship, String? currentUserId) {
     final selfId = currentUserId ?? '';
     if (friendship.requester?.userId == selfId) return friendship.addressee;

lib/components/pages/stats.dart

@@ -141,6 +141,7 @@ class _StatsPageState extends State<StatsPage> {
               ],
             ),
             const SizedBox(height: 8),
+            _buildTypeCountsSection(context, year),
             _buildSection<StatsClassMileage>(
               context,
               title: 'Top classes',
@@ -201,6 +202,83 @@ class _StatsPageState extends State<StatsPage> {
     );
   }
 
+  List<MapEntry<String, int>> _sortedTypeCounts(Map<String, int> counts) {
+    final entries = counts.entries.toList();
+    entries.sort((a, b) {
+      final countCompare = b.value.compareTo(a.value);
+      if (countCompare != 0) return countCompare;
+      return a.key.compareTo(b.key);
+    });
+    return entries;
+  }
+
+  Widget _buildTypeCountsSection(BuildContext context, StatsYear year) {
+    if (year.winnerTypeCounts.isEmpty && year.totalTypeCounts.isEmpty) {
+      return const SizedBox.shrink();
+    }
+    final theme = Theme.of(context);
+    return Padding(
+      padding: const EdgeInsets.only(top: 8),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          Text(
+            'Type counts',
+            style: theme.textTheme.titleMedium,
+          ),
+          const SizedBox(height: 6),
+          _buildTypeCountsRow(
+            context,
+            label: 'Winners',
+            counts: year.winnerTypeCounts,
+          ),
+          const SizedBox(height: 8),
+          _buildTypeCountsRow(
+            context,
+            label: 'Total',
+            counts: year.totalTypeCounts,
+          ),
+        ],
+      ),
+    );
+  }
+
+  Widget _buildTypeCountsRow(
+    BuildContext context, {
+    required String label,
+    required Map<String, int> counts,
+  }) {
+    final theme = Theme.of(context);
+    final entries = _sortedTypeCounts(counts);
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        Text(
+          label,
+          style: theme.textTheme.labelLarge,
+        ),
+        const SizedBox(height: 4),
+        if (entries.isEmpty)
+          Text(
+            'No data',
+            style: theme.textTheme.bodySmall,
+          )
+        else
+          Wrap(
+            spacing: 6,
+            runSpacing: 6,
+            children: entries
+                .map((entry) => _buildInfoChip(
+                      context,
+                      label: entry.key,
+                      value: _countFormat.format(entry.value),
+                    ))
+                .toList(),
+          ),
+      ],
+    );
+  }
+
   Widget _buildSection<T>(
     BuildContext context, {
     required String title,

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

@@ -5,6 +5,7 @@ enum _TractionMoreAction {
   classLeaderboard,
   adminPending,
   adminPendingChanges,
+  adminImport,
 }
 
 class TractionPage extends StatefulWidget {
@@ -74,6 +75,7 @@ class _TractionPageState extends State<TractionPage> {
   String? _lastQuerySignature;
   String? _transferFromLabel;
   bool _isSearching = false;
+  bool _classExporting = false;
 
   @override
   void initState() {
@@ -649,8 +651,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) {
@@ -668,6 +673,23 @@ class _TractionPageState extends State<TractionPage> {
     );
 
     final hasClassActions = _hasClassQuery;
+    final classLabel = _currentClassLabel;
+
+    final exportClassButton = !hasClassActions
+        ? null
+        : FilledButton.tonalIcon(
+            onPressed: _classExporting ? null : _exportSelectedClass,
+            icon: _classExporting
+                ? const SizedBox(
+                    height: 16,
+                    width: 16,
+                    child: CircularProgressIndicator(strokeWidth: 2),
+                  )
+                : const Icon(Icons.download),
+            label: Text(
+              _classExporting ? 'Exporting...' : 'Export $classLabel',
+            ),
+          );
 
     final newTractionButton = FilledButton.icon(
       onPressed: () async {
@@ -730,6 +752,9 @@ class _TractionPageState extends State<TractionPage> {
                     );
                   }
                   break;
+                case _TractionMoreAction.adminImport:
+                  await _showTractionImportSheet();
+                  break;
               }
             },
             itemBuilder: (context) {
@@ -793,6 +818,12 @@ class _TractionPageState extends State<TractionPage> {
                     child: Text('Pending changes'),
                   ),
                 );
+                items.add(
+                  const PopupMenuItem(
+                    value: _TractionMoreAction.adminImport,
+                    child: Text('Import traction'),
+                  ),
+                );
               }
               return items;
             },
@@ -816,12 +847,14 @@ class _TractionPageState extends State<TractionPage> {
 
     final desktopActions = [
       refreshButton,
+      if (exportClassButton != null) exportClassButton,
       newTractionButton,
       if (moreButton != null) moreButton,
     ];
 
     final mobileActions = [
       if (moreButton != null) moreButton,
+      if (exportClassButton != null) exportClassButton,
       newTractionButton,
       refreshButton,
     ];
@@ -849,6 +882,331 @@ class _TractionPageState extends State<TractionPage> {
     );
   }
 
+  Future<void> _exportSelectedClass() async {
+    if (_classExporting) return;
+    final classLabel = _currentClassLabel;
+    if (classLabel.isEmpty) return;
+    setState(() => _classExporting = true);
+    final messenger = ScaffoldMessenger.of(context);
+    try {
+      final data = context.read<DataService>();
+      final encodedClass = Uri.encodeComponent(classLabel);
+      final response = await data.api.getBytes(
+        '/loco/class/export/$encodedClass',
+        headers: const {'accept': '*/*'},
+      );
+      final safeClassName =
+          classLabel.replaceAll(RegExp(r'[^a-zA-Z0-9-_]+'), '_');
+      final fallbackName = 'traction-${safeClassName.isEmpty ? 'class' : safeClassName}.xlsx';
+      final filename = response.filename ?? fallbackName;
+      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(() => _classExporting = 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;

lib/components/widgets/animated_count_text.dart

@@ -0,0 +1,81 @@
+import 'package:flutter/material.dart';
+
+class AnimatedCountText extends StatefulWidget {
+  const AnimatedCountText({
+    super.key,
+    required this.value,
+    required this.formatter,
+    this.style,
+    this.duration = const Duration(milliseconds: 900),
+    this.curve = Curves.easeOutCubic,
+    this.animateFromZero = true,
+  });
+
+  final double value;
+  final String Function(double) formatter;
+  final TextStyle? style;
+  final Duration duration;
+  final Curve curve;
+  final bool animateFromZero;
+
+  @override
+  State<AnimatedCountText> createState() => _AnimatedCountTextState();
+}
+
+class _AnimatedCountTextState extends State<AnimatedCountText>
+    with SingleTickerProviderStateMixin {
+  late AnimationController _controller;
+  late Animation<double> _animation;
+  late CurvedAnimation _curve;
+  double _currentValue = 0;
+
+  @override
+  void initState() {
+    super.initState();
+    _currentValue = widget.animateFromZero ? 0 : widget.value;
+    _controller = AnimationController(vsync: this, duration: widget.duration);
+    _curve = CurvedAnimation(parent: _controller, curve: widget.curve);
+    _controller.addListener(_handleTick);
+    _configureAnimation(from: _currentValue, to: widget.value);
+    if (_currentValue != widget.value) {
+      _controller.forward();
+    }
+  }
+
+  @override
+  void didUpdateWidget(covariant AnimatedCountText oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    if (oldWidget.curve != widget.curve) {
+      _curve = CurvedAnimation(parent: _controller, curve: widget.curve);
+      _configureAnimation(from: _currentValue, to: widget.value);
+    }
+    if (oldWidget.value != widget.value) {
+      _controller.duration = widget.duration;
+      _configureAnimation(from: _currentValue, to: widget.value);
+      _controller.forward(from: 0);
+    }
+  }
+
+  void _configureAnimation({required double from, required double to}) {
+    _animation = Tween<double>(begin: from, end: to).animate(_curve);
+  }
+
+  void _handleTick() {
+    setState(() => _currentValue = _animation.value);
+  }
+
+  @override
+  void dispose() {
+    _controller.removeListener(_handleTick);
+    _controller.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Text(
+      widget.formatter(_currentValue),
+      style: widget.style,
+    );
+  }
+}

lib/objects/objects.dart

@@ -519,6 +519,8 @@ class StatsAbout {
     final networkByYear = <int, List<StatsNetworkMileage>>{};
     final stationByYear = <int, List<StatsStationVisits>>{};
     final winnersByYear = <int, int>{};
+    final winnerTypeCountsByYear = <int, Map<String, int>>{};
+    final totalTypeCountsByYear = <int, Map<String, int>>{};
 
     void addYearMileage(dynamic entry) {
       if (entry is Map<String, dynamic>) {
@@ -589,6 +591,16 @@ class StatsAbout {
       }
     }
 
+    Map<String, int> parseTypeCounts(dynamic value) {
+      if (value is Map) {
+        final entries = value.entries
+            .map((entry) => MapEntry(entry.key.toString(), _asInt(entry.value)))
+            .where((entry) => entry.key.isNotEmpty);
+        return Map<String, int>.fromEntries(entries);
+      }
+      return const {};
+    }
+
     parseYearMap<List<StatsClassMileage>>(
       json['top_classes'],
       classByYear,
@@ -610,6 +622,19 @@ class StatsAbout {
         if (year == null) return;
         if (value is List) {
           winnersByYear[year] = value.length;
+        } else if (value is Map) {
+          final mapped = value.map(
+            (entryKey, entryValue) =>
+                MapEntry(entryKey.toString(), entryValue),
+          );
+          final winners = mapped['winners'];
+          if (winners is List) {
+            winnersByYear[year] = winners.length;
+          }
+          winnerTypeCountsByYear[year] =
+              parseTypeCounts(mapped['winner_type_counts']);
+          totalTypeCountsByYear[year] =
+              parseTypeCounts(mapped['total_type_counts']);
         }
       });
     }
@@ -620,6 +645,8 @@ class StatsAbout {
       ...networkByYear.keys,
       ...stationByYear.keys,
       ...winnersByYear.keys,
+      ...winnerTypeCountsByYear.keys,
+      ...totalTypeCountsByYear.keys,
     }..removeWhere((year) => year == 0);
 
     final yearMap = <int, StatsYear>{};
@@ -631,6 +658,8 @@ class StatsAbout {
         topNetworks: networkByYear[year] ?? const [],
         topStations: stationByYear[year] ?? const [],
         winnerCount: winnersByYear[year] ?? 0,
+        winnerTypeCounts: winnerTypeCountsByYear[year] ?? const {},
+        totalTypeCounts: totalTypeCountsByYear[year] ?? const {},
       );
     }
 
@@ -651,6 +680,8 @@ class StatsYear {
   final List<StatsNetworkMileage> topNetworks;
   final List<StatsStationVisits> topStations;
   final int winnerCount;
+  final Map<String, int> winnerTypeCounts;
+  final Map<String, int> totalTypeCounts;
 
   StatsYear({
     required this.year,
@@ -659,6 +690,8 @@ class StatsYear {
     required this.topNetworks,
     required this.topStations,
     required this.winnerCount,
+    required this.winnerTypeCounts,
+    required this.totalTypeCounts,
   });
 }
 
@@ -1779,12 +1812,18 @@ class ClassClearanceProgress {
   final int completed;
   final int total;
   final double percentComplete;
+  final int activeCompleted;
+  final int activeTotal;
+  final double activePercent;
 
   ClassClearanceProgress({
     required this.className,
     required this.completed,
     required this.total,
     required this.percentComplete,
+    required this.activeCompleted,
+    required this.activeTotal,
+    required this.activePercent,
   });
 
   factory ClassClearanceProgress.fromJson(Map<String, dynamic> json) {
@@ -1802,11 +1841,34 @@ class ClassClearanceProgress {
     if (percent == 0 && total > 0) {
       percent = (completed / total) * 100;
     }
+    final activeCompleted = _asInt(
+      json['active_completed'] ??
+          json['active_done'] ??
+          json['active_count'] ??
+          json['active_had'] ??
+          json['had_active'],
+    );
+    final activeTotal =
+        _asInt(json['active_total'] ??
+            json['active_required'] ??
+            json['active_goal'] ??
+            json['total_active']);
+    double activePercent = _asDouble(
+      json['active_percent'] ??
+          json['active_pct'] ??
+          json['active_completion'],
+    );
+    if (activePercent == 0 && activeTotal > 0) {
+      activePercent = (activeCompleted / activeTotal) * 100;
+    }
     return ClassClearanceProgress(
       className: name.isNotEmpty ? name : 'Class',
       completed: completed,
       total: total,
       percentComplete: percent,
+      activeCompleted: activeCompleted,
+      activeTotal: activeTotal,
+      activePercent: activePercent,
     );
   }
 }

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,52 +36,143 @@ 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 _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'];
+      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> post(
     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<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);
   }
 
@@ -89,28 +180,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);
   }
 
@@ -124,10 +224,6 @@ class ApiService {
       return body;
     }
 
-    if (res.statusCode == 401 && _onUnauthorized != null) {
-      await _onUnauthorized!();
-    }
-
     final message = _extractErrorMessage(body);
     throw ApiException(
       statusCode: res.statusCode,
@@ -176,6 +272,34 @@ 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 =
+        RegExp(r"filename\\*=UTF-8''([^;]+)", caseSensitive: false)
+            .firstMatch(contentDisposition);
+    if (utf8Match != null) {
+      return Uri.decodeComponent(utf8Match.group(1) ?? '');
+    }
+    final match =
+        RegExp(r'filename="?([^\";]+)"?', caseSensitive: false)
+            .firstMatch(contentDisposition);
+    return match?.group(1);
+  }
 }
 
 class ApiException implements Exception {
@@ -192,3 +316,17 @@ class ApiException implements Exception {
   @override
   String toString() => 'API error $statusCode: $message';
 }
+
+class ApiBinaryResponse {
+  final List<int> bytes;
+  final int statusCode;
+  final String? contentType;
+  final String? filename;
+
+  ApiBinaryResponse({
+    required this.bytes,
+    required this.statusCode,
+    this.contentType,
+    this.filename,
+  });
+}

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

@@ -52,12 +52,15 @@ extension DataServiceBadges on DataService {
     int offset = 0,
     int limit = 20,
     bool append = false,
+    bool onlyIncomplete = false,
   }) async {
     _isClassClearanceProgressLoading = true;
-    if (!append) _classClearanceProgress = [];
     try {
-      final json =
-          await api.get('/badge/completion/class?limit=$limit&offset=$offset');
+      final onlyIncompleteParam =
+          onlyIncomplete ? '&only_incomplete=true' : '';
+      final json = await api.get(
+        '/badge/completion/class?limit=$limit&offset=$offset$onlyIncompleteParam',
+      );
       List<dynamic>? list;
       if (json is List) {
         list = json;
@@ -80,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/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;
+  }
 }

lib/utils/download_helper.dart

@@ -0,0 +1,29 @@
+import 'dart:typed_data';
+
+import 'package:file_selector/file_selector.dart';
+
+class SaveResult {
+  final String? path;
+  final bool canceled;
+
+  const SaveResult({this.path, required this.canceled});
+}
+
+Future<SaveResult> saveBytes(
+  Uint8List bytes,
+  String filename, {
+  String? mimeType,
+}) async {
+  final safeName = filename.trim().isEmpty ? 'export.bin' : filename.trim();
+  final location = await getSaveLocation(suggestedName: safeName);
+  if (location == null) {
+    return const SaveResult(canceled: true);
+  }
+  final file = XFile.fromData(
+    bytes,
+    mimeType: mimeType ?? 'application/octet-stream',
+    name: safeName,
+  );
+  await file.saveTo(location.path);
+  return SaveResult(path: location.path, canceled: false);
+}

linux/CMakeLists.txt

@@ -4,10 +4,10 @@ project(runner LANGUAGES CXX)
 
 # The name of the executable created for the application. Change this to change
 # the on-disk name of your application.
-set(BINARY_NAME "mileograph_flutter")
+set(BINARY_NAME "Mileograph")
 # The unique GTK application identifier for this application. See:
 # https://wiki.gnome.org/HowDoI/ChooseApplicationID
-set(APPLICATION_ID "com.example.mileograph_flutter")
+set(APPLICATION_ID "com.petegregoryy.mileograph_flutter")
 
 # Explicitly opt in to modern CMake behaviors to avoid warnings with recent
 # versions of CMake.

linux/flutter/generated_plugin_registrant.cc

@@ -7,12 +7,16 @@
 #include "generated_plugin_registrant.h"
 
 #include <dynamic_color/dynamic_color_plugin.h>
+#include <file_selector_linux/file_selector_plugin.h>
 #include <flutter_secure_storage_linux/flutter_secure_storage_linux_plugin.h>
 
 void fl_register_plugins(FlPluginRegistry* registry) {
   g_autoptr(FlPluginRegistrar) dynamic_color_registrar =
       fl_plugin_registry_get_registrar_for_plugin(registry, "DynamicColorPlugin");
   dynamic_color_plugin_register_with_registrar(dynamic_color_registrar);
+  g_autoptr(FlPluginRegistrar) file_selector_linux_registrar =
+      fl_plugin_registry_get_registrar_for_plugin(registry, "FileSelectorPlugin");
+  file_selector_plugin_register_with_registrar(file_selector_linux_registrar);
   g_autoptr(FlPluginRegistrar) flutter_secure_storage_linux_registrar =
       fl_plugin_registry_get_registrar_for_plugin(registry, "FlutterSecureStorageLinuxPlugin");
   flutter_secure_storage_linux_plugin_register_with_registrar(flutter_secure_storage_linux_registrar);

linux/flutter/generated_plugins.cmake

@@ -4,6 +4,7 @@
 
 list(APPEND FLUTTER_PLUGIN_LIST
   dynamic_color
+  file_selector_linux
   flutter_secure_storage_linux
 )
 

macos/Flutter/GeneratedPluginRegistrant.swift

@@ -6,12 +6,14 @@ import FlutterMacOS
 import Foundation
 
 import dynamic_color
+import file_selector_macos
 import flutter_secure_storage_darwin
 import path_provider_foundation
 import shared_preferences_foundation
 
 func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) {
   DynamicColorPlugin.register(with: registry.registrar(forPlugin: "DynamicColorPlugin"))
+  FileSelectorPlugin.register(with: registry.registrar(forPlugin: "FileSelectorPlugin"))
   FlutterSecureStorageDarwinPlugin.register(with: registry.registrar(forPlugin: "FlutterSecureStorageDarwinPlugin"))
   PathProviderPlugin.register(with: registry.registrar(forPlugin: "PathProviderPlugin"))
   SharedPreferencesPlugin.register(with: registry.registrar(forPlugin: "SharedPreferencesPlugin"))

pubspec.lock

@@ -73,6 +73,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.19.1"
+  cross_file:
+    dependency: transitive
+    description:
+      name: cross_file
+      sha256: "701dcfc06da0882883a2657c445103380e53e647060ad8d9dfb710c100996608"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.3.5+1"
   crypto:
     dependency: transitive
     description:
@@ -121,6 +129,70 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "7.0.1"
+  file_selector:
+    dependency: "direct main"
+    description:
+      name: file_selector
+      sha256: "5f1d15a7f17115038f433d1b0ea57513cc9e29a9d5338d166cb0bef3fa90a7a0"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.0.4"
+  file_selector_android:
+    dependency: transitive
+    description:
+      name: file_selector_android
+      sha256: "1ce58b609289551f8ec07265476720e77d19764339cc1d8e4df3c4d34dac6499"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.5.1+17"
+  file_selector_ios:
+    dependency: transitive
+    description:
+      name: file_selector_ios
+      sha256: fe9f52123af16bba4ad65bd7e03defbbb4b172a38a8e6aaa2a869a0c56a5f5fb
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.5.3+2"
+  file_selector_linux:
+    dependency: "direct main"
+    description:
+      name: file_selector_linux
+      sha256: "2567f398e06ac72dcf2e98a0c95df2a9edd03c2c2e0cacd4780f20cdf56263a0"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.9.4"
+  file_selector_macos:
+    dependency: "direct main"
+    description:
+      name: file_selector_macos
+      sha256: "19124ff4a3d8864fdc62072b6a2ef6c222d55a3404fe14893a3c02744907b60c"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.9.4+4"
+  file_selector_platform_interface:
+    dependency: transitive
+    description:
+      name: file_selector_platform_interface
+      sha256: "35e0bd61ebcdb91a3505813b055b09b79dfdc7d0aee9c09a7ba59ae4bb13dc85"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.7.0"
+  file_selector_web:
+    dependency: "direct main"
+    description:
+      name: file_selector_web
+      sha256: c4c0ea4224d97a60a7067eca0c8fd419e708ff830e0c83b11a48faf566cec3e7
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.9.4+2"
+  file_selector_windows:
+    dependency: "direct main"
+    description:
+      name: file_selector_windows
+      sha256: "62197474ae75893a62df75939c777763d39c2bc5f73ce5b88497208bc269abfd"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.9.3+5"
   flutter:
     dependency: "direct main"
     description: flutter
@@ -190,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
@@ -328,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:
@@ -533,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:
@@ -591,4 +703,4 @@ packages:
     version: "3.1.3"
 sdks:
   dart: ">=3.8.1 <4.0.0"
-  flutter: ">=3.29.0"
+  flutter: ">=3.32.0"

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.4+12
+version: 0.7.7+15
 
 environment:
   sdk: ^3.8.1
@@ -37,6 +37,12 @@ dependencies:
   dynamic_color: ^1.6.6
   flutter_secure_storage: ^10.0.0
   collection: ^1.18.0
+  file_selector: ^1.0.3
+  file_selector_linux: ^0.9.3
+  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.
@@ -68,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,265 @@
+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,
+  }) 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<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,
+    );
+  });
+}

windows/flutter/generated_plugin_registrant.cc

@@ -7,11 +7,14 @@
 #include "generated_plugin_registrant.h"
 
 #include <dynamic_color/dynamic_color_plugin_c_api.h>
+#include <file_selector_windows/file_selector_windows.h>
 #include <flutter_secure_storage_windows/flutter_secure_storage_windows_plugin.h>
 
 void RegisterPlugins(flutter::PluginRegistry* registry) {
   DynamicColorPluginCApiRegisterWithRegistrar(
       registry->GetRegistrarForPlugin("DynamicColorPluginCApi"));
+  FileSelectorWindowsRegisterWithRegistrar(
+      registry->GetRegistrarForPlugin("FileSelectorWindows"));
   FlutterSecureStorageWindowsPluginRegisterWithRegistrar(
       registry->GetRegistrarForPlugin("FlutterSecureStorageWindowsPlugin"));
 }

windows/flutter/generated_plugins.cmake

@@ -4,6 +4,7 @@
 
 list(APPEND FLUTTER_PLUGIN_LIST
   dynamic_color
+  file_selector_windows
   flutter_secure_storage_windows
 )