Skip to content

The Open Standard for Generative UI

docs: home install-command dropdown + static downloads stat (#705)

Parikshit Deshmukha249083953ae
diff --git a/docs/app/(home)/sections/HeroSection/HeroSection.module.css b/docs/app/(home)/sections/HeroSection/HeroSection.module.css
index 5ad0adf28..4f74d9a06 100644
--- a/docs/app/(home)/sections/HeroSection/HeroSection.module.css
+++ b/docs/app/(home)/sections/HeroSection/HeroSection.module.css
@@ -310,6 +310,230 @@
color: var(--openui-text-neutral-primary);
}
+/* ── Command dropdown button (isolated pill + sliding-highlight dropdown) ── */
+
+/* Isolated wrapper + trigger, so restyling never affects other buttons. The
+ width/padding tokens keep the trigger, the rows, and the sliding highlight in
+ exact lockstep. */
+.commandDropdown {
+ --cmd-width: 26.75rem;
+ --cmd-pad: 0.375rem;
+ --cmd-stride: 3.125rem;
+ position: relative;
+ z-index: 20;
+ display: inline-block;
+ width: max-content;
+ max-width: 100%;
+}
+
+.commandTrigger {
+ display: flex;
+ height: 3rem;
+ /* Row width, so the first row overlaps the trigger exactly. */
+ min-width: var(--cmd-width);
+ align-items: center;
+ justify-content: space-between;
+ gap: 0.625rem;
+ padding-left: 1.25rem;
+ padding-right: 0.5rem;
+ border: 1px solid rgba(0, 0, 0, 0.08);
+ border-radius: var(--openui-radius-full);
+ background: var(--home-surface-raised);
+ box-shadow: var(--home-bevel);
+ white-space: nowrap;
+ cursor: pointer;
+ transition: opacity 0.18s ease;
+}
+
+[data-theme="dark"] .commandTrigger {
+ border-color: rgba(255, 255, 255, 0.1);
+ background: var(--home-surface-ink);
+ box-shadow: var(--home-bevel-on-dark);
+}
+
+/* While open the first row sits exactly on the trigger; hide the trigger so the
+ two never ghost and the button appears to become the menu. */
+.commandDropdownOpen .commandTrigger {
+ opacity: 0;
+ pointer-events: none;
+}
+
+.commandTriggerLabel {
+ font-family: var(--font-geist-mono);
+ font-size: 1rem;
+ white-space: nowrap;
+ color: var(--openui-text-neutral-primary);
+}
+
+.commandTriggerRunner {
+ font-weight: 600;
+}
+
+/* Filled copy chip on the trigger. */
+.commandTriggerBadge {
+ display: inline-flex;
+ align-items: center;
+ justify-content: center;
+ flex-shrink: 0;
+ width: 2rem;
+ height: 2rem;
+ border-radius: var(--openui-radius-full);
+ background: var(--openui-inverted-background);
+ color: var(--openui-background);
+}
+
+/* Dropdown. Shifted up + left by the padding + border, so the first row lands
+ exactly on the trigger while the card's padding sits outside it. Fades only
+ (no slide/scale), so the overlap holds and the text never re-rasterises. */
+.commandMenu {
+ position: absolute;
+ top: calc(-1 * (var(--cmd-pad) + 1px));
+ left: calc(-1 * (var(--cmd-pad) + 1px));
+ width: calc(var(--cmd-width) + 2 * var(--cmd-pad) + 2px);
+ z-index: 60;
+ opacity: 0;
+ visibility: hidden;
+ pointer-events: none;
+ transition:
+ opacity 0.18s ease,
+ visibility 0s linear 0.18s;
+}
+
+.commandMenuOpen {
+ opacity: 1;
+ visibility: visible;
+ pointer-events: auto;
+ transition:
+ opacity 0.18s ease,
+ visibility 0s;
+}
+
+/* White container; its padding sits outside the rows. Positioned so the sliding
+ highlight can be placed against it. */
+.commandMenuCard {
+ position: relative;
+ display: flex;
+ flex-direction: column;
+ gap: 0.125rem;
+ width: 100%;
+ padding: var(--cmd-pad);
+ border: 1px solid var(--openui-border-default);
+ /* Row-pill radius (1.5rem) + the padding, so the container's corners run
+ concentric with the rows inside. */
+ border-radius: 1.875rem;
+ background: var(--openui-foreground);
+ box-shadow: var(--openui-shadow-l);
+}
+
+/* A single highlight pill that slides between rows, so the hover glides instead
+ of popping. It sits behind the rows, so their text and chip never move. */
+.commandMenuHighlight {
+ position: absolute;
+ top: var(--cmd-pad);
+ left: var(--cmd-pad);
+ z-index: 0;
+ width: var(--cmd-width);
+ height: 3rem;
+ border: 1px solid rgba(0, 0, 0, 0.08);
+ border-radius: var(--openui-radius-full);
+ background: var(--home-surface-raised);
+ box-shadow: var(--home-bevel);
+ opacity: 0;
+ transition:
+ transform 0.24s cubic-bezier(0.22, 1, 0.36, 1),
+ opacity 0.15s ease;
+}
+
+[data-theme="dark"] .commandMenuHighlight {
+ border-color: rgba(255, 255, 255, 0.1);
+ background: var(--home-surface-ink);
+ box-shadow: var(--home-bevel-on-dark);
+}
+
+.commandMenuCard:has(.commandMenuItem:nth-of-type(1):hover) .commandMenuHighlight {
+ opacity: 1;
+ transform: translateY(0);
+}
+.commandMenuCard:has(.commandMenuItem:nth-of-type(2):hover) .commandMenuHighlight {
+ opacity: 1;
+ transform: translateY(var(--cmd-stride));
+}
+.commandMenuCard:has(.commandMenuItem:nth-of-type(3):hover) .commandMenuHighlight {
+ opacity: 1;
+ transform: translateY(calc(2 * var(--cmd-stride)));
+}
+.commandMenuCard:has(.commandMenuItem:nth-of-type(4):hover) .commandMenuHighlight {
+ opacity: 1;
+ transform: translateY(calc(3 * var(--cmd-stride)));
+}
+
+@media (prefers-reduced-motion: reduce) {
+ .commandMenuHighlight {
+ transition: opacity 0.15s ease;
+ }
+}
+
+/* Rows share the trigger's exact insets, so every copy chip lines up with the
+ trigger's badge. Transparent + above the highlight, which glides behind. */
+.commandMenuItem {
+ position: relative;
+ z-index: 1;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 0.5rem;
+ width: 100%;
+ height: 3rem;
+ padding: 0 0.5rem 0 1.25rem;
+ /* Transparent border matching the trigger's, so the text + chip sit at the
+ exact same inset and don't shift a pixel when the menu opens. */
+ border: 1px solid transparent;
+ border-radius: var(--openui-radius-full);
+ background: transparent;
+ color: var(--openui-text-neutral-primary);
+ font-family: var(--font-geist-mono);
+ font-size: 1rem;
+ line-height: 1.5rem;
+ white-space: nowrap;
+ cursor: pointer;
+}
+
+.commandMenuItemLabel {
+ overflow: hidden;
+ text-overflow: ellipsis;
+ /* Own layer, so the highlight gliding behind never re-rasterises the text. */
+ transform: translateZ(0);
+}
+
+.commandMenuItemRunner {
+ font-weight: 600;
+ color: var(--openui-text-neutral-primary);
+}
+
+/* Copy chip: hidden until the row is hovered (space reserved so nothing shifts),
+ then filled like the trigger's badge. */
+.commandMenuItemIcon {
+ display: inline-flex;
+ align-items: center;
+ justify-content: center;
+ flex-shrink: 0;
+ width: 2rem;
+ height: 2rem;
+ border-radius: var(--openui-radius-full);
+ background: transparent;
+ color: var(--openui-text-neutral-secondary);
+ opacity: 0;
+ transition: opacity 0.12s ease;
+ /* Own compositing layer so fading in doesn't nudge the chip a sub-pixel. */
+ transform: translateZ(0);
+}
+
+.commandMenuItem:hover .commandMenuItemIcon {
+ opacity: 1;
+ background: var(--openui-inverted-background);
+ color: var(--openui-background);
+}
+
/* ── CTA pill buttons (shared base) ── */
.desktopPlaygroundButton,
diff --git a/docs/app/(home)/sections/HeroSection/HeroSection.tsx b/docs/app/(home)/sections/HeroSection/HeroSection.tsx
index 8109a899f..530c720be 100644
--- a/docs/app/(home)/sections/HeroSection/HeroSection.tsx
+++ b/docs/app/(home)/sections/HeroSection/HeroSection.tsx
@@ -14,9 +14,32 @@ import styles from "./HeroSection.module.css";
export const heroStyles = styles;
// CTAs
-const primaryCTA = "npx @openuidev/cli@latest create";
+const primaryCTA = "pnpx @openuidev/cli@latest create";
const secondaryCTA = "Try Playground";
const openclawOsHref = "/openclaw-os";
+
+// Package-manager runners for the desktop install-command dropdown. The pill
+// copies pnpm (pnpx) by default; hovering reveals the same command for bun,
+// yarn, and npm. Order matches the menu (pnpm, bun, yarn, npm).
+const COMMAND_RUNNERS = [
+ { id: "pnpm", prefix: "pnpx" },
+ { id: "bun", prefix: "bunx" },
+ { id: "yarn", prefix: "yarn dlx" },
+ { id: "npm", prefix: "npx" },
+] as const;
+
+type CommandVariant = { id: string; command: string; runner: string };
+
+// Rewrites a runner command (`pnpx <spec>`, `npx <spec>`, ...) into one row per
+// package-manager runner. Returns [] when no known runner prefix matches, so the
+// dropdown only appears where it fits. `runner` is the prefix rendered in bold.
+function commandVariants(command: string): CommandVariant[] {
+ const runner = COMMAND_RUNNERS.find(({ prefix }) => command.startsWith(`${prefix} `));
+ if (!runner) return [];
+ const spec = command.slice(runner.prefix.length + 1);
+ return COMMAND_RUNNERS.map(({ id, prefix }) => ({ id, command: `${prefix} ${spec}`, runner: prefix }));
+}
+
const DESKTOP_HERO_IMAGE = {
light: "/homepage/hero-web.svg",
dark: "/homepage/hero-web-dark.svg",
@@ -96,6 +119,66 @@ export function NpmButton({ className = "", command }: { className?: string; com
);
}
+// A command pill that reveals a dropdown of package-manager variants on hover or
+// focus. Clicking the trigger or any row copies that command and closes the
+// menu. Fully isolated (`.command*` classes), so it affects no other button.
+function CommandDropdownButton({
+ command,
+ variants,
+}: {
+ command: string;
+ variants: CommandVariant[];
+}) {
+ const [open, setOpen] = useState(false);
+ const runner =
+ COMMAND_RUNNERS.find(({ prefix }) => command.startsWith(`${prefix} `))?.prefix ?? "";
+
+ return (
+ <div
+ className={`${styles.commandDropdown} ${open ? styles.commandDropdownOpen : ""}`.trim()}
+ // Hover-controlled only: copying can briefly move focus, so a focus/blur
+ // close would shut the menu on click. Mouse-leave is the sole close.
+ onMouseEnter={() => setOpen(true)}
+ onMouseLeave={() => setOpen(false)}
+ >
+ <ClipboardCommandButton
+ command={command}
+ className={styles.commandTrigger}
+ iconContainerClassName={styles.commandTriggerBadge}
+ copyIconColor="currentColor"
+ >
+ <span className={styles.commandTriggerLabel}>
+ <span className={styles.commandTriggerRunner}>{runner}</span>
+ {command.slice(runner.length)}
+ </span>
+ </ClipboardCommandButton>
+ <div className={`${styles.commandMenu} ${open ? styles.commandMenuOpen : ""}`.trim()}>
+ <div
+ className={styles.commandMenuCard}
+ role="menu"
+ aria-label="Copy the install command for another package manager"
+ >
+ <div className={styles.commandMenuHighlight} aria-hidden="true" />
+ {variants.map((variant) => (
+ <ClipboardCommandButton
+ key={variant.id}
+ command={variant.command}
+ className={styles.commandMenuItem}
+ iconContainerClassName={styles.commandMenuItemIcon}
+ copyIconColor="currentColor"
+ >
+ <span className={styles.commandMenuItemLabel}>
+ <span className={styles.commandMenuItemRunner}>{variant.runner}</span>
+ {variant.command.slice(variant.runner.length)}
+ </span>
+ </ClipboardCommandButton>
+ ))}
+ </div>
+ </div>
+ </div>
+ );
+}
+
type CommandPlatform = "macos" | "linux" | "windows";
function CommandTabs({
@@ -282,7 +365,11 @@ function DesktopHero({
commandSlot
) : (
<div className={styles.commandItem}>
- <NpmButton command={command} />
+ {commandVariants(command).length > 0 ? (
+ <CommandDropdownButton command={command} variants={commandVariants(command)} />
+ ) : (
+ <NpmButton command={command} />
+ )}
</div>
)}
</div>
diff --git a/docs/app/(home)/sections/TweetWallSection/TweetWallStats.tsx b/docs/app/(home)/sections/TweetWallSection/TweetWallStats.tsx
index 684896769..0fe5cad06 100644
--- a/docs/app/(home)/sections/TweetWallSection/TweetWallStats.tsx
+++ b/docs/app/(home)/sections/TweetWallSection/TweetWallStats.tsx
@@ -1,42 +1,13 @@
"use client";
-import { useEffect, useState } from "react";
import { GitHubMark, useGitHubStars } from "../../components/GitHubButton/GitHubButton";
import styles from "./TweetWallSection.module.css";
const GITHUB_REPO = "thesysdev/openui";
-// Package whose monthly npm downloads are shown as the npm stat.
-const NPM_PACKAGE = "@openuidev/lang-core";
-
-function useNpmMonthlyDownloads(pkg: string): number | null {
- const [count, setCount] = useState<number | null>(null);
- useEffect(() => {
- let cancelled = false;
- fetch(`https://api.npmjs.org/downloads/point/last-month/${pkg}`)
- .then((res) => (res.ok ? res.json() : null))
- .then((data) => {
- if (!cancelled && typeof data?.downloads === "number") {
- setCount(data.downloads);
- }
- })
- .catch(() => {});
- return () => {
- cancelled = true;
- };
- }, [pkg]);
- return count;
-}
-
function NpmMark() {
return (
- <svg
- viewBox="0 7 24 10"
- width="36"
- height="15"
- fill="currentColor"
- aria-hidden="true"
- >
+ <svg viewBox="0 7 24 10" width="36" height="15" fill="currentColor" aria-hidden="true">
<path d="M0 7.334v8h6.666v1.332H12v-1.332h12v-8H0zm6.666 6.664H5.334v-4H3.999v4H1.335V8.667h5.331v5.331zm4 0v1.336H8.001V8.667h5.334v5.332h-2.669v-.001zm12.001 0h-1.33v-4h-1.336v4h-1.335v-4h-1.33v4h-2.671V8.667h8.002v5.331zM10.665 10H12v2.667h-1.335V10z" />
</svg>
);
@@ -44,7 +15,6 @@ function NpmMark() {
export function TweetWallStats() {
const stars = useGitHubStars(GITHUB_REPO);
- const downloads = useNpmMonthlyDownloads(NPM_PACKAGE);
return (
<div className={styles.stats}>
@@ -55,10 +25,8 @@ export function TweetWallStats() {
</span>
<span className={styles.statChip}>
<NpmMark />
- <span className={styles.statNumber}>
- {(downloads ?? 0).toLocaleString()}
- </span>
- <span className={styles.statLabel}>monthly downloads</span>
+ <span className={styles.statNumber}>1 Million+</span>
+ <span className={styles.statLabel}>downloads across all packages</span>
</span>
</div>
);