Introducing Nuvyx UI v1.0.0

Docs
GitHub Repo Card

GitHub Repo Card

Beautiful GitHub repository cards with customizable themes, activity graphs, and real-time data fetching.

shadcn's avatar

shadcn-ui

Public

Beautifully designed components built with Radix UI and Tailwind CSS.
ActivityUpdated 1 month ago
42,000
3,600
1,600
310
TypeScript

ui

components

+2 more

Installation

Examples

Retro Theme

microsoft's avatar

vscode

Public

Visual Studio Code is a code editor redefined and optimized for building and debugging modern web and cloud applications.
ActivityUpdated 2 months ago
145,000
25,600
3,100
7,800
TypeScript

editor

ide

+2 more

Midnight Theme

tailwindlabs's avatar

tailwindcss

Public

A utility-first CSS framework for rapid UI development.
ActivityUpdated 2 months ago
68,000
3,500
1,800
95
JavaScript

css

framework

+2 more

Usage

import { GitHubRepoCard } from "@/components/ui/github-repo-card";
// Using API mode with GitHub token (recommended)
export default function MyComponent() {
  const token = process.env.GITHUB_TOKEN;
  return (
    <div className="w-full max-w-md mx-auto">
      <GitHubRepoCard
        repoOwner="shadcn-ui"
        repoName="ui"
        themeId="modern-dark"
        githubToken={token}
      />
    </div>
  );
}
 
// Using manual mode with provided data
export function ManualExample() {
  return (
    <div className="w-full max-w-md mx-auto">
      <GitHubRepoCard
        manualMode={true}
        themeId="retro"
        repoData={{
          name: "tailwindcss",
          fullName: "tailwindlabs/tailwindcss",
          description:
            "A utility-first CSS framework for rapid UI development.",
          owner: {
            login: "tailwindlabs",
            avatarUrl: "https://avatars.githubusercontent.com/u/67109815?v=4",
          },
          stars: 68000,
          forks: 3500,
          watchers: 1800,
          issues: 95,
          language: "JavaScript",
          languageColor: "#f1e05a",
          updatedAt: "2025-04-02T08:15:43Z",
          topics: ["css", "framework", "design", "frontend"],
          activityData: [
            0.5, 0.6, 0.4, 0.5, 0.7, 0.8, 0.9, 1.0, 0.8, 0.6, 0.7, 0.8,
          ],
          isPrivate: false,
        }}
      />
    </div>
  );
}

Props

GitHub Repo Card

PropTypeDefaultDescription
repoOwnerstringundefinedGitHub username or organization name that owns the repository. Required when not using manualMode.
repoNamestringundefinedName of the GitHub repository. Required when not using manualMode.
githubTokenstringundefinedOptional GitHub API token for increased rate limits (unauthenticated: 60/hr, authenticated: 5,000/hr). Store securely using environment variables.
manualModebooleanfalseWhen true, uses provided repoData instead of fetching from GitHub API. Useful for avoiding rate limits or displaying custom repository data.
repoDataManualRepoDataundefinedRepository data object for manual mode. Required when manualMode is true. Includes fields for repository name, stars, forks, language, etc.
themeIdstring"modern-light"Visual theme for the card. Options: modern-dark, modern-light, retro, midnight. Some themes support automatic light/dark mode switching.

ManualRepoData Type

PropertyTypeDefaultDescription
namestring""Repository name (e.g., 'next.js').
fullNamestring""Full repository name with owner (e.g., 'vercel/next.js').
descriptionstring""Repository description (optional).
ownerobject{ login: '', avatarUrl: '' }Repository owner with login (username) and avatarUrl properties.
starsnumber0Number of repository stars.
forksnumber0Number of repository forks.
watchersnumber0Number of repository watchers.
issuesnumber0Number of open issues in the repository.
languagestringundefinedPrimary programming language used in the repository (optional).
languageColorstringundefinedHex color code for the language indicator (optional, defaults to standard GitHub language colors).
updatedAtstring""ISO date string of when the repository was last updated.
topicsstring[][]Array of repository topics/tags to display on the card.
activityDatanumber[]undefinedArray of 12 normalized values (0-1) representing repository commit activity for the graph display.
isPrivatebooleanfalseWhether the repository is private (displays badge on card).