Skip to content
2,128 linesCodeBlameRaw
1import { Activity, BarChart3, Building2, MessagesSquare, Bell, BookMarked, BookOpen, Bookmark, Blocks, Box, Brain, Check, ChevronDown, ChevronLeft, ChevronRight, CircleDot, GripVertical, CircleUserRound, Code2, Compass, CreditCard, Fingerprint, Gauge, GitBranch, GitPullRequest, Globe, History, Keyboard, KeyRound, Layers, LayoutDashboard, LayoutGrid, LifeBuoy, Lock, LogOut, Mail, MonitorCog, MonitorDown, Package, PlayCircle, Plug, Plus, Rocket, Search, ServerCog, Settings, Shapes, Shield, ShieldCheck, Scale, Smile, Sparkles, House, Ticket, TrendingUp, UserRoundKey, Users, UsersRound, Webhook, X, ArrowLeftRight } from "lucide-react";
2import { Fragment, type ReactNode, useCallback, useEffect, useMemo, useRef, useState } from "react";
3import { Link, useFetcher, useLocation, useNavigation, useRouteLoaderData, useSubmit } from "react-router";
4
5import { type Abilities, type ChatSidebarEntry, type InboxCounts, type Membership, type RepoMirror, type Spike, type User, hasCodeAccess, mayCreateTeams, shownUsername } from "@g1t/contracts";
6
7import { InMain } from "./landmark";
8import { CommandPalette, type PaletteCommand, PaletteKey, usePaletteShortcut } from "./command-palette";
9import { NotificationsBell } from "./inbox";
10import { desktopBridge, useDesktopApp, useTitleBarSearch } from "../lib/notify-client";
11import { PinButton } from "./pin-button";
12import { Hint } from "./ui/hint";
13import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "./ui/collapsible";
14import {
15 Sidebar,
16 SidebarGroup,
17 SidebarGroupAction,
18 SidebarGroupContent,
19 SidebarGroupLabel,
20 SidebarHeader,
21 SidebarMenu,
22 SidebarMenuBadge,
23 SidebarMenuButton,
24 SidebarMenuItem,
25 SidebarMobile,
26 SidebarProvider,
27 SidebarSeparator,
28 SidebarTrigger,
29} from "./ui/sidebar";
30import { StatusDot, useSiteStatus } from "./footer";
31import { Logo } from "./logo";
32import { SoonPill } from "./ui";
33import { Avatar } from "./ui/avatar";
34import { Skeleton } from "./ui/skeleton";
35import { Button } from "./ui/button";
36import { Separator } from "./ui/separator";
37import { Breadcrumb, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from "./ui/breadcrumb";
38import {
39 DropdownMenu,
40 DropdownMenuContent,
41 DropdownMenuGroup,
42 DropdownMenuItem,
43 DropdownMenuLabel,
44 DropdownMenuSeparator,
45 DropdownMenuTrigger,
46} from "./ui/dropdown-menu";
47import { type RoadmapItem, roadmapIn, roadmapItem } from "../lib/roadmap";
48import { type ModeKey, WORKSPACE_SETTINGS_GROUPS, type WorkspaceSettingsPage, homePagePath, modeOf, workspaceSettingsPage } from "../lib/workspace-nav";
49import { ChatSidebar } from "./chat/sidebar";
50import { FoliosSidebar } from "./folios/sidebar";
51import { Rail, ShortcutsDialog, WorkspaceSwitcher, sidebarKeyLabel } from "./rail";
52import { BottomBar, isConversation, useVisualViewport } from "./mobile";
53import { useChatSidebar } from "./chat/actions";
54import { unreadTotals } from "../lib/chat";
55import { SETTINGS_CAPABILITY, type ViewerAccess, seesSettings } from "../lib/access";
56import { projectPages } from "../lib/chrome";
57import { ACCOUNT_SETTINGS, type AccountSettingsPage, FIRST_SETTINGS_PAGE, accountSettingsPage } from "../lib/account-settings";
58import { type PinnableApp, sidebarCookie } from "../lib/apps";
59import { REASON_FILTERS, inboxReason, inboxView } from "../lib/inbox";
60import { GithubMark } from "./github";
61import { useInviteOnly } from "../lib/registration";
62import { STATUS_URL, statusTitle } from "../lib/status";
63import { type ShortcutProject, movedPin, recentWith } from "../lib/pins";
64import type { AccountMenuData } from "../routes/settings-menu-json";
65import { useLiveBadges } from "../lib/notify-client";
66import { OwnPresenceDot, OwnPresenceItems, StatusDialog } from "./presence";
67import { THEME_COMMANDS, ThemeMenuSwitch } from "./theme-switch";
68
69/**
70 * What the sidebar needs, worked out by the root loader. For a visitor who
71 * is not signed in there is no workspace, no projects and no usage: only
72 * the project being looked at, if they can see it.
73 */
74export type ShellData = {
75 /** The workspace the sidebar is about: the one being looked at, or their first. */
76 workspace: Membership | null;
77 /** All its projects, by name, for the palette: `name` is the slug in their address. */
78 repos: ShortcutProject[];
79 /** The person's pinned projects in it, in their order (lib/pins.ts). */
80 pinned?: ShortcutProject[];
81 /** What they opened there last, latest first, leaving out the pinned. */
82 recent?: ShortcutProject[];
83 /** Repositories shared with them in workspaces they do not belong to. */
84 shared?: { namespace: string; name: string; isPrivate: boolean }[];
85 /** The project being looked at, if any, whoever owns it. */
86 repo: {
87 namespace: string;
88 name: string;
89 member: boolean;
90 issues: number;
91 pulls: number;
92 } | null;
93 /** Where the workspace stands against its usage limit, if billing is on. */
94 limit: {
95 exposureMicros: number;
96 ceilingMicros: number | null;
97 state: "ok" | "warning" | "stopped";
98 comped: boolean;
99 } | null;
100 /** Whether g1t charges nothing for now, while it is being built out. */
101 free?: boolean;
102 /** This month's usage: charged, or at cost while g1t is free. */
103 monthUsageMicros: number | null;
104 /** Whether new compute is paused (a spend spike or a hold), and whether the viewer can answer it. */
105 compute?: { paused: string | null; spike: Spike | null; owner: boolean } | null;
106 /** What is unread in their notifications, for the rail and the bell. Absent for a visitor. */
107 inbox?: InboxCounts | null;
108 /**
109 * Chat, for the rail's badge: what is unread, and the
110 * starred and latest conversations. Null when chat did not answer in time.
111 */
112 chat?: { unread: number; mentions: number; starred?: ChatSidebarEntry[]; recent?: ChatSidebarEntry[] } | null;
113 /** The apps this person pinned to their rail in the workspace (lib/apps.ts). */
114 pins?: PinnableApp[];
115};
116
117/** Whether `pathname` is `to` or a page under it (`end`: only `to` itself), the query left aside. */
118function under(pathname: string, to: string, end = false): boolean {
119 const path = to.split("?")[0]!;
120 return pathname === path || (!end && pathname.startsWith(path.endsWith("/") ? path : `${path}/`));
121}
122
123/**
124 * Where a row is current and where it is on its way to. A row's page is
125 * current under its own address and any `also` prefix, unless the list
126 * says itself (`current`). Rows that differ by query alone (Notifications'
127 * views and reasons) are pending only when the page on its way is that
128 * row's, query and all.
129 */
130function useRowState(to: string, { end, also, current: lit }: { end?: boolean; also?: string | string[]; current?: boolean }) {
131 const { pathname } = useLocation();
132 const going = useNavigation().location;
133 const current = lit ?? (under(pathname, to, end) || [also ?? []].flat().some((prefix) => under(pathname, prefix)));
134 const pending =
135 going != null && !current && (lit === undefined ? under(going.pathname, to, end) : `${going.pathname}${going.search}` === to);
136 return { current, pending };
137}
138
139/**
140 * One row of a mode's sidebar: an icon, its words, how many it lists
141 * (`count`) and, for a row that opens a list of its own (`drill`), a
142 * chevron, always or on hover.
143 */
144function SidebarLink({
145 to,
146 icon,
147 end,
148 count,
149 also,
150 drill,
151 current: lit,
152 action,
153 bare = false,
154 children,
155}: {
156 to: string;
157 icon: ReactNode;
158 end?: boolean;
159 count?: number;
160 /** Other path prefixes under which this link is the current one. */
161 also?: string | string[];
162 /** It opens a list of its own: a chevron says so, always or on hover. */
163 drill?: boolean | "hover";
164 /** Whether it is the current row, when the list works that out itself. */
165 current?: boolean;
166 /** A small button at the row's end, beside the words (a pin). */
167 action?: ReactNode;
168 /** The row alone, for a list item that is drawn by the list (a pinned project, which drags). */
169 bare?: boolean;
170 children: ReactNode;
171}) {
172 const { current, pending } = useRowState(to, { end, also, current: lit });
173 const Item = bare ? Fragment : SidebarMenuItem;
174 return (
175 <Item>
176 <SidebarMenuButton asChild isActive={current} isPending={pending} className={action ? "pr-7" : undefined}>
177 <Link to={to} prefetch="intent" aria-current={current ? "page" : undefined}>
178 {icon}
179 <span className="min-w-0 grow truncate">{children}</span>
180 {count != null && count > 0 && <SidebarMenuBadge>{count}</SidebarMenuBadge>}
181 {drill && (
182 <ChevronRight
183 aria-hidden="true"
184 className={`-mr-0.5 size-3.5! shrink-0 text-faint transition-opacity ${drill === "hover" ? "opacity-0 group-hover/menu-button:opacity-100 group-focus-visible/menu-button:opacity-100" : ""}`}
185 />
186 )}
187 </Link>
188 </SidebarMenuButton>
189 {action}
190 </Item>
191 );
192}
193
194/**
195 * Something a project will have, shown where it will live so people can
196 * see where g1t is going. Not a link: nothing is behind it yet.
197 */
198function SidebarSoon({ icon, children, about }: { icon: ReactNode; children: ReactNode; about: string }) {
199 return (
200 <SidebarMenuItem>
201 <Hint label={about} side="right">
202 <SidebarMenuButton asChild variant="faint">
203 <div aria-disabled="true" className="cursor-default">
204 {icon}
205 <span className="min-w-0 grow truncate">{children}</span>
206 <span className="sr-only">{about}</span>
207 <SoonPill />
208 </div>
209 </SidebarMenuButton>
210 </Hint>
211 </SidebarMenuItem>
212 );
213}
214
215/**
216 * A page that is coming, as a link to its roadmap page: faint, with Soon,
217 * and marked current on any of its section's Soon pages.
218 */
219function SidebarSoonLink({
220 to,
221 also,
222 icon,
223 about,
224 current: lit,
225 children,
226}: {
227 to: string;
228 also?: string[];
229 icon: ReactNode;
230 about: string;
231 /** Whether it is the current row, when the list works that out itself. */
232 current?: boolean;
233 children: ReactNode;
234}) {
235 const { current, pending } = useRowState(to, { also, current: lit });
236 return (
237 <SidebarMenuItem>
238 <Hint label={about} side="right">
239 <SidebarMenuButton asChild variant="faint" isActive={current} isPending={pending}>
240 <Link to={to} prefetch="intent" aria-current={current ? "page" : undefined}>
241 {icon}
242 <span className="min-w-0 grow truncate">{children}</span>
243 <SoonPill />
244 </Link>
245 </SidebarMenuButton>
246 </Hint>
247 </SidebarMenuItem>
248 );
249}
250
251/** The Soon pages of a section, as paths, so its link is current on them. */
252function soonPaths(base: string, section: RoadmapItem["section"]): string[] {
253 return roadmapIn(section).map((item) => `${base}/soon/${item.key}`);
254}
255
256/** A titled group of rows: its name in small capitals, what it makes at the end, and its menu. */
257function NavGroup({
258 title,
259 action,
260 className,
261 children,
262}: {
263 title: string;
264 /** A small button at the label's end, in its row: what the group makes (a `SidebarGroupAction` with `relative top-auto right-auto`). */
265 action?: ReactNode;
266 className?: string;
267 children: ReactNode;
268}) {
269 return (
270 <SidebarGroup className={className}>
271 <div className="flex items-center justify-between gap-2 pr-1">
272 <SidebarGroupLabel asChild>
273 <h2>{title}</h2>
274 </SidebarGroupLabel>
275 {action}
276 </div>
277 <SidebarGroupContent>
278 <SidebarMenu>{children}</SidebarMenu>
279 </SidebarGroupContent>
280 </SidebarGroup>
281 );
282}
283
284/** Rows with no name over them: the first of a list, or a run between rules. */
285function NavRows({ className, children }: { className?: string; children: ReactNode }) {
286 return (
287 <SidebarGroup className={className}>
288 <SidebarGroupContent>
289 <SidebarMenu>{children}</SidebarMenu>
290 </SidebarGroupContent>
291 </SidebarGroup>
292 );
293}
294
295/** What a workspace is called where people read it: its display name, else its slug. */
296function displayName(membership: Membership): string {
297 return membership.name?.trim() || membership.slug;
298}
299
300/**
301 * The fine print, as one quiet row at the foot of the account menu and the
302 * visitor's panel: each link a full-height target, left-aligned. In the
303 * menu each is a menu item, so the arrow keys reach it.
304 */
305const LEGAL_LINKS: [string, string][] = [
306 ["Policies", "/policies"],
307 ["Privacy", "/policies/privacy"],
308 ["Security", "/security"],
309];
310const LEGAL_LINK = "flex h-7 items-center rounded px-1.5 text-xs text-faint outline-none transition-colors";
311
312function MenuLegalRow() {
313 return (
314 <div role="group" aria-label="Legal" className="flex items-center gap-0.5 px-0.5 pt-0.5">
315 {LEGAL_LINKS.map(([label, to], index) => (
316 <span key={to} className="flex items-center gap-0.5">
317 {index > 0 && (
318 <span aria-hidden="true" className="text-[0.625rem] text-line-strong">
319 ·
320 </span>
321 )}
322 <DropdownMenuItem asChild className={`${LEGAL_LINK} py-0 data-highlighted:bg-line data-highlighted:text-fg`}>
323 <Link to={to}>{label}</Link>
324 </DropdownMenuItem>
325 </span>
326 ))}
327 </div>
328 );
329}
330
331/** Status's row: the live dot and two or three words, fetched when the menu opens. */
332function StatusSummary({ open }: { open: boolean }) {
333 const status = useSiteStatus(open);
334 const words = statusTitle(status);
335 return (
336 <span className="ml-auto flex min-w-0 items-center gap-1.5 pl-2 text-xs text-faint">
337 {/* The words say it; the dot's own words for screen readers would repeat them. */}
338 <span aria-hidden="true" className="flex">
339 <StatusDot state={status?.overall.state ?? null} />
340 </span>
341 {words ? <span className="truncate">{words}</span> : <Skeleton className="h-3 w-20" />}
342 </span>
343 );
344}
345
346/** A menu row: an icon, words, and whatever sits at its end. */
347const MENU_ROW = "h-9 gap-2.5 px-2.5 text-[0.8125rem]";
348
349/**
350 * Your account, at the foot of the rail (or in the header, before you have
351 * a workspace): who you are and your status, your profile and settings,
352 * and help: the documentation, support, status and the keyboard's
353 * shortcuts; then signing out and the fine print.
354 */
355function AccountMenu({ user, side = "right" }: { user: User; side?: "right" | "bottom" }) {
356 const submit = useSubmit();
357 const [open, setOpen] = useState(false);
358 const [keys, setKeys] = useState(false);
359 // Inside the desktop app there is nothing to get.
360 const inApp = useDesktopApp();
361 // Your status's dialog: outside the menu, so the menu closes behind it.
362 const [editing, setEditing] = useState(false);
363 // Name, primary address and invites left: asked for once, as soon as the
364 // pointer or focus reaches the button, so they are there when it opens.
365 const details = useFetcher<AccountMenuData | null>({ key: "account-menu" });
366 const prefetch = () => {
367 if (details.state === "idle" && details.data === undefined) details.load("/settings/menu.json");
368 };
369 useEffect(() => {
370 if (open) prefetch();
371 // eslint-disable-next-line react-hooks/exhaustive-deps
372 }, [open]);
373 const me = details.data ?? null;
374 // Still on its way: shapes where the words will be, the same size.
375 const loading = details.data === undefined && details.state !== "idle";
376 // While anyone can sign up, listed once the data says there are invites to look back on.
377 const invitesListed = useInviteOnly() || me?.invites_page === true;
378 const profile = `/u/${user.username}`;
379 return (
380 <>
381 <DropdownMenu open={open} onOpenChange={setOpen}>
382 {/* The avatar alone, with a dot that says how others see you (components/presence.tsx). */}
383 <Hint label={side === "right" ? "Your account" : undefined} side="right">
384 <DropdownMenuTrigger
385 aria-label={`Account menu for ${shownUsername(user)}`}
386 onPointerEnter={prefetch}
387 onFocus={prefetch}
388 className={
389 side === "right"
390 ? // At the foot of the rail: a 40px rounded square, as the rail's icons are.
391 "relative flex size-10 items-center justify-center rounded-[10px] outline-none transition-colors hover:bg-sidebar-accent focus-visible:ring-2 focus-visible:ring-accent data-[state=open]:bg-sidebar-accent"
392 : "relative flex rounded-full outline-none transition-transform hover:scale-[1.04] focus-visible:ring-2 focus-visible:ring-accent data-[state=open]:ring-2 data-[state=open]:ring-line-strong"
393 }
394 >
395 <Avatar name={user.username} image={user.avatar} size={side === "right" ? 40 : 28} square={side === "right"} />
396 <OwnPresenceDot ring={side === "right" ? "var(--color-rail)" : "var(--color-bg)"} className={side === "right" ? "absolute -right-1 -bottom-1" : "absolute -right-0.5 -bottom-0.5"} />
397 </DropdownMenuTrigger>
398 </Hint>
399 <DropdownMenuContent align="end" side={side} sideOffset={side === "right" ? 14 : 6} collisionPadding={8} className="w-70 p-1.5">
400 {/* Who is signed in, and a way to their profile. */}
401 <DropdownMenuItem asChild className="gap-3 px-2 py-2">
402 <Link to={profile} aria-label={`${me?.name ?? shownUsername(user)} (@${shownUsername(user)}), your profile`}>
403 <Avatar name={user.username} image={user.avatar} size={36} />
404 <span className="flex min-w-0 grow flex-col leading-tight" aria-busy={loading}>
405 {loading ? (
406 <Skeleton className="my-0.75 h-3.5 w-28" />
407 ) : (
408 <span className="truncate text-sm font-medium text-fg">{me?.name ?? shownUsername(user)}</span>
409 )}
410 <span className="truncate font-mono text-xs text-muted">@{shownUsername(user)}</span>
411 {loading ? (
412 <Skeleton className="mt-1 h-3 w-40" />
413 ) : (
414 me?.email && <span className="mt-0.5 truncate text-xs text-faint">{me.email}</span>
415 )}
416 </span>
417 </Link>
418 </DropdownMenuItem>
419 <DropdownMenuSeparator className="my-1.5" />
420 {/* Your status, away, and pausing notifications. */}
421 <DropdownMenuGroup>
422 <OwnPresenceItems className="min-h-9 py-1.5 text-[0.8125rem]" onEdit={() => setEditing(true)} />
423 </DropdownMenuGroup>
424 <DropdownMenuSeparator className="my-1.5" />
425 <DropdownMenuGroup>
426 <DropdownMenuItem asChild className={MENU_ROW}>
427 <Link to={profile}>
428 <CircleUserRound />
429 Your profile
430 </Link>
431 </DropdownMenuItem>
432 <DropdownMenuItem asChild className={MENU_ROW}>
433 <Link to={FIRST_SETTINGS_PAGE}>
434 <Settings />
435 Your settings
436 </Link>
437 </DropdownMenuItem>
438 {/* The app's own: starting with the computer, closing to the tray, the badge (apps/desktop). */}
439 {inApp && desktopBridge()?.openSettings && (
440 <DropdownMenuItem className={MENU_ROW} onSelect={() => desktopBridge()?.openSettings?.()}>
441 <MonitorCog />
442 Desktop app settings
443 </DropdownMenuItem>
444 )}
445 {invitesListed && (
446 <DropdownMenuItem asChild className={MENU_ROW}>
447 <Link to="/settings/invites">
448 <Ticket />
449 {ACCOUNT_SETTINGS.invites.title}
450 {loading && <Skeleton className="ml-auto h-4 w-12 rounded-full" />}
451 {me?.invites_left != null && (
452 <span className="ml-auto rounded-full bg-line px-1.5 text-[0.6875rem] tabular-nums text-muted">
453 {me.invites_left} left
454 </span>
455 )}
456 </Link>
457 </DropdownMenuItem>
458 )}
459 </DropdownMenuGroup>
460 <DropdownMenuSeparator className="my-1.5" />
461 {/* Auto, Light or Dark, switched in place (lib/theme.ts). */}
462 <ThemeMenuSwitch />
463 <DropdownMenuSeparator className="my-1.5" />
464 <DropdownMenuGroup>
465 <DropdownMenuItem asChild className={MENU_ROW}>
466 <a href="https://docs.g1t.sh/">
467 <BookOpen />
468 Documentation
469 </a>
470 </DropdownMenuItem>
471 <DropdownMenuItem asChild className={MENU_ROW}>
472 <Link to="/support">
473 <LifeBuoy />
474 Support
475 </Link>
476 </DropdownMenuItem>
477 <DropdownMenuItem asChild className={MENU_ROW}>
478 <a href={STATUS_URL}>
479 <Activity />
480 Status
481 <StatusSummary open={open} />
482 </a>
483 </DropdownMenuItem>
484 <DropdownMenuItem className={MENU_ROW} onSelect={() => setKeys(true)}>
485 <Keyboard />
486 Keyboard shortcuts
487 <PaletteKey className="ml-auto font-sans text-xs text-faint" />
488 </DropdownMenuItem>
489 {!inApp && (
490 <DropdownMenuItem asChild className={MENU_ROW}>
491 <Link to="/download">
492 <MonitorDown />
493 Get the desktop app
494 </Link>
495 </DropdownMenuItem>
496 )}
497 </DropdownMenuGroup>
498 <DropdownMenuSeparator className="my-1.5" />
499 {/* Submitted from here: the menu closes on select, and a button
500 that has left the page cannot submit a form. */}
501 <DropdownMenuItem className={MENU_ROW} onSelect={() => submit(null, { method: "post", action: "/logout" })}>
502 <LogOut />
503 Sign out
504 </DropdownMenuItem>
505 <DropdownMenuSeparator className="my-1.5" />
506 <MenuLegalRow />
507 </DropdownMenuContent>
508 </DropdownMenu>
509 <StatusDialog open={editing} onOpenChange={setEditing} />
510 <ShortcutsDialog open={keys} onOpenChange={setKeys} />
511 </>
512 );
513}
514
515/** A project's settings pages, which the project's menu drills into. */
516const REPO_SETTINGS_PAGE = /^\/([^/]+)\/([^/-][^/]*)\/settings(\/|$)/;
517
518/**
519 * The sidebar's lists are a stack, the way a phone pushes a screen: one
520 * drilled into slides in from the right over the full width, while the one
521 * it covers drifts a quarter of the way left and fades, both on one long
522 * ease-out, the fade quicker than the move so the two never blur together.
523 * Going back reverses it.
524 */
525const LAYER =
526 "absolute inset-0 [transition:translate_380ms_cubic-bezier(0.32,0.72,0,1),opacity_220ms_ease-out] will-change-[translate,opacity] motion-reduce:transition-none";
527/** One list, filling its layer. */
528const PANEL = "h-full overflow-y-auto px-1 pt-1 pb-4 [scrollbar-width:thin]";
529
530/** One list in the stack: what it is, and its rows. */
531type Level = { key: string; node: ReactNode };
532
533/** True once the page has hydrated, so what the server drew never animates in. */
534function useHydrated(): boolean {
535 const [hydrated, setHydrated] = useState(false);
536 useEffect(() => setHydrated(true), []);
537 return hydrated;
538}
539
540/**
541 * Drilling in and out of the sidebar's lists. `trail` is the way from the
542 * main list to the one shown, worked out from the address, so a link
543 * straight to a settings page opens the sidebar already drilled in, and
544 * leaving it comes back out. Lists deeper than the one shown stay in
545 * place, off to the right, so going back slides them away rather than
546 * dropping them. Moving to a list at the same depth (a workspace's settings
547 * to a project) fades the new one in where it is.
548 */
549function Drill({ trail }: { trail: Level[] }) {
550 const depth = trail.length - 1;
551 const hydrated = useHydrated();
552 const stack = useRef<Level[]>(trail);
553 const before = stack.current;
554 const within = trail.every((level, index) => before[index]?.key === level.key);
555 stack.current = within ? [...trail, ...before.slice(trail.length)] : trail;
556 const levels = stack.current;
557 // What was showing last time, to tell drilling in from moving across.
558 const shown = useRef({ depth, keys: levels.map((level) => level.key) });
559 useEffect(() => {
560 shown.current = { depth, keys: levels.map((level) => level.key) };
561 });
562 return (
563 <div className="relative min-h-0 grow overflow-hidden">
564 {levels.map((level, index) => {
565 const current = index === depth;
566 const place =
567 index < depth
568 ? "pointer-events-none -translate-x-1/4 opacity-0"
569 : current
570 ? "translate-x-0 opacity-100"
571 : "pointer-events-none translate-x-full opacity-0";
572 // A list that was not there before arrives: from the right when
573 // drilling in, in place when moving across.
574 const arriving = hydrated && current && !shown.current.keys.includes(level.key);
575 const enter = arriving
576 ? depth > shown.current.depth
577 ? "starting:translate-x-full starting:opacity-0"
578 : "starting:opacity-0"
579 : "";
580 return (
581 <div key={level.key} className={`${LAYER} ${place} ${enter}`} inert={!current} aria-hidden={!current || undefined}>
582 {level.node}
583 </div>
584 );
585 })}
586 </div>
587 );
588}
589
590/**
591 * The row at the top of a list drilled into: the list's name, which goes
592 * back out, and what it belongs to, faint at the end.
593 */
594function BackRow({ to, label, context }: { to: string; label: ReactNode; context?: ReactNode }) {
595 return (
596 <NavRows className="mt-1">
597 <SidebarMenuItem>
598 <SidebarMenuButton asChild className="gap-1.5 pl-1 font-medium text-fg">
599 <Link to={to} prefetch="intent">
600 <ChevronLeft className="text-faint transition-transform group-hover/menu-button:-translate-x-0.5 group-hover/menu-button:text-muted" />
601 <span className="min-w-0 shrink-0 truncate">{label}</span>
602 {context && <span className="ml-auto min-w-0 truncate pl-2 font-mono text-[0.6875rem] font-normal text-faint">{context}</span>}
603 </Link>
604 </SidebarMenuButton>
605 </SidebarMenuItem>
606 </NavRows>
607 );
608}
609
610/** A thin rule between groups of a list. */
611function Rule() {
612 return <SidebarSeparator className="my-1.5" />;
613}
614
615/** A quiet heading inside a group: Pinned, Recent. */
616function SidebarSubhead({ children }: { children: ReactNode }) {
617 return (
618 <SidebarGroupLabel asChild className="h-6 pt-0.5">
619 <h3>{children}</h3>
620 </SidebarGroupLabel>
621 );
622}
623
624/**
625 * The workspace's projects as the sidebar keeps them, however many there
626 * are: the person's pins in their order, what they opened last, and the
627 * way to all of them. Pins move by dragging, or with Alt and the arrow
628 * keys; the projects service keeps the order.
629 */
630function SidebarProjects({ slug, shell, current }: { slug: string; shell: ShellData; current: boolean }) {
631 const reorder = useFetcher({ key: `pins:${slug}` });
632 const saved = shell.pinned ?? [];
633 // While a new order is on its way, it shows as made.
634 const asked = reorder.formData?.get("intent") === "reorder" ? reorder.formData.getAll("slug").map(String) : null;
635 const pinned = asked
636 ? asked.map((name) => saved.find((project) => project.name === name)).filter((project): project is ShortcutProject => project != null)
637 : saved;
638 const active = shell.repo ? { namespace: shell.repo.namespace, name: shell.repo.name, isPrivate: false } : null;
639 const recent = recentWith(shell.recent ?? [], pinned, active, slug);
640 const [dragging, setDragging] = useState<number | null>(null);
641 const move = (from: number, by: number) => {
642 const next = movedPin(pinned, from, by);
643 if (!next) return;
644 const form = new FormData();
645 form.set("intent", "reorder");
646 for (const project of next) form.append("slug", project.name);
647 reorder.submit(form, { method: "post", action: `/${slug}/-/pins` });
648 };
649 // Each row pins or unpins in place: the pin shows on hover or focus, and
650 // stays shown on a pinned row's hover so it reads as "unpin".
651 const row = (project: ShortcutProject, isPinned: boolean) => (
652 <SidebarLink
653 to={`/${project.namespace}/${project.name}`}
654 icon={project.isPrivate ? <Lock /> : <Box />}
655 bare={isPinned}
656 action={
657 // At the row's end, where the row's other actions sit, and only on
658 // hover or keyboard focus: a pin clicked keeps the mouse's focus,
659 // and showing it on any focus left it lit on a row no one was over.
660 <PinButton
661 workspace={slug}
662 slug={project.name}
663 name={project.title ?? project.name}
664 pinned={isPinned}
665 small
666 className="absolute top-1/2 right-1 -translate-y-1/2 opacity-0 transition-opacity group-hover/menu-item:opacity-100 has-focus-visible:opacity-100 [@media(hover:none)]:opacity-100"
667 />
668 }
669 >
670 {project.title ?? project.name}
671 </SidebarLink>
672 );
673 return (
674 <SidebarGroup>
675 {/* The label and its button share a row, so the button stays level with the words at any text size. */}
676 <div className="flex items-center justify-between gap-2 pr-1">
677 <SidebarGroupLabel asChild>
678 <h2>Projects</h2>
679 </SidebarGroupLabel>
680 <Hint label="New project">
681 <SidebarGroupAction asChild className="relative top-auto right-auto">
682 <Link to="/new" aria-label="New project">
683 <Plus />
684 </Link>
685 </SidebarGroupAction>
686 </Hint>
687 </div>
688 <SidebarGroupContent>
689 {/* Only there once something is pinned: each row below has its own pin. */}
690 {pinned.length > 0 && (
691 <>
692 <SidebarSubhead>Pinned</SidebarSubhead>
693 <SidebarMenu aria-label="Pinned projects">
694 {pinned.map((project, index) => (
695 <SidebarMenuItem
696 key={project.name}
697 draggable={pinned.length > 1}
698 onDragStart={(event) => {
699 setDragging(index);
700 event.dataTransfer.effectAllowed = "move";
701 }}
702 onDragOver={(event) => {
703 if (dragging != null) event.preventDefault();
704 }}
705 onDrop={(event) => {
706 event.preventDefault();
707 if (dragging != null && dragging !== index) move(dragging, index - dragging);
708 setDragging(null);
709 }}
710 onDragEnd={() => setDragging(null)}
711 onKeyDown={(event) => {
712 if (!event.altKey || (event.key !== "ArrowUp" && event.key !== "ArrowDown")) return;
713 event.preventDefault();
714 move(index, event.key === "ArrowUp" ? -1 : 1);
715 }}
716 className={`group/pin ${dragging === index ? "opacity-50" : ""}`}
717 >
718 {row(project, true)}
719 {pinned.length > 1 && (
720 <Hint label="Drag, or Alt and an arrow key, to reorder" side="right">
721 <span className="absolute top-1/2 -left-2 -translate-y-1/2 cursor-grab text-faint opacity-0 transition-opacity group-hover/pin:opacity-100">
722 <GripVertical size={12} aria-hidden="true" />
723 </span>
724 </Hint>
725 )}
726 </SidebarMenuItem>
727 ))}
728 </SidebarMenu>
729 </>
730 )}
731 {recent.length > 0 && (
732 <>
733 <SidebarSubhead>Recent</SidebarSubhead>
734 <SidebarMenu aria-label="Recent projects">
735 {recent.map((project) => (
736 <Fragment key={`${project.namespace}/${project.name}`}>{row(project, false)}</Fragment>
737 ))}
738 </SidebarMenu>
739 </>
740 )}
741 <SidebarMenu className="pt-1">
742 <SidebarLink to={`/${slug}/-/projects`} icon={<LayoutGrid />} count={shell.repos.length} current={current}>
743 All projects
744 </SidebarLink>
745 </SidebarMenu>
746 </SidebarGroupContent>
747 </SidebarGroup>
748 );
749}
750
751/** Insights, coming: the workspace's own page says what it will be. */
752const INSIGHTS = roadmapItem("insights");
753
754/**
755 * What the repository menu needs. Known from the address before the page's
756 * data arrives, so the menu is right from the first frame; the counts fill
757 * in once it does.
758 */
759type MenuRepo = {
760 namespace: string;
761 name: string;
762 member: boolean;
763 /** Whether they see its settings; from the repository's page once it loads. */
764 settings?: boolean;
765 /** What they may do there, once the repository's page loads. */
766 can?: Abilities;
767 /** The remote it mirrors, once the repository's page loads: a mirror lists only what it offers. */
768 mirror?: RepoMirror | null;
769 issues?: number;
770 pulls?: number;
771};
772
773function sameRepo(a: { namespace: string; name: string } | null, b: { namespace: string; name: string } | null) {
774 return (
775 a != null &&
776 b != null &&
777 a.namespace.toLowerCase() === b.namespace.toLowerCase() &&
778 a.name.toLowerCase() === b.name.toLowerCase()
779 );
780}
781
782/**
783 * A project's own list, drilled into while you are in it: everything about
784 * the project, running and its code, and nothing else, with the way back
785 * out to all of them.
786 */
787function RepoMenu({
788 repo,
789 isPrivate,
790 back,
791}: {
792 repo: MenuRepo;
793 isPrivate: boolean;
794 /** Where the way back leads: the workspace's projects, mission control, or Explore. */
795 back: { to: string; label: string };
796}) {
797 const base = `/${repo.namespace}/${repo.name}`;
798 // What a member sees, what everyone who can see the project does, and
799 // what a mirror offers now (lib/chrome.ts).
800 const shows = new Set(projectPages(repo.member, repo.can, repo.mirror));
801 const { current: atOverview, pending: toOverview } = useRowState(base, { end: true });
802 return (
803 <nav aria-label={`${repo.namespace}/${repo.name}`} className={PANEL}>
804 <BackRow to={back.to} label={back.label} />
805 <NavRows className="mt-1">
806 <SidebarMenuItem>
807 <Hint label="Overview" side="right">
808 <SidebarMenuButton asChild size="lg" isActive={atOverview} isPending={toOverview} className="gap-2 font-normal">
809 <Link to={base} prefetch="intent" aria-current={atOverview ? "page" : undefined}>
810 <span className="flex size-6 shrink-0 items-center justify-center rounded-md bg-raised text-muted ring-1 ring-line [&>svg]:size-3.5">
811 {isPrivate ? <Lock /> : <Box />}
812 </span>
813 <span className="min-w-0 truncate font-mono text-[0.8125rem]">
814 <span className="text-faint">{repo.namespace}/</span>
815 <span className="font-semibold text-fg">{repo.name}</span>
816 </span>
817 </Link>
818 </SidebarMenuButton>
819 </Hint>
820 </SidebarMenuItem>
821 </NavRows>
822 {/* A project's pages, in the order people use them. A page with more
823 than one view shows them as tabs across its top. */}
824 <Rule />
825 <NavRows>
826 <SidebarLink to={`${base}/code`} also={[`${base}/tree`, `${base}/blob`, `${base}/commits`, `${base}/commit`, `${base}/branches`, `${base}/tags`, `${base}/compare`, ...soonPaths(base, "Code")]} icon={<Code2 size={15} />}>
827 Code
828 </SidebarLink>
829 {/* A mirror that is not taken over lists none of these: its work happens on the remote. */}
830 {shows.has("issues") && (
831 <SidebarLink to={`${base}/issues`} also={[`${base}/milestones`, `${base}/labels`, ...soonPaths(base, "Issues")]} icon={<CircleDot size={15} />} count={repo.issues}>
832 Issues
833 </SidebarLink>
834 )}
835 {shows.has("pulls") && (
836 <SidebarLink to={`${base}/pulls`} also={[`${base}/pull`, `${base}/queue`, `${base}/sessions`]} icon={<GitPullRequest size={15} />} count={repo.pulls}>
837 Pull requests
838 </SidebarLink>
839 )}
840 {repo.member && (
841 <SidebarLink to={`${base}/memory`} icon={<Brain size={15} />}>
842 Memory
843 </SidebarLink>
844 )}
845 {shows.has("actions") && (
846 <SidebarLink to={`${base}/actions`} icon={<PlayCircle size={15} />}>
847 Workflows
848 </SidebarLink>
849 )}
850 </NavRows>
851 <Rule />
852 <NavRows>
853 {shows.has("deployments") ? (
854 <SidebarLink to={`${base}/deployments`} also={soonPaths(base, "Deployments")} icon={<Rocket size={15} />}>
855 Deployments
856 </SidebarLink>
857 ) : null}
858 {shows.has("observability") && (
859 <SidebarLink to={`${base}/observability`} also={soonPaths(base, "Observability")} icon={<Activity size={15} />}>
860 Observability
861 </SidebarLink>
862 )}
863 {shows.has("security") ? (
864 <SidebarLink to={`${base}/security`} also={soonPaths(base, "Security")} icon={<ShieldCheck size={15} />}>
865 Security
866 </SidebarLink>
867 ) : null}
868 <SidebarLink
869 to={`${base}/contributors`}
870 also={[`${base}/activity`, `${base}/stargazers`, ...soonPaths(base, "Insights")]}
871 icon={<BarChart3 size={15} />}
872 >
873 Insights
874 </SidebarLink>
875 </NavRows>
876 {(repo.settings ?? shows.has("settings")) && (
877 <>
878 <Rule />
879 <NavRows>
880 <SidebarLink to={`${base}/settings`} icon={<Settings size={15} />} drill>
881 Settings
882 </SidebarLink>
883 </NavRows>
884 </>
885 )}
886 </nav>
887 );
888}
889
890/**
891 * A project's settings, drilled into from its list: what is about running
892 * it, then its sandboxes, then its code and who can reach it. The way back
893 * leads to the project.
894 */
895function RepoSettingsMenu({ repo }: { repo: MenuRepo }) {
896 const base = `/${repo.namespace}/${repo.name}`;
897 // Each page shows to the roles that can use it, once the role is known.
898 const shows = (page: string) => !repo.can || repo.can[SETTINGS_CAPABILITY[page] ?? "administer"];
899 const running = shows("deployments");
900 const guarded = shows("guardrails");
901 return (
902 <nav aria-label={`${repo.namespace}/${repo.name} settings`} className={PANEL}>
903 <BackRow to={base} label="Settings" context={`${repo.namespace}/${repo.name}`} />
904 {shows("") && (
905 <NavRows className="mt-2">
906 <SidebarLink to={`${base}/settings`} end icon={<Settings size={15} />}>
907 General
908 </SidebarLink>
909 </NavRows>
910 )}
911 {running && (
912 <>
913 {shows("") && <Rule />}
914 <NavRows className={shows("") ? undefined : "mt-2"}>
915 <SidebarLink to={`${base}/settings/deployments`} icon={<Rocket size={15} />}>
916 Deployments
917 </SidebarLink>
918 <SidebarLink to={`${base}/settings/domains`} icon={<Globe size={15} />}>
919 Domains
920 </SidebarLink>
921 </NavRows>
922 </>
923 )}
924 {guarded && (
925 <>
926 <Rule />
927 <NavRows>
928 {shows("guardrails") && (
929 <SidebarLink to={`${base}/settings/guardrails`} icon={<ShieldCheck size={15} />}>
930 Guardrails
931 </SidebarLink>
932 )}
933 </NavRows>
934 </>
935 )}
936 <Rule />
937 <NavRows>
938 {shows("repository") && (
939 <SidebarLink to={`${base}/settings/repository`} icon={<BookMarked size={15} />}>
940 Repository
941 </SidebarLink>
942 )}
943 {shows("mirroring") && (
944 <SidebarLink to={`${base}/settings/mirroring`} icon={<ArrowLeftRight size={15} />}>
945 Mirroring
946 </SidebarLink>
947 )}
948 {shows("access") && (
949 <SidebarLink to={`${base}/settings/access`} icon={<Users size={15} />}>
950 Access
951 </SidebarLink>
952 )}
953 {shows("keys") && (
954 <SidebarLink to={`${base}/settings/keys`} icon={<KeyRound size={15} />}>
955 Deploy keys
956 </SidebarLink>
957 )}
958 {shows("branches") && (
959 <SidebarLink to={`${base}/settings/branches`} icon={<GitBranch size={15} />}>
960 Branches and merging
961 </SidebarLink>
962 )}
963 {shows("rules") && (
964 <SidebarLink to={`${base}/settings/rules`} icon={<Scale size={15} />}>
965 Rules
966 </SidebarLink>
967 )}
968 {shows("secrets") && (
969 <SidebarLink to={`${base}/settings/secrets`} icon={<Lock size={15} />}>
970 Secrets and variables
971 </SidebarLink>
972 )}
973 {shows("actions") && (
974 <SidebarLink to={`${base}/settings/actions`} icon={<PlayCircle size={15} />}>
975 Actions
976 </SidebarLink>
977 )}
978 {shows("environments") && (
979 <SidebarLink to={`${base}/settings/environments`} icon={<Layers size={15} />}>
980 Environments
981 </SidebarLink>
982 )}
983 {shows("runners") && (
984 <SidebarLink to={`${base}/settings/runners`} icon={<ServerCog size={15} />}>
985 Runners
986 </SidebarLink>
987 )}
988 {shows("webhooks") && (
989 <SidebarLink to={`${base}/settings/webhooks`} icon={<Webhook size={15} />}>
990 Webhooks
991 </SidebarLink>
992 )}
993 </NavRows>
994 </nav>
995 );
996}
997
998/**
999 * Whether the menus list Settings → Invites (invites to g1t): always while
1000 * sign-up takes an invite; once anyone can sign up, only for someone with
1001 * invites already made to look back on, which the account menu's data says.
1002 */
1003function useInvitesListed(): boolean {
1004 const inviteOnly = useInviteOnly();
1005 const details = useFetcher<AccountMenuData | null>({ key: "account-menu" });
1006 useEffect(() => {
1007 if (!inviteOnly && details.state === "idle" && details.data === undefined) details.load("/settings/menu.json");
1008 // eslint-disable-next-line react-hooks/exhaustive-deps
1009 }, [inviteOnly]);
1010 return inviteOnly || details.data?.invites_page === true;
1011}
1012
1013/** Your own settings, drilled into from Your settings: one page each. */
1014function AccountSettingsMenu({ username }: { username: string }) {
1015 const invites = useInvitesListed();
1016 const link = (page: AccountSettingsPage, icon: ReactNode) => (
1017 <SidebarLink to={`/settings/${page}`} icon={icon}>
1018 {ACCOUNT_SETTINGS[page].title}
1019 </SidebarLink>
1020 );
1021 return (
1022 <nav aria-label="Your settings" className={PANEL}>
1023 <BackRow to="/" label="Your settings" context={username} />
1024 <NavRows className="mt-2">
1025 {link("profile", <CircleUserRound size={15} />)}
1026 {link("emails", <Mail size={15} />)}
1027 {invites && link("invites", <Ticket size={15} />)}
1028 </NavRows>
1029 <Rule />
1030 <NavRows>
1031 {link("keys", <Fingerprint size={15} />)}
1032 {link("tokens", <KeyRound size={15} />)}
1033 </NavRows>
1034 <Rule />
1035 <NavRows>
1036 {link("integrations", <Blocks size={15} />)}
1037 {link("github", <GithubMark className="size-3.75" />)}
1038 {link("applications", <Plug size={15} />)}
1039 </NavRows>
1040 <Rule />
1041 <NavRows>
1042 {link("two-factor", <ShieldCheck size={15} />)}
1043 {link("security-log", <History size={15} />)}
1044 </NavRows>
1045 </nav>
1046 );
1047}
1048
1049/**
1050 * Code's sidebar: its Overview, the projects, what spans them and what is
1051 * coming; in a project, drilled into the project's own list, and its
1052 * settings one level further in. The address says which, so a link
1053 * straight to a project opens the sidebar already drilled in.
1054 */
1055function CodeSidebar({
1056 user,
1057 shell,
1058 missing = false,
1059}: {
1060 user: User;
1061 shell: ShellData;
1062 /** The page is a 404: the address names nothing the viewer can see. */
1063 missing?: boolean;
1064}) {
1065 const ws = shell.workspace;
1066 const { pathname } = useLocation();
1067 const going = useNavigation().location?.pathname;
1068 // Where the sidebar is drilled to follows the page being gone to, so it
1069 // moves as the link is followed, not once the page arrives.
1070 const target = going ?? pathname;
1071 // On a 404, the address is not a place: no list is drilled into from it,
1072 // except the project's own when the project is real and visible and only
1073 // something inside it is missing (a file, a commit, an issue).
1074 const lost = missing && going == null;
1075 const active = shell.repo;
1076 // In a repository, or on the way into one, its own list.
1077 const repoPath = /^\/([^/]+)\/([^/-][^/]*)(\/|$)/.exec(target);
1078 const reserved = new Set(["settings", "explore", "search", "new", "u", "pricing", "avatars", "workspaces", "login", "logout", "register", "verify", "forgot", "reset", "device", "oauth", "policies", "security", "support", "status", "invite", "notifications", "inbox", ".well-known"]);
1079 // An invitation to a repository is answered before its menu means anything.
1080 const inRepo =
1081 repoPath != null &&
1082 !reserved.has(repoPath[1]) &&
1083 repoPath[2] !== "-" &&
1084 !/^\/[^/]+\/[^/]+\/invitations\/?$/.test(target) &&
1085 (!lost || sameRepo(active, { namespace: repoPath[1]!, name: repoPath[2]! }));
1086 // A project's settings, one level further in.
1087 const inRepoSettings = inRepo && REPO_SETTINGS_PAGE.test(target);
1088 // The repository the menu is for: the one loaded if it is the one being
1089 // gone to, else what the address says, at once.
1090 const targetRepo = inRepo && repoPath ? { namespace: repoPath[1], name: repoPath[2] } : null;
1091 const guessed: MenuRepo | null = targetRepo
1092 ? sameRepo(active, targetRepo)
1093 ? active
1094 : {
1095 ...targetRepo,
1096 member: (user.workspaces ?? []).some((m) => m.slug === targetRepo.namespace.toLowerCase()),
1097 }
1098 : null;
1099 // The viewer's role there, from the repository's page once it has loaded.
1100 const page = useRouteLoaderData("routes/repo/layout") as
1101 | { repo?: { namespace: string; name: string; mirror?: RepoMirror | null }; access?: ViewerAccess }
1102 | undefined;
1103 const menuRepo: MenuRepo | null =
1104 guessed && page?.access && page.repo && sameRepo(page.repo, guessed)
1105 ? { ...guessed, member: page.access.insider, settings: seesSettings(page.access), can: page.access.can, mirror: page.repo.mirror }
1106 : guessed;
1107
1108 // The way from Code's list to the one shown.
1109 const trail: Level[] = [{ key: "main", node: ws ? <CodeMenu shell={shell} slug={ws.slug} /> : null }];
1110 if (menuRepo) {
1111 const key = `repo:${menuRepo.namespace}/${menuRepo.name}`.toLowerCase();
1112 // Out of a project: to its workspace's projects when they are yours.
1113 const home = (user.workspaces ?? []).find((m) => m.slug === menuRepo.namespace.toLowerCase());
1114 const back = home ? { to: `/${home.slug}/-/projects`, label: "All projects" } : { to: ws ? `/${ws.slug}/-/overview` : "/explore", label: "Code" };
1115 trail.push({
1116 key,
1117 node: (
1118 <RepoMenu
1119 repo={menuRepo}
1120 isPrivate={[...shell.repos, ...(shell.shared ?? [])].some((repo) => sameRepo(repo, menuRepo) && repo.isPrivate)}
1121 back={back}
1122 />
1123 ),
1124 });
1125 if (inRepoSettings) trail.push({ key: `${key}:settings`, node: <RepoSettingsMenu repo={menuRepo} /> });
1126 }
1127
1128 return (
1129 <div className="flex h-full flex-col">
1130 <ModeHeader title="Code" />
1131 <Drill trail={trail} />
1132 </div>
1133 );
1134}
1135
1136/**
1137 * A mode's sidebar heading: its name, quiet, under the workspace's
1138 * switcher, with what it makes at the end.
1139 */
1140export function ModeHeader({ title, action }: { title: ReactNode; action?: ReactNode }) {
1141 return (
1142 <div className="flex h-8 shrink-0 items-center gap-1 pr-2 pl-3">
1143 <SidebarGroupLabel asChild className="min-w-0 grow truncate px-1">
1144 <h2>{title}</h2>
1145 </SidebarGroupLabel>
1146 {action}
1147 </div>
1148 );
1149}
1150
1151/**
1152 * Code's own list (beside the rail): only code. Its Overview (Mission
1153 * control's code panels), the projects, what spans them, and what is
1154 * coming. The workspace's people, money and settings are elsewhere.
1155 */
1156function CodeMenu({ shell, slug }: { shell: ShellData; slug: string }) {
1157 const { pathname } = useLocation();
1158 const going = useNavigation().location?.pathname;
1159 const path = going ?? pathname;
1160 const at = (page: string) => path === `/${slug}/-/${page}` || path.startsWith(`/${slug}/-/${page}/`);
1161 const shared = shell.shared ?? [];
1162 return (
1163 <nav aria-label="Code" className={PANEL}>
1164 <NavRows>
1165 <SidebarLink to={`/${slug}/-/overview`} icon={<LayoutDashboard size={15} />} current={at("overview")}>
1166 Overview
1167 </SidebarLink>
1168 </NavRows>
1169 <Rule />
1170 <SidebarProjects slug={slug} shell={shell} current={at("projects")} />
1171 <Rule />
1172 <NavRows>
1173 <SidebarLink to={`/${slug}/-/security`} icon={<ShieldCheck size={15} />} current={at("security") && !at("security/settings")}>
1174 Security
1175 </SidebarLink>
1176 <SidebarLink to={`/${slug}/-/packages`} icon={<Package size={15} />} current={at("packages")}>
1177 Packages
1178 </SidebarLink>
1179 <SidebarLink to={`/${slug}/-/memory`} icon={<Brain size={15} />} current={at("memory")}>
1180 Memory
1181 </SidebarLink>
1182 {INSIGHTS && (
1183 <SidebarSoonLink to={`/${slug}/-/insights`} icon={<TrendingUp size={15} />} about={INSIGHTS.summary} current={at("insights")}>
1184 {INSIGHTS.title}
1185 </SidebarSoonLink>
1186 )}
1187 </NavRows>
1188 {shared.length > 0 && (
1189 <>
1190 <Rule />
1191 <NavGroup title="Shared with you">
1192 {shared.map((repo) => (
1193 <SidebarLink
1194 key={`${repo.namespace}/${repo.name}`}
1195 to={`/${repo.namespace}/${repo.name}`}
1196 icon={repo.isPrivate ? <Lock size={15} /> : <Box size={15} />}
1197 drill="hover"
1198 >
1199 <span className="font-mono text-faint">{repo.namespace}/</span>
1200 {repo.name}
1201 </SidebarLink>
1202 ))}
1203 </NavGroup>
1204 </>
1205 )}
1206 </nav>
1207 );
1208}
1209
1210/** The icon of each of Workspace mode's pages, by its key (lib/workspace-nav.ts). */
1211const WORKSPACE_PAGE_ICONS: Record<string, ReactNode> = {
1212 settings: <Settings size={15} />,
1213 members: <Users size={15} />,
1214 invitations: <Mail size={15} />,
1215 permissions: <ShieldCheck size={15} />,
1216 tokens: <KeyRound size={15} />,
1217 "personal-access-tokens": <UserRoundKey size={15} />,
1218 usage: <BarChart3 size={15} />,
1219 billing: <CreditCard size={15} />,
1220 runners: <ServerCog size={15} />,
1221 repositories: <BookMarked size={15} />,
1222 actions: <PlayCircle size={15} />,
1223 secrets: <Lock size={15} />,
1224 webhooks: <Webhook size={15} />,
1225 deployments: <Rocket size={15} />,
1226 projects: <Layers size={15} />,
1227 "chat-settings": <MessagesSquare size={15} />,
1228 emoji: <Smile size={15} />,
1229 "artifact-settings": <Shapes size={15} />,
1230 "security-settings": <Shield size={15} />,
1231 guardrails: <Gauge size={15} />,
1232 rules: <Scale size={15} />,
1233 audit: <History size={15} />,
1234 integrations: <Plug size={15} />,
1235 applications: <Blocks size={15} />,
1236};
1237
1238/**
1239 * A group of Workspace mode's rows that folds: its name is the button, with
1240 * a chevron that turns when it is open. The group holding the current page
1241 * is always open, and its button does nothing. Every group starts open, so
1242 * the server and the browser draw the same list.
1243 */
1244function FoldingGroup({ title, current, children }: { title: string; current: boolean; children: ReactNode }) {
1245 const [open, setOpen] = useState(true);
1246 return (
1247 <Collapsible open={open || current} onOpenChange={setOpen}>
1248 <SidebarGroup>
1249 <CollapsibleTrigger
1250 disabled={current}
1251 aria-label={`${title}: ${open || current ? "fold" : "unfold"}`}
1252 className="flex h-7 w-full shrink-0 items-center justify-between rounded-md px-2 text-[0.6875rem] font-medium tracking-wide text-faint uppercase hover:text-muted focus-visible:ring-2 focus-visible:ring-accent disabled:cursor-default disabled:text-faint data-[state=open]:[&_svg]:rotate-90"
1253 >
1254 <span>{title}</span>
1255 {!current && <ChevronRight size={12} aria-hidden="true" className="text-faint/70" />}
1256 </CollapsibleTrigger>
1257 <CollapsibleContent>
1258 <SidebarGroupContent>
1259 <SidebarMenu>{children}</SidebarMenu>
1260 </SidebarGroupContent>
1261 </CollapsibleContent>
1262 </SidebarGroup>
1263 </Collapsible>
1264 );
1265}
1266
1267/**
1268 * The Workspace mode's sidebar: the workspace's settings area, every page
1269 * one click away. Its overview, then the groups in lib/workspace-nav.ts
1270 * (General, Access, Money, Compute, Code, Chat, Artifacts,
1271 * Security, Integrations), each folding, the one you are in held open.
1272 * Pages only owners open are left out for members, and a group with none
1273 * left goes with them; a page that is coming is a Soon row, not a link.
1274 */
1275export function WorkspaceSidebar({ slug, owner }: { slug: string; owner: boolean }) {
1276 const { pathname } = useLocation();
1277 const going = useNavigation().location?.pathname;
1278 const path = going ?? pathname;
1279 const here = workspaceSettingsPage(path, slug);
1280 const overview = path === `/${slug}/-/workspace` || path.startsWith(`/${slug}/-/workspace/`);
1281 const shown = (page: WorkspaceSettingsPage) => owner || !page.owner;
1282 return (
1283 <div className="flex h-full flex-col">
1284 <ModeHeader title="Workspace" />
1285 <nav aria-label="Workspace" className={PANEL}>
1286 <NavRows>
1287 <SidebarLink to={`/${slug}/-/workspace`} icon={<LayoutGrid size={15} />} current={overview}>
1288 Overview
1289 </SidebarLink>
1290 </NavRows>
1291 {WORKSPACE_SETTINGS_GROUPS.filter((group) => group.pages.some(shown)).map((group) => (
1292 <Fragment key={group.key}>
1293 <Rule />
1294 <FoldingGroup title={group.title} current={here?.group === group.key}>
1295 {group.pages.filter(shown).map((page) =>
1296 page.soon ? (
1297 <SidebarSoon key={page.key} icon={WORKSPACE_PAGE_ICONS[page.key] ?? <Sparkles size={15} />} about={page.soon}>
1298 {page.label}
1299 </SidebarSoon>
1300 ) : (
1301 <SidebarLink
1302 key={page.key}
1303 to={`/${slug}/-/${page.path}`}
1304 icon={WORKSPACE_PAGE_ICONS[page.key] ?? <Settings size={15} />}
1305 current={here?.page === page.key}
1306 >
1307 {page.label}
1308 </SidebarLink>
1309 ),
1310 )}
1311 </FoldingGroup>
1312 </Fragment>
1313 ))}
1314 </nav>
1315 </div>
1316 );
1317}
1318
1319/**
1320 * People's sidebar: everyone in the workspace and its teams. Who belongs, and
1321 * inviting people, is the workspace's: Workspace mode's Access group.
1322 */
1323function PeopleSidebar({ slug }: { slug: string }) {
1324 const { pathname } = useLocation();
1325 const going = useNavigation().location?.pathname;
1326 const path = going ?? pathname;
1327 const at = (page: string) => path === `/${slug}/-/${page}` || path.startsWith(`/${slug}/-/${page}/`);
1328 return (
1329 <div className="flex h-full flex-col">
1330 <ModeHeader title="People" />
1331 <nav aria-label="People" className={PANEL}>
1332 <NavRows>
1333 <SidebarLink to={`/${slug}/-/people`} icon={<Users size={15} />} current={at("people")}>
1334 Everyone
1335 </SidebarLink>
1336 <SidebarLink to={`/${slug}/-/teams`} icon={<UsersRound size={15} />} current={at("teams")}>
1337 Teams
1338 </SidebarLink>
1339 </NavRows>
1340 </nav>
1341 </div>
1342 );
1343}
1344
1345/**
1346 * Notifications' sidebar: what you have not finished with, what you saved
1347 * and what is done; then why you were told, which narrows any of them.
1348 */
1349function NotificationsSidebar({ counts }: { counts: InboxCounts | null }) {
1350 const { search } = useLocation();
1351 const params = new URLSearchParams(search);
1352 const view = inboxView(params.get("view"));
1353 const reason = inboxReason(params.get("reason"));
1354 const tab = params.get("tab");
1355 const address = (changes: Record<string, string | null>) => {
1356 const merged: Record<string, string | null> = { tab, view: view === "inbox" ? null : view, reason, ...changes };
1357 const next = new URLSearchParams();
1358 for (const [name, value] of Object.entries(merged)) if (value) next.set(name, value);
1359 const query = next.toString();
1360 return query ? `/notifications?${query}` : "/notifications";
1361 };
1362 const views = [
1363 { view: "inbox", label: "Everything", icon: <Bell size={15} />, count: counts?.unread },
1364 { view: "saved", label: "Saved", icon: <Bookmark size={15} /> },
1365 { view: "done", label: "Done", icon: <Check size={15} /> },
1366 ] as const;
1367 return (
1368 <div className="flex h-full flex-col">
1369 <ModeHeader title="Notifications" />
1370 <nav aria-label="Notifications" className={PANEL}>
1371 <NavRows>
1372 {views.map((entry) => (
1373 <SidebarLink
1374 key={entry.view}
1375 to={address({ view: entry.view === "inbox" ? null : entry.view, before: null })}
1376 icon={entry.icon}
1377 count={"count" in entry ? (entry.count ?? undefined) : undefined}
1378 current={view === entry.view}
1379 >
1380 {entry.label}
1381 </SidebarLink>
1382 ))}
1383 </NavRows>
1384 <Rule />
1385 <NavGroup title="Why you were told">
1386 {REASON_FILTERS.map((entry) => (
1387 <SidebarLink
1388 key={entry.reason ?? "any"}
1389 to={address({ reason: entry.reason, before: null })}
1390 icon={<span className="block size-3.75" />}
1391 current={reason === entry.reason}
1392 >
1393 {entry.reason == null ? "Any reason" : entry.label}
1394 </SidebarLink>
1395 ))}
1396 </NavGroup>
1397 </nav>
1398 </div>
1399 );
1400}
1401
1402/** Your own settings, beside the page: under the account menu, not any workspace's. */
1403export function AccountSidebar({ username }: { username: string }) {
1404 return (
1405 <div className="flex h-full flex-col">
1406 <ModeHeader title="Your account" />
1407 <div className="min-h-0 grow">
1408 <AccountSettingsMenu username={username} />
1409 </div>
1410 </div>
1411 );
1412}
1413
1414/** Words for the sections a path can end in. */
1415const SECTIONS: Record<string, string> = {
1416 issues: "Issues",
1417 milestones: "Milestones",
1418 labels: "Labels",
1419 pulls: "Pull requests",
1420 queue: "Merge queue",
1421 commits: "Commits",
1422 actions: "Workflows",
1423 soon: "Soon",
1424 deployments: "Deployments",
1425 repository: "Repository",
1426 access: "Access",
1427 invitations: "Invitation",
1428 repositories: "Repositories",
1429 branches: "Branches",
1430 tags: "Tags",
1431 compare: "Compare",
1432 code: "Files",
1433 secrets: "Secrets and variables",
1434 settings: "Settings",
1435 people: "People",
1436 members: "Members",
1437 permissions: "Permissions",
1438 projects: "Projects",
1439 teams: "Teams",
1440 tokens: "Access tokens",
1441 "personal-access-tokens": "Personal access tokens",
1442 usage: "Usage",
1443 billing: "Billing and plans",
1444 integrations: "Integrations",
1445 webhooks: "Webhooks",
1446 emoji: "Emoji",
1447 domains: "Domains",
1448 guardrails: "Guardrails",
1449 rules: "Rules",
1450 audit: "Audit log",
1451 tree: "Files",
1452 blob: "Files",
1453 memory: "Memory",
1454 security: "Security",
1455 packages: "Packages",
1456 runners: "Runners",
1457 environments: "Environments",
1458 workflows: "Workflows",
1459 observability: "Observability",
1460 insights: "Insights",
1461 sessions: "Sessions",
1462 chat: "Chat",
1463 artifacts: "Artifacts",
1464 home: "Home",
1465 apps: "Apps",
1466 "code-access": "Code access",
1467 overview: "Overview",
1468 workspace: "Workspace",
1469};
1470
1471/** Settings pages whose name differs from the section's of the same word. */
1472const SETTINGS_SECTIONS: Record<string, string> = { branches: "Branches and merging", actions: "Actions" };
1473
1474/** Where the page is, as a trail of links: workspace / repository / section. */
1475function Breadcrumbs({
1476 pathname,
1477 missing,
1478 repo,
1479 workspace,
1480}: {
1481 pathname: string;
1482 missing?: boolean;
1483 repo?: ShellData["repo"];
1484 /** The workspace you are in: the switcher names it, so the trail starts after it. */
1485 workspace: string | null;
1486}) {
1487 // A 404 names nothing from the address, unless the project is real and
1488 // visible and only something inside it is missing.
1489 const visibleRepo = /^\/([^/]+)\/([^/-][^/]*)(\/|$)/.exec(pathname);
1490 if (missing && !(visibleRepo && sameRepo(repo ?? null, { namespace: visibleRepo[1]!, name: visibleRepo[2]! }))) {
1491 return <Here>Not found</Here>;
1492 }
1493 const parts = pathname.split("/").filter(Boolean);
1494 const reserved = ["settings", "explore", "new", "search", "workspaces", "policies", "security", "support", "status", "invite", "notifications"];
1495 if (parts.length === 0) return <Here>Home</Here>;
1496 // Your settings: Settings / Emails.
1497 if (parts[0] === "settings") {
1498 const page = accountSettingsPage(pathname);
1499 return <Trail trail={[{ label: "Settings", to: FIRST_SETTINGS_PAGE }, ...(page ? [{ label: ACCOUNT_SETTINGS[page].title, to: `/settings/${page}` }] : [])]} />;
1500 }
1501 if (reserved.includes(parts[0]!)) {
1502 const words: Record<string, string> = {
1503 settings: "Account",
1504 explore: "Explore",
1505 new: "New project",
1506 search: "Search",
1507 workspaces: "New workspace",
1508 policies: "Policies",
1509 security: "Security",
1510 support: "Support",
1511 status: "Status",
1512 invite: "Invite",
1513 notifications: "Notifications",
1514 };
1515 return <Here>{words[parts[0]!]}</Here>;
1516 }
1517 // A person's profile, by their handle.
1518 if (parts[0] === "u" && parts[1]) return <ProfileCrumb username={parts[1]} />;
1519 const [owner, second, third, fourth] = parts;
1520 const ours = workspace != null && owner!.toLowerCase() === workspace.toLowerCase();
1521 const trail: Crumb[] = ours ? [] : [{ label: owner!, to: `/${owner}`, mono: true }];
1522 if (second === "-") {
1523 const page = `/${owner}/-/${third}`;
1524 if (third === "settings" && fourth === "chat") {
1525 // Chat settings is a page of its own, not one of General's.
1526 trail.push({ label: "Chat settings", to: `${page}/chat` });
1527 } else if (third) {
1528 // The workspace's settings pages each stand alone: General, Members, Permissions.
1529 trail.push({ label: third === "settings" ? "General" : (SECTIONS[third] ?? third), to: page });
1530 // Members names its invitations.
1531 const tabs: Record<string, string> = third === "members" ? { invitations: "Invitations" } : {};
1532 const tab = fourth ? tabs[fourth] : undefined;
1533 if (tab) trail.push({ label: tab, to: `${page}/${fourth}` });
1534 }
1535 } else if (second) {
1536 const repo = `/${owner}/${second}`;
1537 trail.push({ label: second, to: repo, mono: true });
1538 if (third === "pull" && fourth) trail.push({ label: `Pull request #${fourth}`, short: `#${fourth}`, to: `${repo}/pull/${fourth}` });
1539 else if (third === "issues" && fourth && fourth !== "new") trail.push({ label: `Issue #${fourth}`, short: `#${fourth}`, to: `${repo}/issues/${fourth}` });
1540 else if (third === "commit" && fourth) trail.push({ label: fourth.slice(0, 7), to: `${repo}/commit/${fourth}`, mono: true });
1541 else if (third && SECTIONS[third]) {
1542 trail.push({ label: SECTIONS[third]!, to: `${repo}/${third}` });
1543 // A settings page names which one: Settings / Secrets and variables.
1544 if (third === "settings" && fourth && SECTIONS[fourth]) {
1545 trail.push({ label: SETTINGS_SECTIONS[fourth] ?? SECTIONS[fourth]!, to: `${repo}/settings/${fourth}` });
1546 }
1547 }
1548 }
1549 if (trail.length === 0) trail.push({ label: "Overview", to: `/${owner}` });
1550 return <Trail trail={trail} />;
1551}
1552
1553/** A profile's place in the top bar: the person's avatar and @handle, from the page once it has loaded. */
1554function ProfileCrumb({ username }: { username: string }) {
1555 const page = useRouteLoaderData("routes/user") as { profile?: { username: string; displayUsername?: string | null; avatar: string | null } } | undefined;
1556 const profile = page?.profile?.username.toLowerCase() === username.toLowerCase() ? page.profile : null;
1557 return (
1558 <Breadcrumb className="min-w-0">
1559 <BreadcrumbList>
1560 <BreadcrumbItem>
1561 <BreadcrumbPage asChild className="flex items-center gap-2 hover:bg-raised">
1562 <Link to={`/u/${profile?.username ?? username}`}>
1563 <Avatar name={profile?.username ?? username} image={profile?.avatar ?? null} size={20} />
1564 <span className="truncate font-mono text-[0.8125rem]">@{profile ? shownUsername(profile) : username}</span>
1565 </Link>
1566 </BreadcrumbPage>
1567 </BreadcrumbItem>
1568 </BreadcrumbList>
1569 </Breadcrumb>
1570 );
1571}
1572
1573/** A page with no trail to it, such as Today or Search: its name alone. */
1574function Here({ children }: { children: ReactNode }) {
1575 return (
1576 <Breadcrumb className="min-w-0">
1577 <BreadcrumbList>
1578 <BreadcrumbItem>
1579 <BreadcrumbPage>{children}</BreadcrumbPage>
1580 </BreadcrumbItem>
1581 </BreadcrumbList>
1582 </Breadcrumb>
1583 );
1584}
1585
1586/** One link of the trail; `short` is what a phone shows when it is the page itself. */
1587type Crumb = { label: string; to: string; mono?: boolean; short?: string };
1588
1589/**
1590 * The trail of links. On a phone there is room for one: the page itself,
1591 * with a way back to where it sits; the whole trail from a wider screen up.
1592 */
1593function Trail({ trail }: { trail: Crumb[] }) {
1594 // Up on a phone, unless up is the workspace itself: its pages are the tabs.
1595 const up = trail.length > 1 && !/^\/[^/]+$/.test(trail[trail.length - 2]!.to) ? trail[trail.length - 2]! : null;
1596 return (
1597 <Breadcrumb className="flex min-w-0 items-center">
1598 {up && (
1599 <Button asChild variant="ghost" size="icon-bar" className="-ml-1 sm:hidden">
1600 <Link to={up.to} prefetch="intent" aria-label={`Back to ${up.label}`}>
1601 <ChevronLeft size={16} />
1602 </Link>
1603 </Button>
1604 )}
1605 <BreadcrumbList>
1606 {trail.map((crumb, index) => {
1607 const last = index === trail.length - 1;
1608 const label =
1609 last && crumb.short ? (
1610 <>
1611 <span className="sm:hidden">{crumb.short}</span>
1612 <span className="hidden sm:inline">{crumb.label}</span>
1613 </>
1614 ) : (
1615 crumb.label
1616 );
1617 const mono = crumb.mono ? "font-mono text-[0.8125rem]" : "";
1618 return (
1619 <Fragment key={index}>
1620 {index > 0 && <BreadcrumbSeparator className="max-sm:hidden" />}
1621 <BreadcrumbItem className={last ? "" : "max-sm:hidden"}>
1622 {last ? (
1623 // The page you are on is still a link: to its own top, as the trail always was.
1624 <BreadcrumbPage asChild className={`hover:bg-raised ${mono}`}>
1625 <Link to={crumb.to} prefetch="intent">
1626 {label}
1627 </Link>
1628 </BreadcrumbPage>
1629 ) : (
1630 <BreadcrumbLink asChild className={mono}>
1631 <Link to={crumb.to} prefetch="intent">
1632 {label}
1633 </Link>
1634 </BreadcrumbLink>
1635 )}
1636 </BreadcrumbItem>
1637 </Fragment>
1638 );
1639 })}
1640 </BreadcrumbList>
1641 </Breadcrumb>
1642 );
1643}
1644
1645type Command = PaletteCommand;
1646
1647/** Everything the palette can jump to, from what the sidebar already knows. */
1648function commandsFor(user: User, shell: ShellData): Command[] {
1649 const ws = shell.workspace;
1650 const commands: Command[] = [
1651 ...(ws
1652 ? [
1653 { label: "Home", to: homePagePath(ws.slug), icon: <House size={15} /> },
1654 { label: "Chat", to: `/${ws.slug}/-/chat`, icon: <MessagesSquare size={15} /> },
1655 ...(hasCodeAccess(ws) ? [{ label: "Code overview", to: `/${ws.slug}/-/overview`, icon: <Code2 size={15} /> }] : []),
1656 { label: "Artifacts", to: `/${ws.slug}/-/artifacts`, icon: <Shapes size={15} /> },
1657 { label: "Apps", hint: "Everything installed that you can use", to: `/${ws.slug}/-/apps`, icon: <LayoutGrid size={15} /> },
1658 { label: "Workspace", hint: "Billing, policies, settings", to: `/${ws.slug}/-/workspace`, icon: <Building2 size={15} /> },
1659 ]
1660 : []),
1661 { label: "Explore repositories", to: "/explore", icon: <Compass size={15} /> },
1662 { label: "Search g1t", hint: "Repositories, code, issues, people", to: "/search", icon: <Search size={15} /> },
1663 { label: "Notifications", hint: "What needs you", to: "/notifications", icon: <Bell size={15} /> },
1664 { label: "New project", to: "/new", icon: <Plus size={15} /> },
1665 { label: "Your settings", to: FIRST_SETTINGS_PAGE, icon: <Settings size={15} /> },
1666 ...(Object.keys(ACCOUNT_SETTINGS) as AccountSettingsPage[])
1667 .filter((page) => page !== "profile")
1668 .map((page) => ({ label: ACCOUNT_SETTINGS[page].title, hint: "Your settings", to: `/settings/${page}`, icon: <Settings size={15} /> })),
1669 ...THEME_COMMANDS,
1670 ];
1671 const repo = shell.repo;
1672 if (repo) {
1673 const base = `/${repo.namespace}/${repo.name}`;
1674 const name = `${repo.namespace}/${repo.name}`;
1675 commands.unshift(
1676 { label: "Overview", hint: name, to: base, icon: <LayoutGrid size={15} /> },
1677 { label: "Code", hint: name, to: `${base}/code`, icon: <Code2 size={15} /> },
1678 { label: "Issues", hint: name, to: `${base}/issues`, icon: <CircleDot size={15} /> },
1679 { label: "New issue", hint: name, to: `${base}/issues/new`, icon: <Plus size={15} /> },
1680 { label: "Pull requests", hint: name, to: `${base}/pulls`, icon: <GitPullRequest size={15} /> },
1681 { label: "Commits", hint: name, to: `${base}/commits`, icon: <History size={15} /> },
1682 ...(repo.member
1683 ? [
1684 { label: "Deployments", hint: name, to: `${base}/deployments`, icon: <Rocket size={15} /> },
1685 { label: "Secrets and variables", hint: name, to: `${base}/settings/secrets`, icon: <Lock size={15} /> },
1686 { label: "Project settings", hint: name, to: `${base}/settings`, icon: <Settings size={15} /> },
1687 { label: "Repository settings", hint: name, to: `${base}/settings/repository`, icon: <Settings size={15} /> },
1688 ]
1689 : []),
1690 );
1691 }
1692 for (const membership of user.workspaces ?? []) {
1693 commands.push(
1694 { label: displayName(membership), hint: `Workspace · ${membership.slug}`, to: `/${membership.slug}`, icon: <Avatar name={membership.slug} image={membership.avatar} size={15} square /> },
1695 { label: "All projects", hint: membership.slug, to: `/${membership.slug}/-/projects`, icon: <LayoutGrid size={15} /> },
1696 { label: "People", hint: membership.slug, to: `/${membership.slug}/-/people`, icon: <Users size={15} /> },
1697 { label: "Usage", hint: membership.slug, to: `/${membership.slug}/-/usage`, icon: <BarChart3 size={15} /> },
1698 { label: "Billing and plans", hint: `${membership.slug} · Settings`, to: `/${membership.slug}/-/billing`, icon: <CreditCard size={15} /> },
1699 { label: "Access tokens", hint: `${membership.slug} · Settings`, to: `/${membership.slug}/-/tokens`, icon: <KeyRound size={15} /> },
1700 { label: "Integrations", hint: membership.slug, to: `/${membership.slug}/-/integrations`, icon: <Plug size={15} /> },
1701 { label: "Members", hint: `${membership.slug} · Access`, to: `/${membership.slug}/-/members`, icon: <Users size={15} /> },
1702 ...(membership.role === "owner"
1703 ? [
1704 { label: "Invitations", hint: `${membership.slug} · Access`, to: `/${membership.slug}/-/members/invitations`, icon: <Mail size={15} /> },
1705 { label: "Permissions", hint: `${membership.slug} · Access`, to: `/${membership.slug}/-/permissions`, icon: <ShieldCheck size={15} /> },
1706 ]
1707 : []),
1708 );
1709 }
1710 for (const listed of shell.repos) {
1711 commands.push({
1712 label: listed.title ?? listed.name,
1713 hint: `${listed.namespace} · Project`,
1714 to: `/${listed.namespace}/${listed.name}`,
1715 icon: <Box size={15} />,
1716 });
1717 }
1718 return commands;
1719}
1720
1721/**
1722 * The page while the next one loads: after a moment it dims, under the
1723 * bar below, so it is plainly on its way out rather than frozen, and the
1724 * next page fades up from there. Sending a form does not dim it: the
1725 * form's button says it is working. Spread on the element holding the page.
1726 */
1727export function useLeaving() {
1728 const navigation = useNavigation();
1729 const method = navigation.formMethod?.toUpperCase();
1730 const leaving = navigation.state === "loading" && (method == null || method === "GET");
1731 return {
1732 "aria-busy": leaving || undefined,
1733 className: `transition-opacity motion-reduce:transition-none ${leaving ? "opacity-60 delay-200 duration-300" : "duration-150"}`,
1734 };
1735}
1736
1737/**
1738 * A bar across the top of the page while the next one loads, as GitHub
1739 * has: it appears at once, creeps towards the end while waiting, then fills
1740 * and fades when the page arrives.
1741 */
1742export function Progress() {
1743 const navigation = useNavigation();
1744 const busy = navigation.state !== "idle";
1745 const [width, setWidth] = useState(0);
1746 const [visible, setVisible] = useState(false);
1747 useEffect(() => {
1748 if (busy) {
1749 setVisible(true);
1750 setWidth(12);
1751 // Slows as it goes, never quite arriving until the page does.
1752 const timer = setInterval(() => setWidth((now) => now + (90 - now) * 0.12), 200);
1753 return () => clearInterval(timer);
1754 }
1755 setWidth((now) => (now > 0 ? 100 : 0));
1756 const fade = setTimeout(() => setVisible(false), 250);
1757 const reset = setTimeout(() => setWidth(0), 550);
1758 return () => {
1759 clearTimeout(fade);
1760 clearTimeout(reset);
1761 };
1762 }, [busy]);
1763 return (
1764 <div
1765 aria-hidden="true"
1766 className={`pointer-events-none fixed inset-x-0 top-0 z-60 h-0.75 transition-opacity duration-300 ${
1767 visible ? "opacity-100" : "opacity-0"
1768 }`}
1769 >
1770 <div
1771 className="h-full bg-accent shadow-[0_0_10px_var(--color-accent)] transition-[width] duration-200 ease-out"
1772 style={{ width: `${width}%` }}
1773 />
1774 </div>
1775 );
1776}
1777
1778/**
1779 * Which sidebar sits beside the page: each mode's own, or none. Home and
1780 * Apps are pages at full width, and so are g1t's public pages, such as a
1781 * profile, which are no workspace's. Without a workspace, only your own
1782 * settings and Notifications have one.
1783 */
1784function sidebarFor(mode: ModeKey, workspace: boolean): Panel | null {
1785 if (!workspace) return mode === "account" || mode === "notifications" ? mode : null;
1786 if (mode === "home" || mode === "apps" || mode === "site") return null;
1787 return mode;
1788}
1789
1790/** The sidebars that sit beside the page, one per mode that has one. */
1791type Panel = "chat" | "artifacts" | "code" | "notifications" | "people" | "workspace" | "account";
1792
1793/** Each sidebar's name, for the button that opens it on a phone. */
1794const MODE_MENU: Record<Panel, string> = {
1795 chat: "Chat",
1796 artifacts: "Artifacts",
1797 code: "Code",
1798 notifications: "Notifications",
1799 people: "People",
1800 workspace: "Workspace",
1801 account: "Your account",
1802};
1803
1804/** Whether a key press happened in something you type into, where Ctrl B is the editor's. */
1805function typing(target: EventTarget | null): boolean {
1806 if (!(target instanceof HTMLElement)) return false;
1807 return target.isContentEditable || target.closest("input, textarea, select, [contenteditable=''], [contenteditable='true'], [role='textbox']") != null;
1808}
1809
1810/** Ctrl B (⌘B on a Mac) shows or hides the sidebar, except while typing. */
1811function useSidebarShortcut(toggle: () => void) {
1812 useEffect(() => {
1813 const onKey = (event: KeyboardEvent) => {
1814 if (event.key.toLowerCase() !== "b" || event.altKey || event.shiftKey || !(event.ctrlKey || event.metaKey)) return;
1815 if (event.defaultPrevented || typing(event.target)) return;
1816 event.preventDefault();
1817 toggle();
1818 };
1819 window.addEventListener("keydown", onKey);
1820 return () => window.removeEventListener("keydown", onKey);
1821 }, [toggle]);
1822}
1823
1824/**
1825 * Search or jump to: the command palette. On a computer it looks like the
1826 * field it opens, with its shortcut; on a phone, a magnifier.
1827 */
1828function SearchButton({ onClick, place }: { onClick: () => void; place: "bar" | "sidebar" }) {
1829 const field = (
1830 <Button
1831 variant="outline"
1832 size="sm"
1833 aria-label="Search or jump to"
1834 onClick={onClick}
1835 className={
1836 place === "sidebar"
1837 ? "w-full justify-start bg-bg font-normal text-faint hover:bg-bg hover:text-muted"
1838 : "mr-1 w-[min(18rem,26vw)] justify-start bg-surface font-normal text-faint hover:bg-surface hover:text-muted max-md:hidden"
1839 }
1840 >
1841 <Search size={15} />
1842 <span className="grow truncate text-left">Search or jump to</span>
1843 <PaletteKey className="px-1.5 text-[0.625rem] leading-4 text-muted" />
1844 </Button>
1845 );
1846 if (place === "sidebar") return field;
1847 return (
1848 <>
1849 <Button variant="ghost" size="icon-bar" aria-label="Search or jump to" onClick={onClick} className="md:hidden">
1850 <Search size={18} />
1851 </Button>
1852 {field}
1853 </>
1854 );
1855}
1856
1857/** The sidebar's shortcut, for the hint on its toggle. */
1858function useSidebarKey(): string {
1859 return sidebarKeyLabel(typeof navigator === "undefined" ? null : navigator.platform);
1860}
1861
1862/**
1863 * The app: three surfaces that never blur together. The rail, a narrow
1864 * column of icons down the window's left edge; the mode's sidebar, flat
1865 * against it with a hairline between, which folds away with Ctrl B and is
1866 * a drawer below 1024px; and the page, flat against the sidebar and
1867 * filling the rest of the window, with its top bar across the top and a
1868 * line under it: the sidebar's toggle, where you are, search, the bell and
1869 * Create new. On a phone the rail is a bar along the bottom and the page
1870 * fills the window above it, flat as well. Only for someone signed in; without a workspace yet, there
1871 * is no rail. The rail and the sidebar are drawn from the sidebar kit
1872 * (components/ui/sidebar.tsx): one provider holds whether the sidebar is
1873 * open on a computer and whether the drawer is.
1874 */
1875export function AppShell({
1876 user,
1877 shell,
1878 missing = false,
1879 banner,
1880 sidebarClosed = false,
1881 children,
1882}: {
1883 user: User;
1884 shell: ShellData;
1885 /** The page is a 404 (see CodeSidebar). */
1886 missing?: boolean;
1887 banner?: ReactNode;
1888 /** Whether the person folded the sidebar away, as their cookie says. */
1889 sidebarClosed?: boolean;
1890 children: ReactNode;
1891}) {
1892 const { pathname } = useLocation();
1893 const [drawer, setDrawer] = useState(false);
1894 const [closed, setClosed] = useState(sidebarClosed);
1895 const [palette, setPalette] = useState(false);
1896 const commands = useMemo(() => commandsFor(user, shell), [user, shell]);
1897
1898 // A new page closes the drawer.
1899 useEffect(() => setDrawer(false), [pathname]);
1900 usePaletteShortcut(() => setPalette((open) => !open));
1901 // In the desktop app, search is in the middle of its title bar, as in Slack, and not in the top bar too.
1902 const titleSearch = useTitleBarSearch(`Search ${shell.workspace?.name ?? shell.workspace?.slug ?? "g1t"}`, () => setPalette(true));
1903 const leaving = useLeaving();
1904 useVisualViewport();
1905 const going = useNavigation().location?.pathname;
1906 const ws = shell.workspace;
1907 const mode = modeOf(going ?? pathname, ws?.slug ?? null);
1908 const panel = sidebarFor(mode, ws != null);
1909 const { sidebar: chatSidebar } = useChatSidebar();
1910 // Notify: the feed socket's live counts (lib/notify-client.ts) once it has them; the page's until then.
1911 const live = useLiveBadges(ws?.slug);
1912 const chatUnread = chatSidebar
1913 ? unreadTotals(chatSidebar.entries)
1914 : live?.chat != null
1915 ? { unread: live.chat, mentions: live.mentions ?? 0 }
1916 : (shell.chat ?? { unread: 0, mentions: 0 });
1917 const notificationsUnread = live?.inbox ?? shell.inbox?.unread ?? 0;
1918 const unread = { notifications: notificationsUnread, chat: chatUnread.unread, mentions: chatUnread.mentions };
1919
1920 // Folding the sidebar away on a computer is remembered, so the next page is drawn the same from the server.
1921 const toggleSidebar = useCallback(() => {
1922 if (!window.matchMedia("(min-width: 1024px)").matches) {
1923 setDrawer((open) => !open);
1924 return;
1925 }
1926 setClosed((was) => {
1927 document.cookie = sidebarCookie(!was, window.location.protocol === "https:");
1928 return !was;
1929 });
1930 }, []);
1931 useSidebarShortcut(useCallback(() => {
1932 if (panel) toggleSidebar();
1933 }, [panel, toggleSidebar]));
1934
1935 const inline = panel != null && !closed;
1936 const sidebarNode = () => {
1937 if (!panel) return null;
1938 if (!ws) return panel === "notifications" ? <NotificationsSidebar counts={shell.inbox ?? null} /> : <AccountSidebar username={user.username} />;
1939 switch (panel) {
1940 case "code":
1941 return <CodeSidebar user={user} shell={shell} missing={missing} />;
1942 case "chat":
1943 return <ChatSidebar slug={ws.slug} />;
1944 case "artifacts":
1945 return <FoliosSidebar slug={ws.slug} />;
1946 case "notifications":
1947 return <NotificationsSidebar counts={shell.inbox ?? null} />;
1948 case "people":
1949 return <PeopleSidebar slug={ws.slug} />;
1950 case "workspace":
1951 return <WorkspaceSidebar slug={ws.slug} owner={ws.role === "owner"} />;
1952 case "account":
1953 return <AccountSidebar username={user.username} />;
1954 }
1955 };
1956 const sidebarKey = useSidebarKey();
1957 // Search or jump to sits at the top of the sidebar, except in Chat and
1958 // Artifacts, whose sidebars search their own lists: there it stays in the bar.
1959 const sidebarSearch = panel != null && panel !== "chat" && panel !== "artifacts";
1960 // The sidebar's head: the workspace and its switcher, the way to fold the
1961 // sidebar or close the drawer, and search, which opens the palette.
1962 const sidebarTop = (inDrawer: boolean) => (
1963 <SidebarHeader className="gap-1 px-2 pt-0 pb-2">
1964 <div className="flex h-14 shrink-0 items-center gap-1">
1965 {ws ? (
1966 <WorkspaceSwitcher user={user} workspace={ws} />
1967 ) : (
1968 <Link to="/" aria-label="g1t" className="mr-auto flex h-9 items-center rounded-md px-2">
1969 <Logo className="text-[1.125rem]" />
1970 </Link>
1971 )}
1972 {inDrawer ? (
1973 <Button type="button" aria-label="Close menu" onClick={() => setDrawer(false)} variant="ghost" size="icon-sm" className="text-faint">
1974 <X size={16} />
1975 </Button>
1976 ) : (
1977 <SidebarTrigger hint={`Hide the sidebar (${sidebarKey})`} className="text-faint" />
1978 )}
1979 </div>
1980 {sidebarSearch && <SearchButton place="sidebar" onClick={() => setPalette(true)} />}
1981 </SidebarHeader>
1982 );
1983
1984 // On a phone (below 768px): the bottom bar, and a conversation full screen.
1985 const conversation = isConversation(going ?? pathname);
1986 // Where the page panel starts: 8px past the rail (56px), or 8px past the sidebar (56 + 240px) when it is open.
1987 // The page starts where the rail (3.5rem) and, open, the sidebar (15rem) end.
1988 const pad = ws ? (inline ? "md:pl-14 lg:pl-[18.5rem]" : "md:pl-14") : inline ? "lg:pl-[15rem]" : "";
1989
1990 return (
1991 <SidebarProvider open={!closed} onOpenChange={(open) => setClosed(!open)} openMobile={drawer} onOpenMobileChange={setDrawer} toggleSidebar={toggleSidebar}>
1992 <Progress />
1993 {ws && (
1994 <div className="fixed top-(--frame-top) bottom-0 left-0 z-40 hidden md:block">
1995 <Rail workspace={ws} pins={shell.pins ?? []} unread={unread} account={<AccountMenu user={user} />} />
1996 </div>
1997 )}
1998 {panel && (
1999 <Sidebar
2000 role="complementary"
2001 aria-label={`${MODE_MENU[panel]} sidebar`}
2002 className={`fixed top-(--frame-top) bottom-0 z-40 max-lg:hidden ${ws ? "left-14" : "left-0"}`}
2003 >
2004 {sidebarTop(false)}
2005 <div className="min-h-0 grow">{sidebarNode()}</div>
2006 </Sidebar>
2007 )}
2008 {/* The drawer is a sheet: a dialog that holds focus, closes on Escape or
2009 a tap outside, and gives focus back to the button that opened it. */}
2010 {panel && (
2011 <SidebarMobile title={`${MODE_MENU[panel]} menu`} className="pb-[env(safe-area-inset-bottom)] max-md:[&_nav_a]:min-h-10">
2012 {sidebarTop(true)}
2013 <div className="min-h-0 grow">{sidebarNode()}</div>
2014 </SidebarMobile>
2015 )}
2016
2017 <div className={`min-h-dvh pt-(--frame-top) pb-(--tabbar-h) ${pad}`}>
2018 {/* The top bar always has its line, so a page's own header (data-page-head: a conversation's, a project's,
2019 a sticky one under an open artifact) sits under it as its own band. */}
2020 <div className="flex min-h-[calc(100dvh-var(--frame-top)-var(--tabbar-h))] min-w-0 flex-col bg-bg">
2021 <header
2022 className={`sticky top-(--frame-top) z-30 flex h-14 items-center gap-1 border-b border-line bg-bg pr-2 pl-2 sm:pr-3 ${inline ? "lg:pl-3.5" : ""} ${conversation ? "max-md:hidden" : ""}`}
2023 >
2024 {panel && (
2025 <SidebarTrigger
2026 hint={`Show the sidebar (${sidebarKey})`}
2027 aria-label={drawer ? "Hide the sidebar" : "Show the sidebar"}
2028 aria-expanded={drawer}
2029 className={`max-md:size-11 ${inline ? "lg:hidden" : ""}`}
2030 />
2031 )}
2032 {ws && (
2033 <span className={`flex min-w-0 shrink items-center gap-1.5 ${inline ? "lg:hidden" : ""}`}>
2034 <WorkspaceSwitcher user={user} workspace={ws} compact />
2035 <span aria-hidden="true" className="text-line-strong">
2036 /
2037 </span>
2038 </span>
2039 )}
2040 <Breadcrumbs pathname={pathname} missing={missing} repo={shell.repo} workspace={ws?.slug ?? null} />
2041 {/* Search, then the bell and Create new: one height, one rhythm. */}
2042 <div className="ml-auto flex shrink-0 items-center gap-1 md:gap-1.5">
2043 {/* With the sidebar open, search is at its top. */}
2044 {!titleSearch && (
2045 <span className={`flex ${inline && sidebarSearch ? "lg:hidden" : ""}`}>
2046 <SearchButton place="bar" onClick={() => setPalette(true)} />
2047 </span>
2048 )}
2049 <Separator orientation="vertical" className="mx-1 data-[orientation=vertical]:h-5 max-md:hidden" />
2050 {/* On a phone, Notifications is in the bottom bar. */}
2051 <span className="flex max-md:hidden">
2052 <NotificationsBell counts={shell.inbox ? { ...shell.inbox, unread: notificationsUnread } : null} />
2053 </span>
2054 <CreateMenu shell={shell} />
2055 {/* Without a workspace there is no rail: the account is here. */}
2056 {!ws && <AccountMenu user={user} side="bottom" />}
2057 </div>
2058 </header>
2059 {banner}
2060 <main id="content" tabIndex={-1} {...leaving} className={`min-w-0 grow outline-none ${leaving.className}`}>
2061 <InMain.Provider value={true}>{children}</InMain.Provider>
2062 </main>
2063 </div>
2064 </div>
2065 {ws && <BottomBar user={user} workspace={ws} pins={shell.pins ?? []} unread={unread} onReselect={panel ? () => setDrawer(true) : undefined} />}
2066 <CommandPalette open={palette} onOpenChange={setPalette} commands={commands} repo={shell.repo ? `${shell.repo.namespace}/${shell.repo.name}` : null} />
2067 </SidebarProvider>
2068 );
2069}
2070
2071/** Create new: a project, an issue in the one you are in, a workspace or a team. */
2072function CreateMenu({ shell }: { shell: ShellData }) {
2073 return (
2074 <DropdownMenu>
2075 <Hint label="Create new">
2076 <DropdownMenuTrigger asChild>
2077 <Button variant="ghost" size="bar" aria-label="Create new" className="gap-0.5 px-1.5 text-fg/90">
2078 <Plus size={17} className="max-md:size-5" />
2079 <ChevronDown size={12} className="text-faint max-md:hidden" />
2080 </Button>
2081 </DropdownMenuTrigger>
2082 </Hint>
2083 <DropdownMenuContent align="end" className="min-w-52">
2084 {shell.repo && (
2085 <>
2086 <DropdownMenuLabel className="truncate">In {shell.repo.name}</DropdownMenuLabel>
2087 <DropdownMenuItem asChild>
2088 <Link to={`/${shell.repo.namespace}/${shell.repo.name}/issues/new`}>
2089 <CircleDot />
2090 New issue
2091 </Link>
2092 </DropdownMenuItem>
2093 <DropdownMenuSeparator />
2094 </>
2095 )}
2096 <DropdownMenuItem asChild>
2097 <Link to="/new">
2098 <Box />
2099 New project
2100 </Link>
2101 </DropdownMenuItem>
2102 <DropdownMenuItem asChild>
2103 <Link to="/new/github">
2104 <GitBranch />
2105 Import from GitHub
2106 </Link>
2107 </DropdownMenuItem>
2108 {/* A team in the workspace you are in, for whoever it lets create one. A new workspace is made from the workspace switcher in the rail. */}
2109 {shell.workspace && <DropdownMenuSeparator />}
2110 {shell.workspace &&
2111 (mayCreateTeams(shell.workspace.team_creation, shell.workspace.role) ? (
2112 <DropdownMenuItem asChild>
2113 <Link to={`/${shell.workspace.slug}/-/teams/new`}>
2114 <UsersRound />
2115 New team
2116 </Link>
2117 </DropdownMenuItem>
2118 ) : (
2119 <DropdownMenuItem disabled>
2120 <UsersRound />
2121 New team
2122 <span className="ml-auto pl-3 text-xs text-faint">Owners only</span>
2123 </DropdownMenuItem>
2124 ))}
2125 </DropdownMenuContent>
2126 </DropdownMenu>
2127 );
2128}