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(desktop): show the Codync bot while the host starts

leepokai80a8fbed1ae8
diff --git a/apps/desktop/src/renderer/lib/theme.ts b/apps/desktop/src/renderer/lib/theme.ts
index 04777bce..29b06c41 100644
--- a/apps/desktop/src/renderer/lib/theme.ts
+++ b/apps/desktop/src/renderer/lib/theme.ts
@@ -104,6 +104,9 @@ export function avatarColor(id: string) {
return (AVATAR_COLORS.find((c) => c.id === id) ?? AVATAR_COLORS[7]!).hex
}
+/** `[r, g, b]` → `#RRGGBB`. */
+export const rgbHex = (rgb: number[]) => `#${rgb.map((c) => c.toString(16).padStart(2, '0')).join('')}`
+
/** `#RRGGBB` → `rgba(r, g, b, a)`. */
export function withAlpha(hex: string, alpha: number) {
const n = parseInt(hex.slice(1), 16)
diff --git a/apps/desktop/src/renderer/views/HostStateView.tsx b/apps/desktop/src/renderer/views/HostStateView.tsx
index 2ead0bea..a4f853d1 100644
--- a/apps/desktop/src/renderer/views/HostStateView.tsx
+++ b/apps/desktop/src/renderer/views/HostStateView.tsx
@@ -1,6 +1,9 @@
+import type { ReactElement } from 'react'
+import { CharacterAvatar } from '../components/Avatar'
import { Button } from '../components/Controls'
import { Icon } from '../components/Icon'
import { Text } from '../components/Text'
+import { palette, rgbHex, useDark } from '../lib/theme'
import { useApp } from '../store/context'
const isMac = window.codync.platform === 'darwin'
@@ -17,15 +20,24 @@ export function HostStateView({ compact = false }: { compact?: boolean }) {
case 'failed':
return <EmptyState compact={compact} icon="desktopcomputer.trianglebadge.exclamationmark" title="The host isn't running" message={state.message} action={['Try again', () => window.codync.host.restart()]} />
default:
- return <EmptyState compact={compact} icon="desktopcomputer" title="Starting the host…" message="This takes a few seconds." />
+ return <EmptyState compact={compact} icon={<StartingBot size={compact ? 32 : 112} />} title="Starting the host…" message="This takes a few seconds." />
}
}
-/** A quiet placeholder for an empty screen: icon, title, a line of help and an optional action. */
-export function EmptyState({ icon, title, message, action, compact = false }: { icon: string; title: string; message: string; action?: [string, () => void]; compact?: boolean }) {
+/** The app-icon bot looking around while the host starts, like the phones' launch splash. */
+function StartingBot({ size }: { size: number }) {
+ return (
+ <div className="starting-bot">
+ <CharacterAvatar shape="squircle" color="" tint={rgbHex(palette(useDark()).text)} size={size} mood="working" />
+ </div>
+ )
+}
+
+/** A quiet placeholder for an empty screen: icon (an SF Symbol name or artwork), title, a line of help and an optional action. */
+export function EmptyState({ icon, title, message, action, compact = false }: { icon: string | ReactElement; title: string; message: string; action?: [string, () => void]; compact?: boolean }) {
return (
<div className={`empty-state ${compact ? 'local-recovery' : ''}`}>
- <Icon name={icon} size={compact ? 22 : 36} weight="light" color="var(--tertiary)" />
+ {typeof icon === 'string' ? <Icon name={icon} size={compact ? 22 : 36} weight="light" color="var(--tertiary)" /> : icon}
<Text as="div" size={compact ? 'callout' : 'title3'} weight="semibold" tone="text">{title}</Text>
<Text as="div" size="callout" tone="secondary" className="empty-state-message">{message}</Text>
{action ? (
diff --git a/apps/desktop/src/renderer/views/chat-window.css b/apps/desktop/src/renderer/views/chat-window.css
index 1927d36b..dc682c57 100644
--- a/apps/desktop/src/renderer/views/chat-window.css
+++ b/apps/desktop/src/renderer/views/chat-window.css
@@ -25,6 +25,38 @@
.empty-state-action {
margin-top: 4px;
}
+/* The bot while the host starts pops in, then bobs (as the phones' launch splash). */
+.starting-bot {
+ margin-bottom: 6px;
+ animation: starting-bot-in 0.5s cubic-bezier(0.34, 1.56, 0.64, 1) both;
+}
+.starting-bot > canvas {
+ animation: starting-bot-bob 2.6s ease-in-out infinite;
+}
+.local-recovery .starting-bot {
+ margin-bottom: 0;
+}
+@keyframes starting-bot-in {
+ from {
+ opacity: 0;
+ transform: scale(0.6);
+ }
+}
+@keyframes starting-bot-bob {
+ 0%,
+ 100% {
+ transform: translateY(-4px);
+ }
+ 50% {
+ transform: translateY(4px);
+ }
+}
+@media (prefers-reduced-motion: reduce) {
+ .starting-bot,
+ .starting-bot > canvas {
+ animation: none;
+ }
+}
/* The version mismatch notice above a computer's bots (UpdateNeededCard). */
.update-needed {
diff --git a/docs/design/ui-conventions.md b/docs/design/ui-conventions.md
index dd518065..7d53b6a1 100644
--- a/docs/design/ui-conventions.md
+++ b/docs/design/ui-conventions.md
@@ -81,7 +81,7 @@ 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.
+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. Android does the same (`LaunchSplash.kt`). The desktop app and TUI reach their host over loopback at once, so they have no splash; while the desktop's own host is still starting, its "Starting the host…" screen (`HostStateView`, full and compact in `StartupRecovery`) shows the same bot popping in and bobbing above the text, still with Reduce Motion.
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.