Skip to content

armgit / alook

Public Imported from GitHub
0

Multi-Agent Collaboration for Team and Friends

community: onboarding motion tiles — empty-state animations + help gallery

Gusc98951e25945
diff --git a/src/web/src/app/globals.css b/src/web/src/app/globals.css
index 226e44aac..7dd8cc3b8 100644
--- a/src/web/src/app/globals.css
+++ b/src/web/src/app/globals.css
@@ -388,6 +388,32 @@
╰───────────────────────╯
*/
+/* Onboarding motion tiles (community/onboarding-tiles/*). Scoped .ot-* classes;
+ accent/green maps to the real --status-online token so it matches the app's
+ presence dot and themes light/dark automatically. */
+.ot-svg {
+ display: block;
+ color: var(--line, var(--muted-foreground));
+}
+.ot-art {
+ fill: none;
+ stroke: currentColor;
+ stroke-width: 2;
+ stroke-linecap: round;
+ stroke-linejoin: round;
+}
+.ot-art-fill {
+ fill: currentColor;
+ stroke: none;
+}
+.ot-accent {
+ color: var(--status-online);
+}
+.ot-center {
+ transform-box: fill-box;
+ transform-origin: center;
+}
+
.typewriter-wrapper {
container-type: size;
}
diff --git a/src/web/src/components/community/bots/bot-list.tsx b/src/web/src/components/community/bots/bot-list.tsx
index c750c5065..46a49af14 100644
--- a/src/web/src/components/community/bots/bot-list.tsx
+++ b/src/web/src/components/community/bots/bot-list.tsx
@@ -2,7 +2,7 @@
import { useEffect, useMemo, useRef, useState } from "react"
import { useRouter, useSearchParams } from "next/navigation"
-import { ChevronLeft, Bot as BotIcon, Monitor, MoreVertical, Plus } from "lucide-react"
+import { ChevronLeft, Monitor, MoreVertical, HelpCircle } from "lucide-react"
import { toast } from "sonner"
import { toastApiError } from "@/lib/api/client"
import { isPresenceOnline, formatModelLabel } from "@alook/shared"
@@ -36,6 +36,8 @@ import { useOnlineUserIds } from "@/stores/community/ws"
import { CreateBotSheet } from "./create-bot-sheet"
import { EditBotSheet } from "./edit-bot-sheet"
import { BotActivityModal } from "./bot-activity-modal"
+import { CreateTile } from "@/components/community/onboarding-tiles/create-tile"
+import { AgentHelpGallery } from "@/components/community/onboarding-tiles/agent-help-gallery"
/**
* BotList — the /c/me/bots surface.
@@ -68,6 +70,7 @@ export function BotList({ onBack }: { onBack?: () => void } = {}) {
const [activityOpen, setActivityOpen] = useState(false)
const [confirmDelete, setConfirmDelete] = useState<BotSummary | null>(null)
const [confirmReset, setConfirmReset] = useState<BotSummary | null>(null)
+ const [helpOpen, setHelpOpen] = useState(false)
const del = useDeleteBot()
const resetSession = useResetBotSession()
const createOrGetDm = useCreateOrGetDm()
@@ -158,16 +161,21 @@ export function BotList({ onBack }: { onBack?: () => void } = {}) {
<div className="flex min-h-0 flex-1 flex-col">
{backBar}
<div className="flex flex-1 flex-col items-center justify-center gap-4 p-12 text-center">
- <div className="grid size-12 place-items-center rounded-2xl bg-secondary text-muted-foreground">
- <BotIcon className="size-6" />
+ <div className="w-full max-w-70 overflow-hidden rounded-xl">
+ <div className="aspect-200/130 w-full">
+ <CreateTile />
+ </div>
</div>
<div className="flex flex-col gap-1">
<h2 className="text-lg font-medium text-foreground">No bots yet</h2>
<p className="max-w-md text-sm text-muted-foreground">
- Give your daemon a voice. A bot is a first-class community member you own,
- bound to a paired machine and a runtime.
+ Create a bot and chat with it from anywhere — spin up servers and
+ share it with family and friends.
</p>
</div>
+ {/* No help ? in the empty state (Gus): the gallery is about mechanics
+ a user only needs AFTER they own a bot — it lives in the populated
+ header instead. */}
<Button onClick={() => setCreateOpen(true)}>Create a bot</Button>
</div>
<CreateBotSheet open={createOpen} onOpenChange={setCreateOpen} />
@@ -186,10 +194,18 @@ export function BotList({ onBack }: { onBack?: () => void } = {}) {
Bots you own — they show up as friends and can be added to any server.
</p>
</div>
- <Button onClick={() => setCreateOpen(true)}>
- <Plus className="size-4" />
- Create a bot
- </Button>
+ <div className="flex items-center gap-1">
+ <Button
+ variant="ghost"
+ size="icon"
+ aria-label="How your agent works"
+ onClick={() => setHelpOpen(true)}
+ className="text-muted-foreground hover:text-foreground"
+ >
+ <HelpCircle className="size-5" />
+ </Button>
+ <Button onClick={() => setCreateOpen(true)}>Create a bot</Button>
+ </div>
</header>
<div className="flex flex-col gap-6">
@@ -385,6 +401,7 @@ export function BotList({ onBack }: { onBack?: () => void } = {}) {
</div>
<CreateBotSheet open={createOpen} onOpenChange={setCreateOpen} />
+ <AgentHelpGallery open={helpOpen} onOpenChange={setHelpOpen} />
<EditBotSheet bot={editingBot} open={editOpen} onOpenChange={setEditOpen} />
<BotActivityModal
bot={activityBot}
diff --git a/src/web/src/components/community/machines/machine-list.tsx b/src/web/src/components/community/machines/machine-list.tsx
index ebfe1da18..0ace2ab6e 100644
--- a/src/web/src/components/community/machines/machine-list.tsx
+++ b/src/web/src/components/community/machines/machine-list.tsx
@@ -3,7 +3,7 @@
import { useCallback, useEffect, useRef, useState } from "react"
import { useRouter, useSearchParams } from "next/navigation"
import { toast } from "sonner"
-import { ChevronLeft, Monitor } from "lucide-react"
+import { ChevronLeft } from "lucide-react"
import { useQueryClient } from "@tanstack/react-query"
import type { CommunityMachineSummary } from "@alook/shared"
import { isPresenceOnline } from "@alook/shared"
@@ -21,6 +21,7 @@ import {
import { apiFetch } from "@/lib/api/client"
import { MachineCard } from "./machine-card"
import { PairMachineSheet, type PairMachineSheetMode } from "./pair-machine-sheet"
+import { ConnectTile } from "@/components/community/onboarding-tiles/connect-tile"
import { useMachines, type MachinesResponse } from "@/hooks/community/use-machines"
import { useBots } from "@/hooks/community/use-bots"
import { useCommunityStore, usePendingMachineTokenId } from "@/stores/community"
@@ -165,14 +166,16 @@ export function MachineList({ onBack }: { onBack?: () => void } = {}) {
<div className="flex min-h-0 flex-1 flex-col">
{backBar}
<div className="flex flex-1 flex-col items-center justify-center gap-4 p-12 text-center">
- <div className="grid size-12 place-items-center rounded-2xl bg-secondary text-muted-foreground">
- <Monitor className="size-6" />
+ <div className="w-full max-w-70 overflow-hidden rounded-xl">
+ <div className="aspect-200/130 w-full">
+ <ConnectTile />
+ </div>
</div>
<div className="flex flex-col gap-1">
<h2 className="text-lg font-medium text-foreground">No machines yet</h2>
<p className="max-w-md text-sm text-muted-foreground">
- Connect your computer to keep your agent always-on. Generate a key,
- run the daemon, and the machine shows up here.
+ Connect a machine and your bots run on it always-on — reach them from
+ your phone or anywhere, wherever you sign in.
</p>
</div>
<Button onClick={openPair}>Connect a machine</Button>
diff --git a/src/web/src/components/community/onboarding-tiles/agent-help-gallery.tsx b/src/web/src/components/community/onboarding-tiles/agent-help-gallery.tsx
new file mode 100644
index 000000000..cb25a6cce
--- /dev/null
+++ b/src/web/src/components/community/onboarding-tiles/agent-help-gallery.tsx
@@ -0,0 +1,122 @@
+"use client"
+
+import { useState } from "react"
+import { ChevronLeft, ChevronRight, X } from "lucide-react"
+import { Button } from "@/components/ui/button"
+import {
+ Dialog,
+ DialogClose,
+ DialogContent,
+ DialogDescription,
+ DialogTitle,
+} from "@/components/ui/dialog"
+import { MemoryTile } from "./memory-tile"
+import { WorkspaceTile } from "./workspace-tile"
+import { NapTile } from "./nap-tile"
+
+// "How your agent works" — a help gallery of the agent mechanics that don't get
+// their own empty state (Memory / Local workspace / Nap). One explainer per view,
+// stepped left/right (Gus's call: not all at once). Opened from the ? in the My
+// Bots header. Each slide mounts its own animated tile only while visible, so the
+// GSAP timelines don't run for hidden slides.
+const SLIDES = [
+ {
+ key: "memory",
+ title: "Memory",
+ tile: MemoryTile,
+ body: "Your agent has a built-in memory: it writes to memory.md, experiences, and a timeline. These survive a reset and load back on wake.",
+ },
+ {
+ key: "workspace",
+ title: "Local workspace",
+ tile: WorkspaceTile,
+ body: "Each agent gets a private folder on your machine. Its files — and the runtime itself — stay local; nothing is uploaded.",
+ },
+ {
+ key: "nap",
+ title: "Nap",
+ tile: NapTile,
+ body: "With time and work, your agent piles up context from every turn. Tell it to \"nap\" to clear that short-term context and start fresh — it leaves a handoff note first.",
+ },
+] as const
+
+export function AgentHelpGallery({
+ open,
+ onOpenChange,
+}: {
+ open: boolean
+ onOpenChange: (open: boolean) => void
+}) {
+ const [i, setI] = useState(0)
+ const slide = SLIDES[i]
+ const Tile = slide.tile
+ const go = (dir: 1 | -1) => setI((n) => (n + dir + SLIDES.length) % SLIDES.length)
+
+ return (
+ <Dialog open={open} onOpenChange={onOpenChange}>
+ <DialogContent
+ showCloseButton={false}
+ className="flex w-full max-w-lg flex-col gap-0 overflow-hidden p-0 sm:max-w-lg"
+ >
+ <header className="flex items-start justify-between gap-3 px-5 pt-4 pb-3">
+ <div className="flex min-w-0 flex-col gap-0.5">
+ <DialogTitle className="text-base font-medium">How your agent works</DialogTitle>
+ <DialogDescription className="text-xs text-muted-foreground">
+ A few mechanics worth knowing about the agents you own.
+ </DialogDescription>
+ </div>
+ <DialogClose
+ render={
+ <Button variant="ghost" size="icon-sm" aria-label="Close" className="-mr-1 shrink-0 text-muted-foreground hover:text-foreground" />
+ }
+ >
+ <X className="size-4" />
+ </DialogClose>
+ </header>
+
+ <div className="flex flex-col gap-3 px-5 pb-5">
+ {/* the animated explainer for the current slide. No border here: the
+ Workspace tile draws its own pane frame, so a wrapper border would
+ double up — a soft fill gives containment without a second stroke. */}
+ <div className="overflow-hidden rounded-xl bg-muted/40">
+ <div className="aspect-200/130 w-full">
+ {/* key remounts the tile per slide so its GSAP timeline restarts */}
+ <Tile key={slide.key} />
+ </div>
+ </div>
+ {/* fixed height so the dialog doesn't wobble as slides swap (bodies
+ differ in length); sized to the tallest copy. */}
+ <div className="flex h-28 flex-col gap-1 text-center">
+ <h3 className="text-sm font-medium text-foreground">{slide.title}</h3>
+ <p className="text-sm leading-relaxed text-muted-foreground">{slide.body}</p>
+ </div>
+
+ {/* stepper: prev · dots · next */}
+ <div className="mt-1 flex items-center justify-between">
+ <Button variant="ghost" size="icon-sm" aria-label="Previous" onClick={() => go(-1)} className="text-muted-foreground hover:text-foreground">
+ <ChevronLeft className="size-5" />
+ </Button>
+ <div className="flex items-center gap-1.5">
+ {SLIDES.map((s, n) => (
+ <button
+ key={s.key}
+ type="button"
+ aria-label={`Go to ${s.title}`}
+ aria-current={n === i}
+ onClick={() => setI(n)}
+ className={
+ "size-1.5 rounded-full transition-colors " +
+ (n === i ? "bg-foreground" : "bg-border hover:bg-muted-foreground")
+ }
+ />
+ ))}
+ </div>
+ <Button variant="ghost" size="icon-sm" aria-label="Next" onClick={() => go(1)} className="text-muted-foreground hover:text-foreground">
+ <ChevronRight className="size-5" />
+ </Button>
+ </div>
+ </div>
+ </DialogContent>
+ </Dialog>
+ )
+}
diff --git a/src/web/src/components/community/onboarding-tiles/connect-tile.tsx b/src/web/src/components/community/onboarding-tiles/connect-tile.tsx
new file mode 100644
index 000000000..82ed4fb45
--- /dev/null
+++ b/src/web/src/components/community/onboarding-tiles/connect-tile.tsx
@@ -0,0 +1,83 @@
+"use client"
+
+import { useRef } from "react"
+import gsap from "gsap"
+import { useGSAP } from "@gsap/react"
+import { TileDefs, tileIds } from "./tile-defs"
+import { OT_EASE } from "./tile-motion"
+
+// "Connect your machine" — Alook is the HUB (top); your computer (bottom-left)
+// and phone (bottom-right) each link only THROUGH Alook (no device↔device edge).
+// A green dot circulates computer → Alook → phone → Alook → computer, always
+// routing through the hub, pulsing a flare at each node on arrival. This reads
+// as "your local bot, reachable from your phone or anywhere". Nodes stay still;
+// edges are trimmed sub-segments of the dot's path so nothing overlaps the icons.
+const AL = { x: 100, y: 32 }
+const PC = { x: 57, y: 96 }
+const PH = { x: 143, y: 96 }
+
+export function ConnectTile({ idPrefix = "ot-connect" }: { idPrefix?: string }) {
+ const ref = useRef<SVGSVGElement>(null)
+ const id = tileIds(idPrefix)
+
+ useGSAP(
+ () => {
+ const scope = ref.current
+ if (!scope) return
+ // flare pulse at a node: an expanding+fading ring + a brightness blip
+ const flareAt = (tl: gsap.core.Timeline, nodeSel: string, x: number, y: number) => {
+ tl.set(".ot-flare", { attr: { cx: x, cy: y, r: 3 }, opacity: 0.9 })
+ .to(".ot-flare", { attr: { r: 12 }, opacity: 0, duration: 0.7, ease: "power2.out" })
+ .to(nodeSel, { filter: "brightness(1.7)", duration: 0.14, ease: "power2.out" }, "<")
+ .to(nodeSel, { filter: "brightness(1)", duration: 0.6, ease: "power1.out" }, "<0.14")
+ }
+ // one leg: dot rides the edge center-to-center, lands, flares
+ const leg = (tl: gsap.core.Timeline, from: typeof AL, to: typeof AL, nodeSel: string) => {
+ tl.set(".ot-packet", { attr: { cx: from.x, cy: from.y, r: 4 }, opacity: 0 })
+ .to(".ot-packet", { opacity: 1, duration: 0.2 })
+ .to(".ot-packet", { attr: { cx: to.x, cy: to.y }, duration: 0.85, ease: "power1.inOut" })
+ .to(".ot-packet", { opacity: 0, duration: 0.14 })
+ flareAt(tl, nodeSel, to.x, to.y)
+ tl.to({}, { duration: 0.25 })
+ }
+ const tl = gsap.timeline({ repeat: -1, defaults: { ease: OT_EASE } })
+ leg(tl, PC, AL, ".ot-alook") // computer → Alook
+ leg(tl, AL, PH, ".ot-phone") // Alook → phone
+ leg(tl, PH, AL, ".ot-alook") // phone → Alook (back through hub)
+ leg(tl, AL, PC, ".ot-machine") // Alook → computer
+ tl.to({}, { duration: 0.3 })
+ },
+ { scope: ref }
+ )
+
+ return (
+ <svg ref={ref} viewBox="0 0 200 130" className="ot-svg h-full w-full">
+ <TileDefs idPrefix={idPrefix} />
+ {/* connectors: exact sub-segments (38%–70%) of each Alook↔device center line,
+ so the dot rides right on the line; equal length, gap at both ends. */}
+ <line className="ot-art" x1="83.7" y1="56.3" x2="70.1" y2="76.8" opacity="0.28" />
+ <line className="ot-art" x1="116.3" y1="56.3" x2="129.9" y2="76.8" opacity="0.28" />
+ {/* Alook hub (top) — neutral foreground color, like the logo everywhere else */}
+ <g className="ot-alook ot-center text-foreground">
+ <svg x="83" y="15" width="34" height="34" viewBox="3 5 22 22">
+ <use href={`#${id.alook}`} />
+ </svg>
+ </g>
+ {/* your computer (bottom-left) */}
+ <g className="ot-machine ot-center">
+ <svg x="40" y="79" width="34" height="34" viewBox="0 0 24 24">
+ <use href={`#${id.monitor}`} />
+ </svg>
+ </g>
+ {/* your phone (bottom-right) */}
+ <g className="ot-phone ot-center">
+ <svg x="130" y="83" width="26" height="26" viewBox="0 0 24 24">
+ <use href={`#${id.phone}`} />
+ </svg>
+ </g>
+ {/* flare ring (pulses at whichever node the dot reaches) + the traveling dot */}
+ <circle className="ot-art ot-accent ot-flare" cx="100" cy="32" r="4" opacity="0" strokeWidth="2.5" />
+ <circle className="ot-art-fill ot-accent ot-packet" cx="100" cy="32" r="4" opacity="0" />
+ </svg>
+ )
+}
diff --git a/src/web/src/components/community/onboarding-tiles/create-tile.tsx b/src/web/src/components/community/onboarding-tiles/create-tile.tsx
new file mode 100644
index 000000000..e2d696962
--- /dev/null
+++ b/src/web/src/components/community/onboarding-tiles/create-tile.tsx
@@ -0,0 +1,78 @@
+"use client"
+
+import { useRef } from "react"
+import gsap from "gsap"
+import { useGSAP } from "@gsap/react"
+import { TileDefs, tileIds } from "./tile-defs"
+import { OT_EASE, comeOnline } from "./tile-motion"
+
+// "Create your first bot" — an empty dashed slot with a plus morphs into a live
+// avatar that comes online, recomposes into the app's real message row, and posts
+// its first message ("Hello World"), then loops back to the empty slot.
+export function CreateTile({ idPrefix = "ot-create" }: { idPrefix?: string }) {
+ const ref = useRef<SVGSVGElement>(null)
+ const id = tileIds(idPrefix)
+
+ useGSAP(
+ () => {
+ const scope = ref.current
+ if (!scope) return
+ gsap.set(".ot-bot", { opacity: 0, scale: 0.9 })
+ gsap.set(".ot-dot", { opacity: 0 })
+ gsap.set(".ot-say", { opacity: 0 })
+ gsap.set(".ot-av", { x: 0, y: 0, scale: 1, svgOrigin: "100 65" })
+ const tl = gsap.timeline({ repeat: -1, defaults: { ease: OT_EASE } })
+ // ACT 1: empty slot → centered avatar appears
+ tl.fromTo(".ot-plus", { scale: 0.9 }, { scale: 1.12, duration: 0.9, yoyo: true, repeat: 1 })
+ .to(".ot-ph", { opacity: 0, scale: 1.06, duration: 0.55 }, "+=0.15")
+ .to(".ot-bot", { opacity: 1, scale: 1, duration: 0.55 }, "<")
+ comeOnline(tl, ".ot-dot", 120.5, 85.5, "-=0.1")
+ // ACT 2: recompose into the real message row + post first message
+ tl.to(".ot-av", { scale: 0.77, x: -50, y: -4, duration: 0.6, svgOrigin: "100 65" }, "+=0.5")
+ .from(".ot-say", { x: -8, duration: 0.5 }, "<0.15")
+ .to(".ot-say", { opacity: 1, duration: 0.4 }, "<")
+ .to({}, { duration: 1.6 })
+ // loop back to the empty slot
+ .to(".ot-say", { opacity: 0, x: -8, duration: 0.4 })
+ .to(".ot-av", { scale: 0.9, x: 0, y: 0, duration: 0.45, svgOrigin: "100 65" }, "<0.1")
+ .to(".ot-bot", { opacity: 0, duration: 0.4 })
+ .set(".ot-dot", { opacity: 0 })
+ .set(".ot-av", { scale: 1 })
+ .to(".ot-ph", { opacity: 1, scale: 1, duration: 0.5 }, "<0.1")
+ .to({}, { duration: 0.5 })
+ },
+ { scope: ref }
+ )
+
+ return (
+ <svg ref={ref} viewBox="0 0 200 130" className="ot-svg h-full w-full">
+ <TileDefs idPrefix={idPrefix} />
+ <g className="ot-ph ot-center">
+ <rect className="ot-art" x="74" y="39" width="52" height="52" rx="16" strokeDasharray="7 7" opacity="0.65" />
+ <g className="ot-plus ot-center">
+ <line className="ot-art" x1="100" y1="55" x2="100" y2="75" />
+ <line className="ot-art" x1="90" y1="65" x2="110" y2="65" />
+ </g>
+ </g>
+ <g className="ot-bot ot-center" opacity="0">
+ <g className="ot-av">
+ <svg x="74" y="39" width="52" height="52" viewBox="0 0 36 36">
+ <g clipPath={`url(#${id.disc})`}>
+ <use href={`#${id.faceB}`} />
+ </g>
+ </svg>
+ <g className="ot-online">
+ <circle cx="120.5" cy="85.5" r="8.5" fill="var(--card)" />
+ <circle cx="120.5" cy="85.5" r="5.5" fill="var(--muted-foreground)" />
+ <circle className="ot-dot" cx="120.5" cy="85.5" r="5.5" fill="var(--status-online)" />
+ </g>
+ </g>
+ <g className="ot-say" opacity="0">
+ <text x="82" y="60" fontFamily="DM Sans, sans-serif" fontSize="15" fontWeight="600" fill="var(--foreground)">Alli</text>
+ <text x="112" y="60" fontFamily="DM Sans, sans-serif" fontSize="12" fill="var(--muted-foreground)">now</text>
+ <text x="82" y="80" fontFamily="DM Sans, sans-serif" fontSize="15" fill="var(--foreground)">Hello World</text>
+ </g>
+ </g>
+ </svg>
+ )
+}
diff --git a/src/web/src/components/community/onboarding-tiles/memory-tile.tsx b/src/web/src/components/community/onboarding-tiles/memory-tile.tsx
new file mode 100644
index 000000000..44265b619
--- /dev/null
+++ b/src/web/src/components/community/onboarding-tiles/memory-tile.tsx
@@ -0,0 +1,108 @@
+"use client"
+
+import { useRef } from "react"
+import gsap from "gsap"
+import { useGSAP } from "@gsap/react"
+import { TileDefs, tileIds } from "./tile-defs"
+import { OT_EASE, breathe, comeOnline, goOffline } from "./tile-motion"
+
+// "Memory" — the agent's memory sources ORBIT around it (they belong to it &
+// persist). Each rides a ring, PAUSES at the top to reveal its label (memory.md /
+// experiences / timeline), then shrinks to an icon as it rotates on. On reset the
+// live self dims but the orbit keeps turning; on wake the agent relights.
+export function MemoryTile({ idPrefix = "ot-memory" }: { idPrefix?: string }) {
+ const ref = useRef<SVGSVGElement>(null)
+ const id = tileIds(idPrefix)
+
+ useGSAP(
+ () => {
+ const scope = ref.current
+ if (!scope) return
+ const CX = 100, CY = 62, R = 40
+ const TOP = -90
+ const srcs = [".ot-src0", ".ot-src1", ".ot-src2"].map((sel, i) => {
+ const g = scope.querySelector(sel) as SVGGElement
+ return {
+ g,
+ lbl: g.querySelector(".ot-lbl") as SVGTextElement,
+ base: TOP + i * 120,
+ }
+ })
+ const place = (s: (typeof srcs)[number], deg: number) => {
+ const a = (deg * Math.PI) / 180
+ const x = CX + R * Math.cos(a)
+ const y = CY + R * Math.sin(a)
+ const d = (((deg - TOP) % 360) + 540) % 360 - 180
+ const near = Math.max(0, 1 - Math.abs(d) / 60)
+ s.g.setAttribute("transform", `translate(${x.toFixed(2)} ${y.toFixed(2)})`)
+ s.g.style.opacity = (0.5 + 0.5 * near).toFixed(3)
+ }
+ const spin = { a: 0 }
+ gsap.set(".ot-dot", { opacity: 1 })
+ gsap.set(".ot-lbl", { opacity: 0 })
+ srcs.forEach((s) => place(s, s.base))
+ breathe(scope, ".ot-agent", 1.02, 3.4)
+
+ // step orbit: reveal top label → dwell → hide → rotate 120° → reveal new top
+ const orbit = gsap.timeline({ repeat: -1 })
+ for (let k = 0; k < 3; k++) {
+ const cur = srcs[(((-k % 3) + 3) % 3)]
+ orbit
+ .to(cur.lbl, { opacity: 1, duration: 0.3 })
+ .to({}, { duration: 0.6 })
+ .to(cur.lbl, { opacity: 0, duration: 0.25 })
+ .to(spin, {
+ a: "+=120",
+ duration: 0.85,
+ ease: "power2.inOut",
+ onUpdate: () => srcs.forEach((s) => place(s, s.base + spin.a)),
+ })
+ }
+
+ // reset/wake on the live self only — the orbit never stops
+ const tl = gsap.timeline({ repeat: -1, defaults: { ease: OT_EASE } })
+ tl.to({}, { duration: 3 }).to(".ot-agent", { opacity: 0.3, duration: 0.5 })
+ goOffline(tl, ".ot-dot", 112, 73, "<")
+ tl.to({}, { duration: 1.1 }).to(".ot-agent", { opacity: 1, duration: 0.5 })
+ comeOnline(tl, ".ot-dot", 112, 73, "<")
+ tl.to({}, { duration: 1.5 })
+ },
+ { scope: ref }
+ )
+
+ const srcData = [
+ { cls: "ot-src0", icon: id.book, label: "memory.md" },
+ { cls: "ot-src1", icon: id.layers, label: "experiences" },
+ { cls: "ot-src2", icon: id.clock, label: "timeline" },
+ ]
+
+ return (
+ <svg ref={ref} viewBox="0 0 200 130" className="ot-svg h-full w-full">
+ <TileDefs idPrefix={idPrefix} />
+ <circle cx="100" cy="62" r="40" className="ot-art" opacity="0.14" strokeDasharray="2 5" />
+ <g className="ot-agent ot-center">
+ <svg x="83" y="45" width="34" height="34" viewBox="0 0 36 36">
+ <g clipPath={`url(#${id.disc})`}>
+ <use href={`#${id.faceA}`} />
+ </g>
+ </svg>
+ </g>
+ <g className="ot-online">
+ <circle cx="112" cy="73" r="6" fill="var(--card)" />
+ <circle cx="112" cy="73" r="4" fill="var(--muted-foreground)" />
+ <circle className="ot-dot" cx="112" cy="73" r="4" fill="var(--status-online)" />
+ </g>
+ {srcData.map((s) => (
+ <g key={s.cls} className={`ot-src ${s.cls}`}>
+ <circle className="ot-pill" cx="0" cy="0" r="12" fill="var(--muted)" />
+ <svg className="ot-ic ot-accent" x="-8" y="-8" width="16" height="16" viewBox="0 0 24 24">
+ <use href={`#${s.icon}`} />
+ </svg>
+ <text className="ot-lbl" x="16" y="4" textAnchor="start" fontFamily="DM Mono, monospace" fontSize="8.5" fill="var(--foreground)" opacity="0">
+ {s.label}
+ </text>
+ </g>
+ ))}
+ </svg>
+ )
+}
diff --git a/src/web/src/components/community/onboarding-tiles/nap-tile.tsx b/src/web/src/components/community/onboarding-tiles/nap-tile.tsx
new file mode 100644
index 000000000..7bef7dfac
--- /dev/null
+++ b/src/web/src/components/community/onboarding-tiles/nap-tile.tsx
@@ -0,0 +1,103 @@
+"use client"
+
+import { useRef } from "react"
+import gsap from "gsap"
+import { useGSAP } from "@gsap/react"
+import { TileDefs, tileIds } from "./tile-defs"
+import { OT_EASE, comeOnline, goOffline } from "./tile-motion"
+
+// "Nap" — the context meter is a RING around the agent. It fills 0→100% and the
+// agent's breathing slows (getting heavier); then it sleeps (dims, dot offline,
+// moon + zzz rise), the ring empties back to 0% while asleep, and it wakes with a
+// clean context (relights, breathing back to normal speed).
+export function NapTile({ idPrefix = "ot-nap" }: { idPrefix?: string }) {
+ const ref = useRef<SVGSVGElement>(null)
+ const id = tileIds(idPrefix)
+
+ useGSAP(
+ () => {
+ const scope = ref.current
+ if (!scope) return
+ const C = 188.5 // ring circumference (2π·30)
+ const ringEl = scope.querySelector(".ot-ring") as SVGCircleElement
+ const pctEl = scope.querySelector(".ot-pct") as SVGTextElement
+ gsap.set(".ot-sleep", { opacity: 0, y: 4 })
+ gsap.set(".ot-dot", { opacity: 1 })
+ gsap.set(ringEl, { attr: { "stroke-dashoffset": C } })
+ pctEl.textContent = "context 0%"
+ const br = gsap.to(".ot-agent", { scale: 1.03, duration: 2, ease: OT_EASE, yoyo: true, repeat: -1, transformOrigin: "center" })
+
+ const ctx = { v: 0 }
+ const sync = () => {
+ pctEl.textContent = "context " + Math.round(ctx.v) + "%"
+ ringEl.setAttribute("stroke-dashoffset", (C * (1 - ctx.v / 100)).toFixed(1))
+ }
+ const tl = gsap.timeline({ repeat: -1, defaults: { ease: OT_EASE } })
+ // FILL: ring fills 0→100%, % ticks up, breathe slows
+ tl.to(ctx, {
+ v: 100,
+ duration: 3.2,
+ ease: "power1.in",
+ onUpdate: () => {
+ sync()
+ br.timeScale(1 - (ctx.v / 100) * 0.7)
+ },
+ })
+ .to({}, { duration: 0.5 })
+ // SLEEP: agent dims, dot offline, moon + zzz rise
+ .to(".ot-agent", { opacity: 0.32, duration: 0.5 })
+ .to(".ot-sleep", { opacity: 0.9, y: -6, duration: 0.9, ease: "power1.out" }, "<0.1")
+ goOffline(tl, ".ot-dot", 112, 71, "<")
+ // CLEAR: while asleep the ring empties back to 0% (fresh)
+ tl.to(ctx, { v: 0, duration: 0.7, ease: "power2.inOut", onUpdate: sync }, "<0.1")
+ .to(".ot-sleep", { opacity: 0, duration: 0.4 })
+ // WAKE: clean context, agent brightens, breathe back to normal speed
+ .to(".ot-agent", { opacity: 1, duration: 0.5, onStart: () => br.timeScale(1) }, "+=0.3")
+ comeOnline(tl, ".ot-dot", 112, 71, "<")
+ tl.to({}, { duration: 1.0 })
+ },
+ { scope: ref }
+ )
+
+ return (
+ <svg ref={ref} viewBox="0 0 200 130" className="ot-svg h-full w-full">
+ <TileDefs idPrefix={idPrefix} />
+ <circle cx="100" cy="60" r="30" fill="none" stroke="var(--muted)" strokeWidth="5" />
+ <circle
+ className="ot-ring"
+ cx="100"
+ cy="60"
+ r="30"
+ fill="none"
+ stroke="var(--status-online)"
+ strokeWidth="5"
+ strokeLinecap="round"
+ transform="rotate(-90 100 60)"
+ strokeDasharray="188.5"
+ strokeDashoffset="188.5"
+ />
+ <g className="ot-agent ot-center">
+ <svg x="83" y="43" width="34" height="34" viewBox="0 0 36 36">
+ <g clipPath={`url(#${id.disc})`}>
+ <use href={`#${id.faceA}`} />
+ </g>
+ </svg>
+ </g>
+ <g className="ot-online">
+ <circle cx="112" cy="71" r="6" fill="var(--card)" />
+ <circle cx="112" cy="71" r="4" fill="var(--muted-foreground)" />
+ <circle className="ot-dot" cx="112" cy="71" r="4" fill="var(--status-online)" />
+ </g>
+ <text className="ot-pct" x="100" y="106" textAnchor="middle" fontFamily="DM Mono, monospace" fontSize="10" fill="var(--muted-foreground)">
+ context 0%
+ </text>
+ <g className="ot-sleep ot-accent ot-center" opacity="0">
+ <svg x="140" y="30" width="20" height="20" viewBox="0 0 24 24">
+ <use href={`#${id.moon}`} />
+ </svg>
+ <text x="163" y="40" fontFamily="DM Mono, monospace" fontSize="12" fill="currentColor">z</text>
+ <text x="172" y="32" fontFamily="DM Mono, monospace" fontSize="8" fill="currentColor">z</text>
+ </g>
+ </svg>
+ )
+}
diff --git a/src/web/src/components/community/onboarding-tiles/tile-defs.tsx b/src/web/src/components/community/onboarding-tiles/tile-defs.tsx
new file mode 100644
index 000000000..5637836c3
--- /dev/null
+++ b/src/web/src/components/community/onboarding-tiles/tile-defs.tsx
@@ -0,0 +1,100 @@
+// Shared SVG assets for the onboarding motion tiles (Connect / Create / Memory /
+// Workspace / Nap). Defined once and referenced by <use> inside each tile's SVG.
+// Real Alook assets: lucide icon paths (exact, from [email protected]), the app's
+// alook logo mark, beam faces from renderFaceSvg, and the circular avatar disc clip.
+//
+// IMPORTANT: <use href="#id"> resolves against ids that must be unique in the
+// document. Each tile mounts its own copy of <TileDefs> with an `idPrefix` so
+// several tiles can coexist on one page (the gallery shows three at once) without
+// id collisions. The tile passes the same prefix to its <use href> refs.
+
+export function tileIds(p: string) {
+ return {
+ disc: `${p}-disc`,
+ monitor: `${p}-ic-monitor`,
+ file: `${p}-ic-file`,
+ moon: `${p}-ic-moon`,
+ book: `${p}-ic-book`,
+ layers: `${p}-ic-layers`,
+ clock: `${p}-ic-clock`,
+ alook: `${p}-ic-alook`,
+ phone: `${p}-ic-phone`,
+ faceA: `${p}-face-a`,
+ faceB: `${p}-face-b`,
+ }
+}
+
+export function TileDefs({ idPrefix }: { idPrefix: string }) {
+ const id = tileIds(idPrefix)
+ return (
+ <defs>
+ {/* circular avatar crop (the app shows beam faces clipped to a disc) */}
+ <clipPath id={id.disc} clipPathUnits="userSpaceOnUse">
+ <circle cx="18" cy="18" r="18" />
+ </clipPath>
+
+ {/* lucide icons — 24×24, exact path data from [email protected] */}
+ <g id={id.monitor}>
+ <rect className="ot-art" width="20" height="14" x="2" y="3" rx="2" />
+ <line className="ot-art" x1="8" x2="16" y1="21" y2="21" />
+ <line className="ot-art" x1="12" x2="12" y1="17" y2="21" />
+ </g>
+ <g id={id.file}>
+ <path className="ot-art" d="M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z" />
+ <path className="ot-art" d="M14 2v5a1 1 0 0 0 1 1h5" />
+ <path className="ot-art" d="M10 9H8" />
+ <path className="ot-art" d="M16 13H8" />
+ <path className="ot-art" d="M16 17H8" />
+ </g>
+ <g id={id.moon}>
+ <path className="ot-art" d="M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401" />
+ </g>
+ <g id={id.phone}>
+ <rect className="ot-art" width="14" height="20" x="5" y="2" rx="2" ry="2" />
+ <path className="ot-art" d="M12 18h.01" />
+ </g>
+ {/* memory sources: memory.md=book-marked, experiences=layers, timeline=clock */}
+ <g id={id.book}>
+ <path className="ot-art" d="M10 2v8l3-3 3 3V2" />
+ <path className="ot-art" d="M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20" />
+ </g>
+ <g id={id.layers}>
+ <path className="ot-art" d="M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83z" />
+ <path className="ot-art" d="M2 12a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 12" />
+ <path className="ot-art" d="M2 17a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 17" />
+ </g>
+ <g id={id.clock}>
+ <circle className="ot-art" cx="12" cy="12" r="10" />
+ <path className="ot-art" d="M12 6v6l4 2" />
+ </g>
+
+ {/* Alook logo mark (public/alook.svg) — nested-svg viewBox 3 5 22 22 */}
+ <g id={id.alook}>
+ <rect x="4" y="6" width="18" height="18" rx="3" fill="currentColor" opacity="0.4" />
+ <rect x="6" y="8" width="18" height="18" rx="3" fill="currentColor" />
+ <rect x="9.5" y="13" width="11" height="9" rx="2" fill="var(--card)" />
+ <path d="M 10 13.5 Q 15 18.5 20 13.5" fill="none" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" />
+ </g>
+
+ {/* Real beam faces (renderFaceSvg). faceA = existing agent, faceB = new bot. */}
+ <g id={id.faceA}>
+ <rect width="36" height="36" fill="#2a5540" />
+ <g transform="translate(1.38 0.40) rotate(-4 18 23.5) translate(-0.18 -0.24) scale(1.010)">
+ <path d="M32.45 23.50 L32.42 24.41 L32.34 25.31 L32.19 26.21 L32.00 27.09 L31.74 27.97 L31.44 28.82 L31.07 29.65 L30.66 30.46 L30.20 31.24 L29.69 31.99 L29.13 32.71 L28.53 33.39 L27.89 34.03 L27.21 34.63 L26.49 35.19 L25.74 35.70 L24.96 36.16 L24.15 36.57 L23.32 36.94 L22.47 37.24 L21.59 37.50 L20.71 37.69 L19.81 37.84 L18.91 37.92 L18.00 37.95 L17.09 37.92 L16.19 37.84 L15.29 37.69 L14.41 37.50 L13.53 37.24 L12.68 36.94 L11.85 36.57 L11.04 36.16 L10.26 35.70 L9.51 35.19 L8.79 34.63 L8.11 34.03 L7.47 33.39 L6.87 32.71 L6.31 31.99 L5.80 31.24 L5.34 30.46 L4.93 29.65 L4.56 28.82 L4.26 27.97 L4.00 27.09 L3.81 26.21 L3.66 25.31 L3.58 24.41 L3.55 23.50 L3.58 22.59 L3.66 21.69 L3.81 20.79 L4.00 19.91 L4.26 19.03 L4.56 18.18 L4.93 17.35 L5.34 16.54 L5.80 15.76 L6.31 15.01 L6.87 14.29 L7.47 13.61 L8.11 12.97 L8.79 12.37 L9.51 11.81 L10.26 11.30 L11.04 10.84 L11.85 10.43 L12.68 10.06 L13.53 9.76 L14.41 9.50 L15.29 9.31 L16.19 9.16 L17.09 9.08 L18.00 9.05 L18.91 9.08 L19.81 9.16 L20.71 9.31 L21.59 9.50 L22.47 9.76 L23.32 10.06 L24.15 10.43 L24.96 10.84 L25.74 11.30 L26.49 11.81 L27.21 12.37 L27.89 12.97 L28.53 13.61 L29.13 14.29 L29.69 15.01 L30.20 15.76 L30.66 16.54 L31.07 17.35 L31.44 18.18 L31.74 19.03 L32.00 19.91 L32.19 20.79 L32.34 21.69 L32.42 22.59 L32.45 23.50 Z" fill="#e7f3ec" />
+ <path d="M12.2 20.7 q1.8 -2 3.6 0" stroke="#12241b" strokeWidth="1.6" fill="none" strokeLinecap="round" />
+ <path d="M20.2 20.7 q1.8 -2 3.6 0" stroke="#12241b" strokeWidth="1.6" fill="none" strokeLinecap="round" />
+ <path d="M14.5 24q3.5 2.6 7 0" stroke="#12241b" strokeWidth="1.5" fill="none" strokeLinecap="round" />
+ </g>
+ </g>
+ <g id={id.faceB}>
+ <rect width="36" height="36" fill="#2a5540" />
+ <g transform="translate(-0.46 0.40) rotate(-3 18 23.5) translate(-0.18 -0.24) scale(1.010)">
+ <path d="M31.53 23.50 L31.44 24.35 L31.18 25.16 L30.76 25.93 L30.22 26.64 L29.57 27.26 L28.86 27.80 L28.13 28.27 L27.40 28.67 L26.70 29.02 L26.07 29.36 L25.50 29.70 L25.01 30.08 L24.58 30.51 L24.20 31.00 L23.86 31.57 L23.52 32.20 L23.17 32.90 L22.77 33.63 L22.30 34.36 L21.76 35.07 L21.14 35.72 L20.43 36.26 L19.66 36.68 L18.85 36.94 L18.00 37.03 L17.15 36.94 L16.34 36.68 L15.57 36.26 L14.86 35.72 L14.24 35.07 L13.70 34.36 L13.23 33.63 L12.83 32.90 L12.48 32.20 L12.14 31.57 L11.80 31.00 L11.42 30.51 L10.99 30.08 L10.50 29.70 L9.93 29.36 L9.30 29.02 L8.60 28.67 L7.87 28.27 L7.14 27.80 L6.43 27.26 L5.78 26.64 L5.24 25.93 L4.82 25.16 L4.56 24.35 L4.47 23.50 L4.56 22.65 L4.82 21.84 L5.24 21.07 L5.78 20.36 L6.43 19.74 L7.14 19.20 L7.87 18.73 L8.60 18.33 L9.30 17.98 L9.93 17.64 L10.50 17.30 L10.99 16.92 L11.42 16.49 L11.80 16.00 L12.14 15.43 L12.48 14.80 L12.83 14.10 L13.23 13.37 L13.70 12.64 L14.24 11.93 L14.86 11.28 L15.57 10.74 L16.34 10.32 L17.15 10.06 L18.00 9.97 L18.85 10.06 L19.66 10.32 L20.43 10.74 L21.14 11.28 L21.76 11.93 L22.30 12.64 L22.77 13.37 L23.17 14.10 L23.52 14.80 L23.86 15.43 L24.20 16.00 L24.58 16.49 L25.01 16.92 L25.50 17.30 L26.07 17.64 L26.70 17.98 L27.40 18.33 L28.13 18.73 L28.86 19.20 L29.57 19.74 L30.22 20.36 L30.76 21.07 L31.18 21.84 L31.44 22.65 L31.53 23.50 Z" fill="#e7f3ec" />
+ <circle cx="13" cy="20" r="1.9" fill="#12241b" />
+ <path d="M21.2 20 q1.8 1.7 3.6 0" stroke="#12241b" strokeWidth="1.6" fill="none" strokeLinecap="round" />
+ <path d="M14.5 25q3.5 2.6 7 0" stroke="#12241b" strokeWidth="1.5" fill="none" strokeLinecap="round" />
+ </g>
+ </g>
+ </defs>
+ )
+}
diff --git a/src/web/src/components/community/onboarding-tiles/tile-motion.ts b/src/web/src/components/community/onboarding-tiles/tile-motion.ts
new file mode 100644
index 000000000..942485ffb
--- /dev/null
+++ b/src/web/src/components/community/onboarding-tiles/tile-motion.ts
@@ -0,0 +1,36 @@
+import gsap from "gsap"
+
+// Shared motion helpers ported from the design prototype. All selectors are
+// resolved within a per-tile scope (useGSAP({ scope: ref })), so class-based
+// selectors like ".ot-dot" are safe even when several tiles mount at once.
+
+export const OT_EASE = "sine.inOut"
+
+// Gentle idle "breathing" of the agent avatar. Returns the tween so callers can
+// vary its timeScale (Nap slows it as context fills).
+export function breathe(scope: Element, sel: string, amt = 1.02, dur = 3) {
+ return gsap.to(scope.querySelectorAll(sel), {
+ scale: amt,
+ duration: dur,
+ ease: OT_EASE,
+ yoyo: true,
+ repeat: -1,
+ transformOrigin: "center",
+ })
+}
+
+// Presence flip — the online dot goes online/offline IN PLACE (fixed geometry):
+// a small scale pulse about the dot's own center + a DISCRETE color swap (the
+// green layer toggles instantly at the pulse peak, so there is no muddy
+// in-between color). ox/oy = the dot's exact center in SVG units.
+export function comeOnline(tl: gsap.core.Timeline, sel: string, ox: number, oy: number, pos?: gsap.Position) {
+ tl.set(sel, { opacity: 1 }, pos)
+ .to(sel, { scale: 1.35, duration: 0.18, ease: "power2.out", svgOrigin: `${ox} ${oy}` }, pos)
+ .to(sel, { scale: 1, duration: 0.28, ease: "power2.inOut", svgOrigin: `${ox} ${oy}` })
+}
+
+export function goOffline(tl: gsap.core.Timeline, sel: string, ox: number, oy: number, pos?: gsap.Position) {
+ tl.to(sel, { scale: 0.82, duration: 0.16, ease: "power2.out", svgOrigin: `${ox} ${oy}` }, pos)
+ .set(sel, { opacity: 0 })
+ .to(sel, { scale: 1, duration: 0.2, ease: "power2.inOut", svgOrigin: `${ox} ${oy}` })
+}
diff --git a/src/web/src/components/community/onboarding-tiles/workspace-tile.tsx b/src/web/src/components/community/onboarding-tiles/workspace-tile.tsx
new file mode 100644
index 000000000..2d2a68f28
--- /dev/null
+++ b/src/web/src/components/community/onboarding-tiles/workspace-tile.tsx
@@ -0,0 +1,67 @@
+"use client"
+
+import { useRef } from "react"
+import gsap from "gsap"
+import { useGSAP } from "@gsap/react"
+import { TileDefs, tileIds } from "./tile-defs"
+import { OT_EASE } from "./tile-motion"
+
+// "Local workspace" — the owning agent sits in the path title-bar (~/.alook/agent);
+// named files (memory.md / work.pdf / todo.md) are written into the dir one by
+// one, rest populated, then clear for the loop. No moving cursor.
+export function WorkspaceTile({ idPrefix = "ot-workspace" }: { idPrefix?: string }) {
+ const ref = useRef<SVGSVGElement>(null)
+ const id = tileIds(idPrefix)
+
+ useGSAP(
+ () => {
+ const scope = ref.current
+ if (!scope) return
+ const files = [".ot-f0", ".ot-f1", ".ot-f2"]
+ gsap.set(files, { opacity: 0 })
+ const tl = gsap.timeline({ repeat: -1, defaults: { ease: OT_EASE } })
+ files.forEach((f, i) => {
+ tl.fromTo(f, { opacity: 0 }, { opacity: 1, duration: 0.5 }, i === 0 ? ">" : "+=0.5")
+ })
+ tl.to({}, { duration: 1.7 })
+ .to(files, { opacity: 0, duration: 0.5, stagger: 0.08 })
+ .to({}, { duration: 0.5 })
+ },
+ { scope: ref }
+ )
+
+ const files = [
+ { cls: "ot-f0", ty: "65.5", name: "memory.md" },
+ { cls: "ot-f1", ty: "83.5", name: "work.pdf" },
+ { cls: "ot-f2", ty: "101.5", name: "todo.md" },
+ ]
+
+ return (
+ <svg ref={ref} viewBox="0 0 200 130" className="ot-svg h-full w-full">
+ <TileDefs idPrefix={idPrefix} />
+ <rect className="ot-art" x="20" y="20" width="160" height="100" rx="9" opacity="0.9" />
+ {/* title bar: [agent avatar] ~/.alook/agent — avatar (22px) & file icons (11px) share center-x=40 */}
+ <svg x="29" y="30" width="22" height="22" viewBox="0 0 36 36">
+ <g clipPath={`url(#${id.disc})`}>
+ <use href={`#${id.faceA}`} />
+ </g>
+ </svg>
+ <g className="ot-oon">
+ <circle cx="48" cy="49" r="4" fill="var(--card)" />
+ <circle cx="48" cy="49" r="2.5" fill="var(--status-online)" />
+ </g>
+ <text x="60" y="45" fontFamily="DM Mono, monospace" fontSize="10" fill="var(--foreground)">~/.alook/agent</text>
+ <line className="ot-art" x1="20" y1="58" x2="180" y2="58" opacity="0.35" />
+ {files.map((f) => (
+ <g key={f.cls} className={`ot-wfile ${f.cls}`} transform={`translate(34.5 ${f.ty})`}>
+ <svg x="0" y="0" width="11" height="11" viewBox="0 0 24 24" className="ot-accent">
+ <use href={`#${id.file}`} />
+ </svg>
+ <text x="17" y="9.5" fontFamily="DM Mono, monospace" fontSize="10" fill="var(--foreground)">
+ {f.name}
+ </text>
+ </g>
+ ))}
+ </svg>
+ )
+}
diff --git a/src/web/src/components/community/server-rail.tsx b/src/web/src/components/community/server-rail.tsx
index d7b63d6d8..715d93e2e 100644
--- a/src/web/src/components/community/server-rail.tsx
+++ b/src/web/src/components/community/server-rail.tsx
@@ -20,7 +20,7 @@ import type { Server, CommunityFolder, MobileZone, View } from "./_types"
export const ServerRail = memo(function ServerRail({
servers, folders, activeServerId: activeServerIdProp, serversLoading, serversReady, setMobileZone, view, bottomInset,
- onHome, onServer, onServerNavigate, onCreateServer, onJoinServer, onLeaveServer,
+ onHome, onServer, onEmptyState, onServerNavigate, onCreateServer, onJoinServer, onLeaveServer,
onOpenSettings, onOpenInvitePopover, onUngroupFolder, onReorderRail, onReorderFolders, onFolderItemsChange, onDragCreateFolder,
}: {
servers: Server[]
@@ -39,6 +39,10 @@ export const ServerRail = memo(function ServerRail({
bottomInset?: number
onHome: () => void
onServer: () => void
+ // Fired once when a genuinely-empty user (no servers/folders) first settles —
+ // routes them to the machines page (the real starting point) instead of
+ // popping the create-server dialog. The manual "+" affordance still opens it.
+ onEmptyState?: () => void
onServerNavigate?: (id: string) => void
onCreateServer?: (name: string, icon?: File) => void
onJoinServer?: (invite: string) => void
@@ -84,9 +88,12 @@ export const ServerRail = memo(function ServerRail({
// list is transiently empty. `serversReady` is `isFetched && !isFetching`.
if (!didAutoOpen && serversReady && servers.length === 0 && folders.length === 0) {
setDidAutoOpen(true)
- setCreateOpen(true)
+ // A brand-new user's starting point is connecting a machine, not making a
+ // server (Gus): route to machines instead of auto-popping create-server.
+ // The manual "+" below still opens the dialog on demand.
+ onEmptyState?.()
}
- }, [servers.length, folders.length, serversReady, didAutoOpen])
+ }, [servers.length, folders.length, serversReady, didAutoOpen, onEmptyState])
const sensors = useSensors(useSensor(PointerSensor, { activationConstraint: { distance: 5 } }))
const pickServer = (id: string) => { setActiveId(id); onServer(); onServerNavigate?.(id); setMobileZone?.("nav") }
diff --git a/src/web/src/components/community/shell-frame.tsx b/src/web/src/components/community/shell-frame.tsx
index 706e3bae5..cd97cb1b2 100644
--- a/src/web/src/components/community/shell-frame.tsx
+++ b/src/web/src/components/community/shell-frame.tsx
@@ -174,6 +174,9 @@ export function ShellFrame({
(id: string) => { markSwitch("server", id); router.push(`/c/channels/${id}`) },
[router],
)
+ // A genuinely-empty user starts by connecting a machine, not creating a
+ // server — route there instead of auto-popping the create-server dialog.
+ const onRailEmptyState = useCallback(() => { router.push("/c/me/machines") }, [router])
const onRailCreateServer = useCallback(
async (name: string, icon?: File) => {
try {
@@ -302,6 +305,7 @@ export function ShellFrame({
view,
onHome: goHome,
onServer: goServer,
+ onEmptyState: onRailEmptyState,
onServerNavigate: onRailServerNavigate,
onCreateServer: onRailCreateServer,
onJoinServer: onRailJoinServer,