app working with sandbox

lib/screens/balance_screen.dart

@@ -0,0 +1,172 @@
+/// Balance tab: connect bank CTA, current balance, and refresh.
+library;
+
+import 'package:flutter/material.dart';
+import 'package:provider/provider.dart';
+
+import '../providers/bank_provider.dart';
+import '../utils/connect_bank.dart';
+import '../utils/helpers.dart';
+import '../widgets/empty_state.dart';
+import '../widgets/loading_view.dart';
+import '../widgets/responsive_body.dart';
+
+class BalanceScreen extends StatelessWidget {
+  const BalanceScreen({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    final bank = context.watch<BankController>();
+
+    return Scaffold(
+      appBar: AppBar(
+        title: const Text('Balance'),
+        actions: [
+          IconButton(
+            tooltip: 'Refresh',
+            onPressed: bank.isLoading ? null : bank.refresh,
+            icon: const Icon(Icons.refresh),
+          ),
+        ],
+      ),
+      body: RefreshIndicator(
+        onRefresh: bank.refresh,
+        child: ResponsiveBody(
+          child: _BalanceBody(bank: bank),
+        ),
+      ),
+    );
+  }
+}
+
+class _BalanceBody extends StatelessWidget {
+  const _BalanceBody({required this.bank});
+
+  final BankController bank;
+
+  @override
+  Widget build(BuildContext context) {
+    if (bank.isLoading && bank.balance == null && !bank.isLinked) {
+      return const LoadingView(message: 'Checking bank link…');
+    }
+
+    if (!bank.isLinked) {
+      return ListView(
+        physics: const AlwaysScrollableScrollPhysics(),
+        children: [
+          EmptyState(
+            icon: Icons.account_balance_outlined,
+            title: 'Bank not linked',
+            message: bank.error ??
+                'Connect opens a sandbox bank login in-app. '
+                'Stay in that WebView until it returns here. '
+                'You should then see a balance and transactions.',
+            actionLabel: bank.isConnecting ? 'Opening…' : 'Connect bank',
+            onAction: () => runConnectBank(context, bank),
+          ),
+        ],
+      );
+    }
+
+    if (bank.error != null && bank.balance == null) {
+      return ListView(
+        physics: const AlwaysScrollableScrollPhysics(),
+        children: [
+          EmptyState(
+            icon: Icons.error_outline,
+            title: 'Could not load balance',
+            message: bank.error!,
+            actionLabel: 'Retry',
+            onAction: bank.refresh,
+          ),
+        ],
+      );
+    }
+
+    final balance = bank.balance;
+    final theme = Theme.of(context);
+    final colors = theme.colorScheme;
+
+    return ListView(
+      physics: const AlwaysScrollableScrollPhysics(),
+      padding: const EdgeInsets.only(top: 8, bottom: 32),
+      children: [
+        Container(
+          width: double.infinity,
+          padding: const EdgeInsets.all(24),
+          decoration: BoxDecoration(
+            borderRadius: BorderRadius.circular(20),
+            gradient: LinearGradient(
+              colors: [colors.primary, colors.tertiary],
+            ),
+            boxShadow: [
+              BoxShadow(
+                color: colors.primary.withValues(alpha: 0.28),
+                blurRadius: 20,
+                offset: const Offset(0, 10),
+              ),
+            ],
+          ),
+          child: Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              Text(
+                'Current balance',
+                style: theme.textTheme.labelMedium?.copyWith(
+                  color: colors.onPrimary.withValues(alpha: 0.8),
+                ),
+              ),
+              const SizedBox(height: 8),
+              Text(
+                balance == null
+                    ? '—'
+                    : formatMoney(balance.amount, balance.currency),
+                style: theme.textTheme.headlineMedium?.copyWith(
+                  color: colors.onPrimary,
+                ),
+              ),
+              if (balance?.balanceType != null) ...[
+                const SizedBox(height: 8),
+                Text(
+                  balance!.balanceType!,
+                  style: theme.textTheme.labelMedium?.copyWith(
+                    color: colors.onPrimary.withValues(alpha: 0.75),
+                  ),
+                ),
+              ],
+            ],
+          ),
+        ),
+        const SizedBox(height: 20),
+        ListTile(
+          contentPadding: EdgeInsets.zero,
+          leading: Icon(
+            Icons.check_circle_outline,
+            color: colors.primary,
+          ),
+          title: const Text('Linked'),
+          subtitle: Text(
+            bank.status.accountId == null
+                ? bank.status.status
+                : 'Account ${bank.status.accountId}',
+          ),
+        ),
+        if (bank.error != null) ...[
+          const SizedBox(height: 8),
+          Text(
+            bank.error!,
+            style: theme.textTheme.bodyMedium?.copyWith(color: colors.error),
+          ),
+        ],
+        const SizedBox(height: 12),
+        OutlinedButton.icon(
+          onPressed: bank.isConnecting
+              ? null
+              : () => runConnectBank(context, bank),
+          icon: const Icon(Icons.link),
+          label: Text(bank.isConnecting ? 'Opening…' : 'Reconnect bank'),
+        ),
+      ],
+    );
+  }
+}

lib/screens/bank_auth_screen.dart

@@ -0,0 +1,124 @@
+/// In-app browser for Enable Banking hosted auth.
+///
+/// Enable Banking only allows http(s) redirect URLs, so we keep
+/// `http://localhost:8000/api/connect/callback` and capture `code` here
+/// when the WebView navigates to that callback.
+library;
+
+import 'package:flutter/material.dart';
+import 'package:webview_flutter/webview_flutter.dart';
+
+/// Result popped from [BankAuthScreen] after bank login.
+class BankAuthResult {
+  const BankAuthResult({this.code, this.state, this.error});
+
+  final String? code;
+  final String? state;
+  final String? error;
+
+  bool get hasCode => code != null && code!.isNotEmpty;
+}
+
+class BankAuthScreen extends StatefulWidget {
+  const BankAuthScreen({
+    super.key,
+    required this.authUrl,
+    this.pendingState,
+  });
+
+  final String authUrl;
+  final String? pendingState;
+
+  @override
+  State<BankAuthScreen> createState() => _BankAuthScreenState();
+}
+
+class _BankAuthScreenState extends State<BankAuthScreen> {
+  late final WebViewController _controller;
+  var _finishing = false;
+  var _loading = true;
+
+  @override
+  void initState() {
+    super.initState();
+    _controller = WebViewController()
+      ..setJavaScriptMode(JavaScriptMode.unrestricted)
+      ..setNavigationDelegate(
+        NavigationDelegate(
+          onPageStarted: (url) {
+            if (mounted) setState(() => _loading = true);
+            _handleUrl(url);
+          },
+          onPageFinished: (_) {
+            if (mounted) setState(() => _loading = false);
+          },
+          onNavigationRequest: (request) {
+            if (_handleUrl(request.url)) {
+              return NavigationDecision.prevent;
+            }
+            return NavigationDecision.navigate;
+          },
+          onWebResourceError: (error) {
+            // Callback to localhost often fails to load on emulators; if we
+            // already captured the code, ignore the load error.
+            if (_finishing) return;
+            debugPrint('Bank auth WebView error: ${error.description}');
+          },
+        ),
+      )
+      ..loadRequest(Uri.parse(widget.authUrl));
+  }
+
+  /// Returns true when [url] is the Enable Banking redirect callback.
+  bool _handleUrl(String url) {
+    final uri = Uri.tryParse(url);
+    if (uri == null || _finishing) return false;
+    if (!_isConnectCallback(uri)) return false;
+
+    _finishing = true;
+    final error = uri.queryParameters['error'];
+    final code = uri.queryParameters['code'];
+    final state = uri.queryParameters['state'] ?? widget.pendingState;
+
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      if (!mounted) return;
+      Navigator.of(context).pop(
+        BankAuthResult(
+          code: code,
+          state: state,
+          error: error,
+        ),
+      );
+    });
+    return true;
+  }
+
+  bool _isConnectCallback(Uri uri) {
+    final path = uri.path;
+    return path == '/api/connect/callback' ||
+        path.endsWith('/api/connect/callback');
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(
+        title: const Text('Connect bank'),
+        leading: IconButton(
+          icon: const Icon(Icons.close),
+          onPressed: () => Navigator.of(context).pop(),
+        ),
+      ),
+      body: Stack(
+        children: [
+          WebViewWidget(controller: _controller),
+          if (_loading)
+            const Align(
+              alignment: Alignment.topCenter,
+              child: LinearProgressIndicator(minHeight: 2),
+            ),
+        ],
+      ),
+    );
+  }
+}

lib/screens/main_shell.dart

@@ -1,14 +1,13 @@
-/// Host scaffold that owns the bottom navigation bar and its four tabs.
+/// Host scaffold that owns the bottom navigation bar and its tabs.
 library;
 
 import 'package:flutter/material.dart';
 
-import 'home_screen.dart';
-import 'profile_screen.dart';
-import 'search_screen.dart';
+import 'balance_screen.dart';
 import 'settings_screen.dart';
+import 'transactions_screen.dart';
 
-/// Switches between Home, Search, Profile, and Settings without stacking routes.
+/// Switches between Balance, Transactions, and Settings without stacking routes.
 class MainShell extends StatefulWidget {
   const MainShell({super.key});
 
@@ -20,9 +19,8 @@ class _MainShellState extends State<MainShell> {
   int _index = 0;
 
   static const _pages = [
-    HomeScreen(),
-    SearchScreen(),
-    ProfileScreen(),
+    BalanceScreen(),
+    TransactionsScreen(),
     SettingsScreen(),
   ];
 
@@ -38,19 +36,14 @@ class _MainShellState extends State<MainShell> {
         onDestinationSelected: (index) => setState(() => _index = index),
         destinations: const [
           NavigationDestination(
-            icon: Icon(Icons.home_outlined),
-            selectedIcon: Icon(Icons.home),
-            label: 'Home',
+            icon: Icon(Icons.account_balance_wallet_outlined),
+            selectedIcon: Icon(Icons.account_balance_wallet),
+            label: 'Balance',
           ),
           NavigationDestination(
-            icon: Icon(Icons.search_outlined),
-            selectedIcon: Icon(Icons.search),
-            label: 'Search',
-          ),
-          NavigationDestination(
-            icon: Icon(Icons.person_outline),
-            selectedIcon: Icon(Icons.person),
-            label: 'Profile',
+            icon: Icon(Icons.receipt_long_outlined),
+            selectedIcon: Icon(Icons.receipt_long),
+            label: 'Transactions',
           ),
           NavigationDestination(
             icon: Icon(Icons.settings_outlined),

lib/screens/settings_screen.dart

@@ -1,11 +1,12 @@
-/// Settings tab: theme mode, data source, and about information.
+/// Settings tab: theme mode, API endpoint, and bank link status.
 library;
 
 import 'package:flutter/material.dart';
 import 'package:provider/provider.dart';
 
-import '../providers/item_provider.dart';
+import '../providers/bank_provider.dart';
 import '../providers/theme_provider.dart';
+import '../utils/connect_bank.dart';
 import '../utils/constants.dart';
 import '../utils/helpers.dart';
 import '../widgets/responsive_body.dart';
@@ -16,7 +17,7 @@ class SettingsScreen extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
     final themeController = context.watch<ThemeController>();
-    final items = context.watch<ItemController>();
+    final bank = context.watch<BankController>();
     final theme = Theme.of(context);
 
     return Scaffold(
@@ -56,19 +57,58 @@ class SettingsScreen extends StatelessWidget {
               },
             ),
             const SizedBox(height: 28),
-            Text('Data', style: theme.textTheme.titleMedium),
+            Text('Backend', style: theme.textTheme.titleMedium),
             const SizedBox(height: 8),
             Card(
-              child: SwitchListTile(
-                title: const Text('Use remote sample API'),
-                subtitle: const Text(
-                  'When on, items are fetched with the http package from '
-                  'JSONPlaceholder. Failures fall back to local mock data.',
-                ),
-                value: items.useRemoteData,
-                onChanged: (value) => items.setUseRemoteData(value),
+              child: Column(
+                children: [
+                  ListTile(
+                    leading: const Icon(Icons.dns_outlined),
+                    title: const Text('API base URL'),
+                    subtitle: Text(bank.apiBaseUrl),
+                  ),
+                  const Divider(height: 1),
+                  ListTile(
+                    leading: Icon(
+                      bank.isLinked
+                          ? Icons.link
+                          : Icons.link_off_outlined,
+                    ),
+                    title: const Text('Bank link'),
+                    subtitle: Text(
+                      bank.isLinked
+                          ? 'Linked · ${bank.status.status}'
+                          : 'Not linked',
+                    ),
+                    trailing: bank.isLinked
+                        ? null
+                        : TextButton(
+                            onPressed: bank.isConnecting
+                                ? null
+                                : () => runConnectBank(context, bank),
+                            child: Text(
+                              bank.isConnecting ? 'Opening…' : 'Connect',
+                            ),
+                          ),
+                  ),
+                  const Divider(height: 1),
+                  const ListTile(
+                    leading: Icon(Icons.open_in_browser_outlined),
+                    title: Text('Enable Banking redirect'),
+                    subtitle: Text(kEnableBankingRedirectUri),
+                  ),
+                ],
               ),
             ),
+            const SizedBox(height: 12),
+            Text(
+              'Enable Banking only allows http(s) redirects. Keep '
+              '$kEnableBankingRedirectUri in the Control Panel and backend '
+              'REDIRECT_URI. The app captures that URL inside a WebView. '
+              'Override the API host with '
+              '`--dart-define=API_BASE_URL=http://<host>:8000`.',
+              style: theme.textTheme.bodyMedium,
+            ),
             const SizedBox(height: 28),
             Text('About', style: theme.textTheme.titleMedium),
             const SizedBox(height: 8),
@@ -78,7 +118,7 @@ class SettingsScreen extends StatelessWidget {
                   const ListTile(
                     leading: Icon(Icons.apps),
                     title: Text(kAppName),
-                    subtitle: Text('Generic Flutter Android starter'),
+                    subtitle: Text('Personal bank data via Enable Banking'),
                   ),
                   const Divider(height: 1),
                   const ListTile(

lib/screens/splash_screen.dart

@@ -90,7 +90,7 @@ class _SplashScreenState extends State<SplashScreen>
                         borderRadius: BorderRadius.circular(24),
                       ),
                       child: Icon(
-                        Icons.layers_rounded,
+                        Icons.account_balance_rounded,
                         size: 44,
                         color: colors.onPrimary,
                       ),
@@ -103,12 +103,12 @@ class _SplashScreenState extends State<SplashScreen>
                       ),
                     ),
                     const SizedBox(height: 8),
-                    Text(
-                      'A Material 3 starter template',
-                      style: textTheme.bodyLarge?.copyWith(
-                        color: colors.onPrimary.withValues(alpha: 0.85),
+                      Text(
+                        'Your bank data, simply',
+                        style: textTheme.bodyLarge?.copyWith(
+                          color: colors.onPrimary.withValues(alpha: 0.85),
+                        ),
                       ),
-                    ),
                     const SizedBox(height: 40),
                     SizedBox(
                       width: 28,

lib/screens/transactions_screen.dart

@@ -0,0 +1,142 @@
+/// Transactions tab: recent bank movements from the ingtrak API.
+library;
+
+import 'package:flutter/material.dart';
+import 'package:provider/provider.dart';
+
+import '../models/bank.dart';
+import '../providers/bank_provider.dart';
+import '../utils/connect_bank.dart';
+import '../utils/helpers.dart';
+import '../widgets/empty_state.dart';
+import '../widgets/loading_view.dart';
+import '../widgets/responsive_body.dart';
+
+class TransactionsScreen extends StatelessWidget {
+  const TransactionsScreen({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    final bank = context.watch<BankController>();
+
+    return Scaffold(
+      appBar: AppBar(
+        title: const Text('Transactions'),
+        actions: [
+          IconButton(
+            tooltip: 'Refresh',
+            onPressed: bank.isLoading ? null : bank.refresh,
+            icon: const Icon(Icons.refresh),
+          ),
+        ],
+      ),
+      body: RefreshIndicator(
+        onRefresh: bank.refresh,
+        child: ResponsiveBody(
+          child: _TransactionsBody(bank: bank),
+        ),
+      ),
+    );
+  }
+}
+
+class _TransactionsBody extends StatelessWidget {
+  const _TransactionsBody({required this.bank});
+
+  final BankController bank;
+
+  @override
+  Widget build(BuildContext context) {
+    if (bank.isLoading && bank.transactions.isEmpty) {
+      return const LoadingView(message: 'Loading transactions…');
+    }
+
+    if (!bank.isLinked) {
+      return ListView(
+        physics: const AlwaysScrollableScrollPhysics(),
+        children: [
+          EmptyState(
+            icon: Icons.receipt_long_outlined,
+            title: 'No transactions yet',
+            message: bank.error ??
+                'Link your bank on the Balance tab to load recent activity.',
+            actionLabel: bank.isConnecting ? 'Opening…' : 'Connect bank',
+            onAction: () => runConnectBank(context, bank),
+          ),
+        ],
+      );
+    }
+
+    if (bank.error != null && bank.transactions.isEmpty) {
+      return ListView(
+        physics: const AlwaysScrollableScrollPhysics(),
+        children: [
+          EmptyState(
+            icon: Icons.error_outline,
+            title: 'Could not load transactions',
+            message: bank.error!,
+            actionLabel: 'Retry',
+            onAction: bank.refresh,
+          ),
+        ],
+      );
+    }
+
+    if (bank.transactions.isEmpty) {
+      return ListView(
+        physics: const AlwaysScrollableScrollPhysics(),
+        children: const [
+          EmptyState(
+            icon: Icons.inbox_outlined,
+            title: 'No recent activity',
+            message: 'The backend returned an empty transaction list.',
+          ),
+        ],
+      );
+    }
+
+    return ListView.separated(
+      physics: const AlwaysScrollableScrollPhysics(),
+      padding: const EdgeInsets.only(top: 8, bottom: 32),
+      itemCount: bank.transactions.length,
+      separatorBuilder: (_, _) => const SizedBox(height: 8),
+      itemBuilder: (context, index) {
+        return _TransactionTile(tx: bank.transactions[index]);
+      },
+    );
+  }
+}
+
+class _TransactionTile extends StatelessWidget {
+  const _TransactionTile({required this.tx});
+
+  final BankTransaction tx;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final colors = theme.colorScheme;
+    final isCredit = tx.amount >= 0;
+    final amountColor = isCredit ? colors.primary : colors.error;
+
+    return Card(
+      child: ListTile(
+        title: Text(
+          tx.description,
+          maxLines: 2,
+          overflow: TextOverflow.ellipsis,
+        ),
+        subtitle: Text(
+          [
+            formatIsoDate(tx.date),
+            if (tx.pending) 'Pending',
+          ].where((part) => part.isNotEmpty).join(' · '),
+        ),
+        trailing: Text(
+          formatMoney(tx.amount, tx.currency),
+          style: theme.textTheme.titleMedium?.copyWith(color: amountColor),
+        ),
+      ),
+    );
+  }
+}