The Open Standard for Generative UI
import { ArrowUpRight } from "lucide-react";
import Link from "next/link";
import styles from "./showcase.module.css";
export type CardLinkItem = { label: string; href: string; external?: boolean };
/** A card with a light/dark screenshot, used for featured projects and demos. */
export type ShowcaseItem = {
name: string;
tagline: string;
description: string;
image?: { light: string; dark: string };
links: CardLinkItem[];
};
/** A text-only card, used for community projects, chat conversations, and tools. */
export type LinkCardItem = {
name: string;
description: string;
tag?: string;
links: CardLinkItem[];
};
/* The link a whole card opens: the demo or website when there is one, else the
first link (usually GitHub). */
function primaryIndex(links: CardLinkItem[]) {
const site = links.findIndex(
(link) => !/github/i.test(link.label) && !/github\.com/.test(link.href),
);
return site >= 0 ? site : 0;
}
export function CardLink({
label,
href,
external,
stretched = false,
}: CardLinkItem & { stretched?: boolean }) {
// A stretched link's hit area covers the whole card (see .cardStretch).
const className = stretched ? `${styles.cardLink} ${styles.cardStretch}` : styles.cardLink;
if (external) {
return (
<a className={className} href={href} target="_blank" rel="noopener noreferrer">
{label}
<ArrowUpRight aria-hidden className={styles.cardLinkIcon} />
</a>
);
}
return (
<Link className={className} href={href}>
{label}
</Link>
);
}
export function ShowcaseGrid({
items,
clickable = false,
}: {
items: ShowcaseItem[];
/* Make the whole card open its main link, not just the link text. */
clickable?: boolean;
}) {
return (
<div className={styles.featuredGrid}>
{items.map((item) => (
<article
key={item.name}
className={`${styles.featuredCard} ${clickable ? styles.cardClickable : ""}`.trim()}
>
{item.image && (
<div className={styles.featuredMedia}>
{/* eslint-disable-next-line @next/next/no-img-element */}
<img
className={styles.imageLight}
src={item.image.light}
alt={item.name}
loading="lazy"
/>
{/* eslint-disable-next-line @next/next/no-img-element */}
<img
className={styles.imageDark}
src={item.image.dark}
alt={item.name}
loading="lazy"
/>
</div>
)}
<div className={styles.featuredBody}>
<span className={styles.eyebrow}>{item.tagline}</span>
<h3 className={styles.cardTitle}>{item.name}</h3>
<p className={styles.cardDescription}>{item.description}</p>
<div className={styles.cardLinks}>
{item.links.map((link, i) => (
<CardLink
key={link.label}
{...link}
stretched={clickable && i === primaryIndex(item.links)}
/>
))}
</div>
</div>
</article>
))}
</div>
);
}
export function LinkCardGrid({
items,
clickable = false,
}: {
items: LinkCardItem[];
/* Make the whole card open its main link, not just the link text. */
clickable?: boolean;
}) {
return (
<div className={styles.grid}>
{items.map((item) => (
<article
key={item.name}
className={`${styles.card} ${clickable ? styles.cardClickable : ""}`.trim()}
>
<div className={styles.cardHeader}>
<h4 className={styles.cardTitle}>{item.name}</h4>
{item.tag ? <span className={styles.tag}>{item.tag}</span> : null}
</div>
<p className={styles.cardDescription}>{item.description}</p>
<div className={styles.cardLinks}>
{item.links.map((link, i) => (
<CardLink
key={link.label}
{...link}
stretched={clickable && i === primaryIndex(item.links)}
/>
))}
</div>
</article>
))}
</div>
);
}