Skip to content

Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.

feat(ios): show the bot while the app connects on launch

leepokai98cfd7501a4f
diff --git a/apps/Codync.xcodeproj/project.pbxproj b/apps/Codync.xcodeproj/project.pbxproj
index 7fc583d4..d1d6c455 100644
--- a/apps/Codync.xcodeproj/project.pbxproj
+++ b/apps/Codync.xcodeproj/project.pbxproj
@@ -15,6 +15,7 @@
25667EBFCCC64B96FDCE95A9 /* CodyncKit in Frameworks */ = {isa = PBXBuildFile; productRef = 59F5D19A417A7A50596902FA /* CodyncKit */; };
2CC074683AE086D6C77CC1E8 /* WidgetKit.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = B274A0195CB3B2409EA4C194 /* WidgetKit.framework */; };
2CDF3DF16A13DAF83CA42168 /* CodyncWidgets.swift in Sources */ = {isa = PBXBuildFile; fileRef = FAB9BDB52C3A9F7B2568A750 /* CodyncWidgets.swift */; };
+ 35CFB641A4F10C0EBD21CB14 /* LaunchSplash.swift in Sources */ = {isa = PBXBuildFile; fileRef = 6FC76D28AB02DF1427D530ED /* LaunchSplash.swift */; };
3BCC04815E5CA8953E0DDCAD /* WidgetPreviews.swift in Sources */ = {isa = PBXBuildFile; fileRef = 305DDCC18BB8AA6CD9D19CEF /* WidgetPreviews.swift */; };
48DAAA1384E5B8D0BA27C895 /* SwiftUI.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 1E47C60032C326157E0386B8 /* SwiftUI.framework */; };
4DDC38E58D673047B332FDD5 /* AccessRequestView.swift in Sources */ = {isa = PBXBuildFile; fileRef = B97102DEC6029268332DF901 /* AccessRequestView.swift */; };
@@ -99,6 +100,7 @@
64888B10E98F19723500FBCA /* NotificationService.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = NotificationService.entitlements; sourceTree = "<group>"; };
6BC00039A6C2C0D3F39A5F67 /* ComputerStatus.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ComputerStatus.swift; sourceTree = "<group>"; };
6D734BEE7CD3F84677B0218B /* Widgets.appex */ = {isa = PBXFileReference; includeInIndex = 0; lastKnownFileType = "wrapper.app-extension"; path = Widgets.appex; sourceTree = BUILT_PRODUCTS_DIR; };
+ 6FC76D28AB02DF1427D530ED /* LaunchSplash.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LaunchSplash.swift; sourceTree = "<group>"; };
741B706007BA1B91CB853699 /* Screen.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Screen.app; sourceTree = BUILT_PRODUCTS_DIR; };
7B7E845BA1B8696B266CF578 /* NotificationService.appex */ = {isa = PBXFileReference; includeInIndex = 0; lastKnownFileType = "wrapper.app-extension"; path = NotificationService.appex; sourceTree = BUILT_PRODUCTS_DIR; };
7D8961FADA8810B6CC479705 /* WidgetSetupDemo.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = WidgetSetupDemo.swift; sourceTree = "<group>"; };
@@ -213,6 +215,7 @@
DD3DE9A4EEB369C4F75C9448 /* ActivityGalleryView.swift */,
0582B6169BFC36E4BCD51C0D /* BotListView.swift */,
6BC00039A6C2C0D3F39A5F67 /* ComputerStatus.swift */,
+ 6FC76D28AB02DF1427D530ED /* LaunchSplash.swift */,
ECD0B4EA4BBA2BB2826C4362 /* PairingView.swift */,
B6E13F8EA6C7B0DA4D899FEE /* RootView.swift */,
0A87B0091DAF0E4807D62017 /* SettingsView.swift */,
@@ -520,6 +523,7 @@
01A1F820EFEE49A8FCCFC3F3 /* BotListView.swift in Sources */,
7C20764DC05D499075BC5E8C /* CodyncApp.swift in Sources */,
2002C16E427B4E4E7279E1C4 /* ComputerStatus.swift in Sources */,
+ 35CFB641A4F10C0EBD21CB14 /* LaunchSplash.swift in Sources */,
719EABCBBAC0A973D729363A /* PairingView.swift in Sources */,
89CA3972915769DBA315876F /* Push.swift in Sources */,
0631979397E0D6822747E03A /* RootView.swift in Sources */,
@@ -794,7 +798,6 @@
INFOPLIST_KEY_NSSupportsLiveActivities = YES;
INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
- INFOPLIST_KEY_UILaunchScreen_Generation = YES;
INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
LD_RUNPATH_SEARCH_PATHS = (
@@ -847,7 +850,6 @@
INFOPLIST_KEY_NSSupportsLiveActivities = YES;
INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
- INFOPLIST_KEY_UILaunchScreen_Generation = YES;
INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
LD_RUNPATH_SEARCH_PATHS = (
diff --git a/apps/ios/App/CodyncApp.swift b/apps/ios/App/CodyncApp.swift
index 0e372a82..bbb75100 100644
--- a/apps/ios/App/CodyncApp.swift
+++ b/apps/ios/App/CodyncApp.swift
@@ -13,6 +13,8 @@ struct CodyncApp: App {
@State private var updates = AppUpdates()
@Environment(\.scenePhase) private var scenePhase
@AppStorage("onboardingCompleted") private var onboardingCompleted = false
+ /// Cold launch with a computer to reach: the splash covers its connect and catch-up.
+ @State private var launching = !AppStore.shared.accounts.computers.isEmpty
var body: some Scene {
WindowGroup {
@@ -41,6 +43,13 @@ struct CodyncApp: App {
.onChange(of: app.account.userID, initial: true) { _, userID in
app.switchAccount(to: userID)
}
+ .overlay {
+ if launching {
+ LaunchSplash(stores: app.accounts.computers.compactMap { app.accounts.store(for: $0.id) }) {
+ withAnimation(.easeOut(duration: 0.35)) { launching = false }
+ }
+ }
+ }
.onOpenURL { url in app.open(url) }
.onChange(of: scenePhase, initial: true) { _, phase in
// Only leaving for the background disconnects; `.inactive` (Control Center,
diff --git a/apps/ios/Kit/Sources/CodyncUI/Store/BotStore.swift b/apps/ios/Kit/Sources/CodyncUI/Store/BotStore.swift
index 95ac9c78..5ab2f6d7 100644
--- a/apps/ios/Kit/Sources/CodyncUI/Store/BotStore.swift
+++ b/apps/ios/Kit/Sources/CodyncUI/Store/BotStore.swift
@@ -32,6 +32,9 @@ public final class BotStore {
public private(set) var computer: Computer
public private(set) var connection: Connection = .connecting
+ /// The first catch-up has arrived: everything up to the host's rev when this app connected.
+ public private(set) var caughtUp = false
+ private var catchUpRev = Int64.max
private static let dropGrace: Duration = .seconds(5)
private static let initialConnectionGrace: Duration = .seconds(1)
private var heldDrop: Connection?
@@ -498,6 +501,8 @@ public final class BotStore {
setUsage(newUsage)
screen = newScreen
if hostRev < rev { rev = 0 }
+ catchUpRev = hostRev
+ bump(rev)
case let .bot(bot):
let neededInput = bots[bot.id]?.needsInput == true
bots[bot.id] = bot
@@ -557,7 +562,10 @@ public final class BotStore {
eventsTask = Task { [weak self] in await self?.runEvents(client) }
}
- private func bump(_ r: Int64) { rev = max(rev, r) }
+ private func bump(_ r: Int64) {
+ rev = max(rev, r)
+ if !caughtUp && rev >= catchUpRev { caughtUp = true }
+ }
private func upsert(_ e: Entry) {
var list = entries[e.botId] ?? []
diff --git a/apps/ios/Resources/Assets.xcassets/LaunchBackground.colorset/Contents.json b/apps/ios/Resources/Assets.xcassets/LaunchBackground.colorset/Contents.json
new file mode 100644
index 00000000..5bbcb090
--- /dev/null
+++ b/apps/ios/Resources/Assets.xcassets/LaunchBackground.colorset/Contents.json
@@ -0,0 +1,8 @@
+{
+ "colors" : [
+ { "color" : { "color-space" : "srgb", "components" : { "alpha" : "1.000", "blue" : "1.000", "green" : "1.000", "red" : "1.000" } }, "idiom" : "universal" },
+ { "appearances" : [ { "appearance" : "luminosity", "value" : "dark" } ],
+ "color" : { "color-space" : "srgb", "components" : { "alpha" : "1.000", "blue" : "0.039", "green" : "0.039", "red" : "0.039" } }, "idiom" : "universal" }
+ ],
+ "info" : { "author" : "xcode", "version" : 1 }
+}
diff --git a/apps/ios/Resources/Info.plist b/apps/ios/Resources/Info.plist
index d612e3d5..b2309b69 100644
--- a/apps/ios/Resources/Info.plist
+++ b/apps/ios/Resources/Info.plist
@@ -20,6 +20,12 @@
<array>
<string>INSendMessageIntent</string>
</array>
+ <key>UILaunchScreen</key>
+ <dict>
+ <!-- Palette.background, so the splash bot appears on the same canvas. -->
+ <key>UIColorName</key>
+ <string>LaunchBackground</string>
+ </dict>
<key>UIBackgroundModes</key>
<array>
<string>audio</string>
diff --git a/apps/ios/Views/LaunchSplash.swift b/apps/ios/Views/LaunchSplash.swift
new file mode 100644
index 00000000..18197a70
--- /dev/null
+++ b/apps/ios/Views/LaunchSplash.swift
@@ -0,0 +1,42 @@
+import CodyncKit
+import CodyncUI
+import SwiftUI
+
+/// Cold launch: the app-icon bot pops out of the system launch screen and looks around while the
+/// computers connect and catch up, then zooms away onto a list that's already current.
+/// Held at least `shortest` so the motion reads, never past `longest` (the cached list is behind it).
+struct LaunchSplash: View {
+ let stores: [BotStore]
+ let done: () -> Void
+ @Environment(\.accessibilityReduceMotion) private var reduceMotion
+ @State private var shown = false
+ @State private var waited = false
+
+ private static let shortest: Duration = .milliseconds(700)
+ private static let longest: Duration = .milliseconds(1800)
+
+ private var ready: Bool { waited && stores.allSatisfy(\.caughtUp) }
+
+ var body: some View {
+ TimelineView(.animation(paused: reduceMotion)) { context in
+ let t = context.date.timeIntervalSinceReferenceDate
+ CharacterAvatar(shape: "squircle", tint: Palette.text, size: 112, mood: .working)
+ .offset(y: reduceMotion ? 0 : sin(t * 2.4) * 4)
+ }
+ .scaleEffect(shown || reduceMotion ? 1 : 0.6)
+ .opacity(shown ? 1 : 0)
+ .frame(maxWidth: .infinity, maxHeight: .infinity)
+ .background(Palette.background)
+ .accessibilityLabel("Connecting")
+ .task {
+ withAnimation(.spring(duration: 0.5, bounce: 0.35)) { shown = true }
+ try? await Task.sleep(for: Self.shortest)
+ waited = true
+ try? await Task.sleep(for: Self.longest - Self.shortest)
+ done()
+ }
+ .onChange(of: ready, initial: true) { _, ready in if ready { done() } }
+ // Leaving: the bot grows a little as everything fades through to the app.
+ .transition(reduceMotion ? .opacity : .opacity.combined(with: .scale(scale: 1.15)))
+ }
+}
diff --git a/apps/project.yml b/apps/project.yml
index 3f8d4386..d2af612e 100644
--- a/apps/project.yml
+++ b/apps/project.yml
@@ -95,7 +95,6 @@ targets:
INFOPLIST_KEY_CFBundleDisplayName: Codync
INFOPLIST_KEY_LSApplicationCategoryType: public.app-category.developer-tools
INFOPLIST_KEY_ITSAppUsesNonExemptEncryption: NO
- INFOPLIST_KEY_UILaunchScreen_Generation: YES
INFOPLIST_KEY_UIApplicationSceneManifest_Generation: YES
INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents: YES
INFOPLIST_KEY_NSSupportsLiveActivities: YES
diff --git a/docs/design/ui-conventions.md b/docs/design/ui-conventions.md
index f054cf33..773d646f 100644
--- a/docs/design/ui-conventions.md
+++ b/docs/design/ui-conventions.md
@@ -63,6 +63,8 @@ Anything with a background fill gets no extra drawn border. Use `Palette` and `M
`CharacterAvatar` identifies a bot. `ThinkingOrb` conveys working, searching, listening or connecting and needs adjacent text or an accessible outer label. In-app animation pauses off-screen, when inactive, or with Reduce Motion. Widgets/activities use static frames.
+iPhone cold launch: the system launch screen is plain `Palette.background` (`LaunchBackground`), then `LaunchSplash` pops the app-icon bot (squircle, working mood) in while every paired computer connects and finishes its first catch-up (`BotStore.caughtUp`: the `hello` rev reached). It stays at least 0.7 s and at most 1.8 s, then zooms out over the cached list. Without a paired computer (first launch) it is skipped. iPhone only: the desktop app and TUI reach their host over loopback at once, so a splash would only delay them.
+
On iPhone, provider identity and activity presentation are shared with widgets in `CodyncKit/Design`; use those components rather than re-creating mappings per target. The desktop draws them in `components/AgentIcon.tsx`, `Avatar.tsx` and `ThinkingOrb.tsx`. See [mobile widgets](mobile-widgets.md) for current rendering and previews.
The [2026-09-25 audit](../archive/ui-audit-2026-09-25.md) is historical. Its old line numbers and recommendations are not the current UI policy or a list of confirmed open bugs.