"use client"; import { ExternalLink } from "lucide-react"; import { motion } from "motion/react"; import { useEffect, useMemo, useState } from "react"; import { Card, CardContent, CardTitle } from "@/components/ui/card"; import { Skeleton } from "@/components/ui/skeleton"; import { Tooltip, TooltipContent, TooltipTrigger, } from "@/components/ui/tooltip"; interface Contributor { id: number; login: string; avatar_url: string; html_url: string; contributions: number; } interface GitHubContributorsProps { repo: string; // e.g. "vercel/next.js" limit?: number; // number of avatars to show (not counting the +more tile) className?: string; token?: string; // optional GitHub token to increase rate limit } export function GitHubContributors({ repo, limit = 12, className = "", token, }: GitHubContributorsProps) { const [contributors, setContributors] = useState([]); const [loading, setLoading] = useState(true); const [error, setError] = useState(null); const [totalCount, setTotalCount] = useState(null); useEffect(() => { if (!repo) return; setLoading(true); setError(null); setTotalCount(null); const headers: Record = { Accept: "application/vnd.github.v3+json", }; if (token) headers.Authorization = `token ${token}`; const fetchList = async () => { try { const listRes = await fetch( `https://api.github.com/repos/${repo}/contributors?per_page=${limit}`, { headers }, ); if (!listRes.ok) throw new Error( `GitHub API: ${listRes.status} ${listRes.statusText}`, ); const listData: Contributor[] = await listRes.json(); setContributors(listData.slice(0, limit)); // Probe for total contributors (per_page=1 -> last page = total count) try { const probeRes = await fetch( `https://api.github.com/repos/${repo}/contributors?per_page=1`, { headers }, ); if (probeRes.ok) { const link = probeRes.headers.get("link"); if (link) { const m = link.match( /<[^>]+[?&]page=(\d+)[^>]*>\s*;\s*rel="last"/, ); if (m?.[1]) { const lastPage = parseInt(m[1], 10); if (Number.isFinite(lastPage)) setTotalCount(lastPage); } } else { const probeData = await probeRes.json(); if (Array.isArray(probeData)) setTotalCount(probeData.length); } } } catch { // ignore probe errors } } catch (err: unknown) { setError((err as Error).message || "Failed to load contributors"); setContributors([]); } finally { setLoading(false); } }; fetchList(); }, [repo, limit, token]); const shown = contributors.length; const remaining = totalCount !== null ? Math.max(0, totalCount - shown) : null; // compute max contributions among shown contributors to render the progress bar const maxContrib = useMemo(() => { if (!contributors || contributors.length === 0) return 1; return Math.max(...contributors.map((c) => c.contributions), 1); }, [contributors]); const repoUrl = `https://github.com/${repo}`; const contributorsUrl = `${repoUrl}/graphs/contributors`; return ( {/* Content */} {error && (

Failed: {error}

)} {loading ? (

{Array.from({ length: limit }).map((_, i) => (

))}

) : (

{contributors.map((c, idx) => { const pct = Math.round((c.contributions / maxContrib) * 100); const isTop = idx === 0; // highlight the top contributor in shown list return (

{/* top badge */} {isTop && (

★

)} e.stopPropagation()} aria-label={`${c.login} GitHub profile`} > {/* biome-ignore lint/performance/noImgElement: next/image causes ESM issues with fumadocs-mdx */}

{/* subtle ring on hover via pseudo element class; already handled by tailwind tokens */}

)} {/* Footer CTA */}

{repo}

{loading ? ( Loading… ) : error ? ( Failed to load ) : ( Showing {shown} {totalCount ? ( <> {" "} of {totalCount} ) : shown === limit ? ( <> (more) ) : null} )}

Open repo

); }