feat(ios): add state restoration across app lifecycle

Author: datlechin

CHANGELOG.md

@@ -13,6 +13,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - iPad keyboard shortcuts (Cmd+N new connection, Cmd+Return execute query, Cmd+1/2 switch tabs) and trackpad hover effects on list rows
 - Server Dashboard with active sessions, server metrics, and slow query monitoring (PostgreSQL, MySQL, MSSQL, ClickHouse, DuckDB, SQLite)
 - Handoff support for cross-device continuity between iOS and macOS
+- State restoration across app lifecycle on iOS (selected connection, active tab, query text, database/schema selection)
 
 ## [0.30.1] - 2026-04-10
 

TableProMobile/TableProMobile/Views/ConnectedView.swift

@@ -21,13 +21,13 @@ struct ConnectedView: View {
     @State private var appError: AppError?
     @State private var failureAlertMessage: String?
     @State private var showFailureAlert = false
-    @State private var selectedTab = ConnectedTab.tables
+    @AppStorage("lastSelectedTab") private var selectedTabRaw: String = ConnectedTab.tables.rawValue
     @State private var queryHistory: [QueryHistoryItem] = []
     @State private var historyStorage = QueryHistoryStorage()
     @State private var databases: [String] = []
-    @State private var activeDatabase: String = ""
+    @AppStorage("lastActiveDatabase") private var activeDatabase: String = ""
     @State private var schemas: [String] = []
-    @State private var activeSchema: String = "public"
+    @AppStorage("lastActiveSchema") private var activeSchema: String = "public"
     @State private var isSwitching = false
     @State private var isReconnecting = false
     @State private var hapticSuccess = false
@@ -40,6 +40,18 @@ struct ConnectedView: View {
         case query = "Query"
     }
 
+    private var selectedTab: ConnectedTab {
+        get { ConnectedTab(rawValue: selectedTabRaw) ?? .tables }
+        set { selectedTabRaw = newValue.rawValue }
+    }
+
+    private var selectedTabBinding: Binding<ConnectedTab> {
+        Binding(
+            get: { ConnectedTab(rawValue: selectedTabRaw) ?? .tables },
+            set: { selectedTabRaw = $0.rawValue }
+        )
+    }
+
     private var displayName: String {
         connection.name.isEmpty ? connection.host : connection.name
     }
@@ -119,7 +131,7 @@ struct ConnectedView: View {
         .navigationTitle(supportsDatabaseSwitching && databases.count > 1 ? "" : displayName)
         .navigationBarTitleDisplayMode(.inline)
         .safeAreaInset(edge: .top) {
-            Picker("Tab", selection: $selectedTab) {
+            Picker("Tab", selection: selectedTabBinding) {
                 Text("Tables").tag(ConnectedTab.tables)
                 Text("Query").tag(ConnectedTab.query)
             }

TableProMobile/TableProMobile/Views/ConnectionListView.swift

@@ -12,12 +12,12 @@ struct ConnectionListView: View {
     @Environment(\.horizontalSizeClass) private var sizeClass
     @State private var showingAddConnection = false
     @State private var editingConnection: DatabaseConnection?
-    @State private var selectedConnectionId: UUID?
+    @AppStorage("lastConnectionId") private var selectedConnectionIdString: String?
     @State private var columnVisibility: NavigationSplitViewVisibility = .automatic
     @State private var showingGroupManagement = false
     @State private var showingTagManagement = false
-    @State private var filterTagId: UUID?
-    @State private var groupByGroup = false
+    @AppStorage("lastFilterTagId") private var filterTagIdString: String?
+    @AppStorage("groupByGroup") private var groupByGroup = false
     @State private var editMode: EditMode = .inactive
     @State private var connectionToDelete: DatabaseConnection?
 
@@ -28,6 +28,21 @@ struct ConnectionListView: View {
         )
     }
 
+    private var selectedConnectionId: Binding<UUID?> {
+        Binding(
+            get: { selectedConnectionIdString.flatMap { UUID(uuidString: $0) } },
+            set: { selectedConnectionIdString = $0?.uuidString }
+        )
+    }
+
+    private var selectedConnectionUUID: UUID? {
+        selectedConnectionIdString.flatMap { UUID(uuidString: $0) }
+    }
+
+    private var filterTagId: UUID? {
+        filterTagIdString.flatMap { UUID(uuidString: $0) }
+    }
+
     private var displayedConnections: [DatabaseConnection] {
         var result = appState.connections
         if let filterTagId {
@@ -44,8 +59,8 @@ struct ConnectionListView: View {
     }
 
     private var selectedConnection: DatabaseConnection? {
-        guard let selectedConnectionId else { return nil }
-        return appState.connections.first { $0.id == selectedConnectionId }
+        guard let id = selectedConnectionUUID else { return nil }
+        return appState.connections.first { $0.id == id }
     }
 
     var body: some View {
@@ -90,7 +105,7 @@ struct ConnectionListView: View {
             .onChange(of: appState.pendingConnectionId) { _, newId in
                 navigateToPendingConnection(newId)
             }
-            .onChange(of: filterTagId) {
+            .onChange(of: filterTagIdString) {
                 editMode = .inactive
             }
             .onChange(of: groupByGroup) {
@@ -135,7 +150,7 @@ struct ConnectionListView: View {
 
     @ViewBuilder
     private var connectionList: some View {
-        let list = List(selection: $selectedConnectionId) {
+        let list = List(selection: selectedConnectionId) {
             if groupByGroup {
                 groupedContent
             } else {
@@ -201,8 +216,8 @@ struct ConnectionListView: View {
             ) {
                 Button(String(localized: "Delete"), role: .destructive) {
                     if let connection = connectionToDelete {
-                        if selectedConnectionId == connection.id {
-                            selectedConnectionId = nil
+                        if selectedConnectionUUID == connection.id {
+                            selectedConnectionIdString = nil
                         }
                         appState.removeConnection(connection)
                     }
@@ -222,7 +237,7 @@ struct ConnectionListView: View {
             if !appState.tags.isEmpty {
                 Section("Filter by Tag") {
                     Button {
-                        filterTagId = nil
+                        filterTagIdString = nil
                     } label: {
                         HStack {
                             Text("All")
@@ -233,7 +248,7 @@ struct ConnectionListView: View {
                     }
                     ForEach(appState.tags) { tag in
                         Button {
-                            filterTagId = tag.id
+                            filterTagIdString = tag.id.uuidString
                         } label: {
                             HStack {
                                 Image(systemName: "circle.fill")
@@ -339,7 +354,7 @@ struct ConnectionListView: View {
     private func navigateToPendingConnection(_ id: UUID?) {
         guard let id,
               appState.connections.contains(where: { $0.id == id }) else { return }
-        selectedConnectionId = id
+        selectedConnectionIdString = id.uuidString
         appState.pendingConnectionId = nil
     }
 

TableProMobile/TableProMobile/Views/QueryEditorView.swift

@@ -17,7 +17,7 @@ struct QueryEditorView: View {
 
     private static let logger = Logger(subsystem: "com.TablePro", category: "QueryEditorView")
 
-    @State private var query = ""
+    @AppStorage("lastQueryText") private var query = ""
     @State private var result: QueryResult?
     @State private var appError: AppError?
     @State private var isExecuting = false