GitHub Stars
Inertial fly-through of a repo's stargazers with a synced count-up odometer that locks on the total. Horizontal 16:9 or vertical 9:16.
Source
components/kuchi/github-stars.tsx
1"use client";23import { loadFont as loadMono } from "@remotion/google-fonts/GeistMono";4import { loadFont as loadSans } from "@remotion/google-fonts/Manrope";5import { format, parseISO } from "date-fns";6import { memo, useMemo, useState } from "react";7import {8 AbsoluteFill,9 Easing,10 Img,11 interpolate,12 useCurrentFrame,13 useVideoConfig,14} from "remotion";15import { Odometer } from "@/components/kuchi/number-wheel";1617export interface Stargazer {18 login: string;19 avatarUrl: string;20 /** ISO date string, e.g. "2021-03-04" */21 starredAt: string;22}2324export interface GitHubStarsProps {25 repo?: string;26 totalStars?: number;27 stargazers?: Stargazer[];28 orientation?: "horizontal" | "vertical";29 accentColor?: string;30 speed?: number;31 theme?: "light" | "dark";32 repoAvatarUrl?: string;33}3435/**36 * Built-in mock stargazers so the composition renders immediately from defaults37 * (own-your-code: no external data needed after `shadcn add`). Real low-id GitHub38 * avatar URLs are CORS-ok, so the docs preview shows round photos.39 */40const RAW_SAMPLE_STARGAZERS: Stargazer[] = [41 {42 login: "maya-dev",43 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-01.svg",44 starredAt: "2021-03-04",45 },46 {47 login: "leo-builds",48 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-02.svg",49 starredAt: "2021-06-12",50 },51 {52 login: "priya-r",53 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-03.svg",54 starredAt: "2021-09-21",55 },56 {57 login: "sam-ships",58 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-04.svg",59 starredAt: "2021-12-08",60 },61 {62 login: "noor-k",63 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-05.svg",64 starredAt: "2022-03-17",65 },66 {67 login: "ivan-ui",68 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-06.svg",69 starredAt: "2022-06-29",70 },71 {72 login: "chen-codes",73 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-07.svg",74 starredAt: "2022-09-14",75 },76 {77 login: "ana-motion",78 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-08.svg",79 starredAt: "2022-12-23",80 },81 {82 login: "omar-labs",83 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-09.svg",84 starredAt: "2023-03-09",85 },86 {87 login: "julia-ux",88 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-10.svg",89 starredAt: "2023-07-19",90 },91 {92 login: "kai-frames",93 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-11.svg",94 starredAt: "2023-11-02",95 },96 {97 login: "zoe-type",98 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-12.svg",99 starredAt: "2024-02-15",100 },101 {102 login: "maya-dev",103 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-13.svg",104 starredAt: "2021-03-04",105 },106 {107 login: "leo-builds",108 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-14.svg",109 starredAt: "2021-06-12",110 },111 {112 login: "priya-r",113 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-15.svg",114 starredAt: "2021-09-21",115 },116 {117 login: "sam-ships",118 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-16.svg",119 starredAt: "2021-12-08",120 },121 {122 login: "noor-k",123 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-17.svg",124 starredAt: "2022-03-17",125 },126 {127 login: "ivan-ui",128 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-18.svg",129 starredAt: "2022-06-29",130 },131 {132 login: "chen-codes",133 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-01.svg",134 starredAt: "2022-09-14",135 },136 {137 login: "ana-motion",138 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-02.svg",139 starredAt: "2022-12-23",140 },141 {142 login: "omar-labs",143 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-03.svg",144 starredAt: "2023-03-09",145 },146 {147 login: "julia-ux",148 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-04.svg",149 starredAt: "2023-07-19",150 },151 {152 login: "kai-frames",153 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-05.svg",154 starredAt: "2023-11-02",155 },156 {157 login: "zoe-type",158 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-06.svg",159 starredAt: "2024-02-15",160 },161 {162 login: "maya-dev",163 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-07.svg",164 starredAt: "2021-03-04",165 },166 {167 login: "leo-builds",168 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-08.svg",169 starredAt: "2021-06-12",170 },171 {172 login: "priya-r",173 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-09.svg",174 starredAt: "2021-09-21",175 },176 {177 login: "sam-ships",178 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-10.svg",179 starredAt: "2021-12-08",180 },181 {182 login: "noor-k",183 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-11.svg",184 starredAt: "2022-03-17",185 },186 {187 login: "ivan-ui",188 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-12.svg",189 starredAt: "2022-06-29",190 },191 {192 login: "chen-codes",193 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-13.svg",194 starredAt: "2022-09-14",195 },196 {197 login: "ana-motion",198 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-14.svg",199 starredAt: "2022-12-23",200 },201 {202 login: "omar-labs",203 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-15.svg",204 starredAt: "2023-03-09",205 },206 {207 login: "julia-ux",208 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-16.svg",209 starredAt: "2023-07-19",210 },211 {212 login: "kai-frames",213 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-17.svg",214 starredAt: "2023-11-02",215 },216 {217 login: "zoe-type",218 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-18.svg",219 starredAt: "2024-02-15",220 },221 {222 login: "maya-dev",223 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-01.svg",224 starredAt: "2021-03-04",225 },226 {227 login: "leo-builds",228 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-02.svg",229 starredAt: "2021-06-12",230 },231 {232 login: "priya-r",233 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-03.svg",234 starredAt: "2021-09-21",235 },236 {237 login: "sam-ships",238 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-04.svg",239 starredAt: "2021-12-08",240 },241 {242 login: "noor-k",243 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-05.svg",244 starredAt: "2022-03-17",245 },246 {247 login: "ivan-ui",248 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-06.svg",249 starredAt: "2022-06-29",250 },251 {252 login: "chen-codes",253 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-07.svg",254 starredAt: "2022-09-14",255 },256 {257 login: "ana-motion",258 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-08.svg",259 starredAt: "2022-12-23",260 },261 {262 login: "omar-labs",263 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-09.svg",264 starredAt: "2023-03-09",265 },266 {267 login: "julia-ux",268 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-10.svg",269 starredAt: "2023-07-19",270 },271 {272 login: "kai-frames",273 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-11.svg",274 starredAt: "2023-11-02",275 },276 {277 login: "zoe-type",278 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-12.svg",279 starredAt: "2024-02-15",280 },281 {282 login: "maya-dev",283 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-13.svg",284 starredAt: "2021-03-04",285 },286 {287 login: "leo-builds",288 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-14.svg",289 starredAt: "2021-06-12",290 },291 {292 login: "priya-r",293 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-15.svg",294 starredAt: "2021-09-21",295 },296 {297 login: "sam-ships",298 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-16.svg",299 starredAt: "2021-12-08",300 },301 {302 login: "noor-k",303 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-17.svg",304 starredAt: "2022-03-17",305 },306 {307 login: "ivan-ui",308 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-18.svg",309 starredAt: "2022-06-29",310 },311 {312 login: "chen-codes",313 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-01.svg",314 starredAt: "2022-09-14",315 },316 {317 login: "ana-motion",318 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-02.svg",319 starredAt: "2022-12-23",320 },321 {322 login: "omar-labs",323 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-03.svg",324 starredAt: "2023-03-09",325 },326 {327 login: "julia-ux",328 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-04.svg",329 starredAt: "2023-07-19",330 },331 {332 login: "kai-frames",333 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-05.svg",334 starredAt: "2023-11-02",335 },336 {337 login: "zoe-type",338 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-06.svg",339 starredAt: "2024-02-15",340 },341 {342 login: "maya-dev",343 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-07.svg",344 starredAt: "2021-03-04",345 },346 {347 login: "leo-builds",348 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-08.svg",349 starredAt: "2021-06-12",350 },351 {352 login: "priya-r",353 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-09.svg",354 starredAt: "2021-09-21",355 },356 {357 login: "sam-ships",358 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-10.svg",359 starredAt: "2021-12-08",360 },361 {362 login: "noor-k",363 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-11.svg",364 starredAt: "2022-03-17",365 },366 {367 login: "ivan-ui",368 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-12.svg",369 starredAt: "2022-06-29",370 },371 {372 login: "chen-codes",373 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-13.svg",374 starredAt: "2022-09-14",375 },376 {377 login: "ana-motion",378 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-14.svg",379 starredAt: "2022-12-23",380 },381 {382 login: "omar-labs",383 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-15.svg",384 starredAt: "2023-03-09",385 },386 {387 login: "julia-ux",388 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-16.svg",389 starredAt: "2023-07-19",390 },391 {392 login: "kai-frames",393 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-17.svg",394 starredAt: "2023-11-02",395 },396 {397 login: "zoe-type",398 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-18.svg",399 starredAt: "2024-02-15",400 },401 {402 login: "maya-dev",403 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-01.svg",404 starredAt: "2021-03-04",405 },406 {407 login: "leo-builds",408 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-02.svg",409 starredAt: "2021-06-12",410 },411 {412 login: "priya-r",413 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-03.svg",414 starredAt: "2021-09-21",415 },416 {417 login: "sam-ships",418 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-04.svg",419 starredAt: "2021-12-08",420 },421 {422 login: "noor-k",423 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-05.svg",424 starredAt: "2022-03-17",425 },426 {427 login: "ivan-ui",428 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-06.svg",429 starredAt: "2022-06-29",430 },431 {432 login: "chen-codes",433 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-07.svg",434 starredAt: "2022-09-14",435 },436 {437 login: "ana-motion",438 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-08.svg",439 starredAt: "2022-12-23",440 },441 {442 login: "omar-labs",443 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-09.svg",444 starredAt: "2023-03-09",445 },446 {447 login: "julia-ux",448 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-10.svg",449 starredAt: "2023-07-19",450 },451 {452 login: "kai-frames",453 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-11.svg",454 starredAt: "2023-11-02",455 },456 {457 login: "zoe-type",458 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-12.svg",459 starredAt: "2024-02-15",460 },461 {462 login: "maya-dev",463 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-13.svg",464 starredAt: "2021-03-04",465 },466 {467 login: "leo-builds",468 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-14.svg",469 starredAt: "2021-06-12",470 },471 {472 login: "priya-r",473 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-15.svg",474 starredAt: "2021-09-21",475 },476 {477 login: "sam-ships",478 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-16.svg",479 starredAt: "2021-12-08",480 },481 {482 login: "noor-k",483 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-17.svg",484 starredAt: "2022-03-17",485 },486 {487 login: "ivan-ui",488 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-18.svg",489 starredAt: "2022-06-29",490 },491 {492 login: "chen-codes",493 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-01.svg",494 starredAt: "2022-09-14",495 },496 {497 login: "ana-motion",498 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-02.svg",499 starredAt: "2022-12-23",500 },501 {502 login: "omar-labs",503 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-03.svg",504 starredAt: "2023-03-09",505 },506 {507 login: "julia-ux",508 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-04.svg",509 starredAt: "2023-07-19",510 },511 {512 login: "kai-frames",513 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-05.svg",514 starredAt: "2023-11-02",515 },516 {517 login: "zoe-type",518 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-06.svg",519 starredAt: "2024-02-15",520 },521 {522 login: "maya-dev",523 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-07.svg",524 starredAt: "2021-03-04",525 },526 {527 login: "leo-builds",528 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-08.svg",529 starredAt: "2021-06-12",530 },531 {532 login: "priya-r",533 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-09.svg",534 starredAt: "2021-09-21",535 },536 {537 login: "sam-ships",538 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-10.svg",539 starredAt: "2021-12-08",540 },541 {542 login: "noor-k",543 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-11.svg",544 starredAt: "2022-03-17",545 },546 {547 login: "ivan-ui",548 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-12.svg",549 starredAt: "2022-06-29",550 },551 {552 login: "chen-codes",553 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-13.svg",554 starredAt: "2022-09-14",555 },556 {557 login: "ana-motion",558 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-14.svg",559 starredAt: "2022-12-23",560 },561 {562 login: "omar-labs",563 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-15.svg",564 starredAt: "2023-03-09",565 },566 {567 login: "julia-ux",568 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-16.svg",569 starredAt: "2023-07-19",570 },571 {572 login: "kai-frames",573 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-17.svg",574 starredAt: "2023-11-02",575 },576 {577 login: "zoe-type",578 avatarUrl: "https://kuchi-media.kalarislabs.com/components/art/avatar-18.svg",579 starredAt: "2024-02-15",580 },581];582583export const SAMPLE_STARGAZERS: Stargazer[] = (() => {584 const occurrences = new Map<string, number>();585 return RAW_SAMPLE_STARGAZERS.map((stargazer) => {586 const occurrence = (occurrences.get(stargazer.login) ?? 0) + 1;587 occurrences.set(stargazer.login, occurrence);588 return occurrence === 1589 ? stargazer590 : { ...stargazer, login: `${stargazer.login}-${occurrence}` };591 });592})();593594// Load fonts INSIDE the composition (via @remotion/google-fonts, which waits for595// the font with delayRender before rendering frames). Server renders run in a596// bare headless Chromium with no app CSS / `--font-*` vars, so without this the597// MP4 falls back to the default sans-serif. Manrope for UI text, JetBrains Mono598// for the numeric star counter (odometer).599const { fontFamily: SANS_FAMILY } = loadSans();600const { fontFamily: MONO_FAMILY } = loadMono();601602const FONT_FAMILY = SANS_FAMILY;603604interface Theme {605 bg: string;606 bgSubtle: string;607 fg: string;608 fgMuted: string;609 border: string;610}611612const THEMES: Record<"light" | "dark", Theme> = {613 light: {614 bg: "#ffffff",615 bgSubtle: "#fafafa",616 fg: "#171717",617 fgMuted: "#737373",618 border: "#ededed",619 },620 dark: {621 bg: "#0a0a0a",622 bgSubtle: "#111113",623 fg: "#fafafa",624 fgMuted: "#a1a1aa",625 border: "#262626",626 },627};628629// --- Pure helpers (unit-tested) -------------------------------------------630631/**632 * Clamp a stargazer list to at most `max` evenly-sampled keyframe rows while633 * always preserving the first and last entry. Safety net for callers that pass634 * a huge array straight into the composition.635 */636export function downsampleStargazers(637 stargazers: Stargazer[],638 max = 60,639): Stargazer[] {640 const len = stargazers.length;641 if (len <= max) return stargazers;642 if (max <= 1) return len ? [stargazers[0]] : [];643 const out: Stargazer[] = [];644 for (let i = 0; i < max; i++) {645 out.push(stargazers[Math.round((i * (len - 1)) / (max - 1))]);646 }647 return out;648}649650const MAX_ELASTIC_OVERSHOOT = 0.0658; // Easing.elastic(1) peak−1 (true ≈0.0657267), rounded UP for use as a safety bound651const SCROLL_OVERSHOOT = 1 + MAX_ELASTIC_OVERSHOOT; // ≈1.0658652const MASK_SOLID_FRACTION = 0.88; // bottom fade mask is solid until 88% of viewport height653const COUNT_PORTION = 0.8;654655/** Monotonic counter ramp — mirrors the reference StarCount easing. Drives the656 * odometer, which must stay monotonic or the digit wheels roll backward. */657export function computeCounterProgress({658 frame,659 speed = 1,660 durationInFrames,661}: {662 frame: number;663 speed?: number;664 durationInFrames: number;665}): number {666 return interpolate(667 frame * speed,668 [0, durationInFrames * COUNT_PORTION],669 [0, 1],670 {671 extrapolateLeft: "clamp",672 extrapolateRight: "clamp",673 easing: Easing.bezier(0.5, 1, 0.5, 1),674 },675 );676}677678/** Elastic scroll ramp — mirrors the reference avatar slide. NON-monotonic:679 * overshoots to ~SCROLL_OVERSHOOT near t≈0.63 and settles to exactly 1 at t=1.680 * Drives only scrollY (never the odometer). */681export function computeScrollProgress({682 frame,683 speed = 1,684 durationInFrames,685}: {686 frame: number;687 speed?: number;688 durationInFrames: number;689}): number {690 return interpolate(frame * speed, [0, durationInFrames], [0, 1], {691 extrapolateLeft: "clamp",692 extrapolateRight: "clamp",693 easing: Easing.elastic(0.8),694 });695}696697/** Empty rows appended below the last stargazer so the elastic recoil never698 * lifts real content off the mask-solid zone, revealing a void. Single source699 * of truth shared with isScrollContained so the two cannot drift. */700export function computeSpacerRows({701 N,702 rowH,703 viewportH,704 visibleRows,705}: {706 N: number;707 rowH: number;708 viewportH: number;709 visibleRows: number;710}): number {711 const D = Math.max(0, (N - visibleRows + 1) * rowH);712 const needPx =713 MASK_SOLID_FRACTION * viewportH - N * rowH + SCROLL_OVERSHOOT * D;714 return Math.max(0, Math.ceil(needPx / rowH));715}716717/** True when, at the elastic overshoot peak, content still fills the mask-solid718 * zone (no void revealed). True by construction given computeSpacerRows. */719export function isScrollContained({720 N,721 rowH,722 viewportH,723 visibleRows,724}: {725 N: number;726 rowH: number;727 viewportH: number;728 visibleRows: number;729}): boolean {730 const D = Math.max(0, (N - visibleRows + 1) * rowH);731 const spacerPx =732 computeSpacerRows({ N, rowH, viewportH, visibleRows }) * rowH;733 return (734 N * rowH + spacerPx - SCROLL_OVERSHOOT * D >=735 MASK_SOLID_FRACTION * viewportH736 );737}738739/** The running counter value for a given scroll progress. Locks at totalStars. */740export function getStarCount(741 scrollProgress: number,742 totalStars: number,743): number {744 return Math.round(scrollProgress * totalStars);745}746747// --- Sub-components --------------------------------------------------------748749function StarGlyph({ size, fill }: { size: number; fill: string }) {750 return (751 <svg752 xmlns="http://www.w3.org/2000/svg"753 viewBox="0 0 24 24"754 width={size}755 height={size}756 color={fill}757 fill={fill}758 stroke={fill}759 strokeWidth="1.5"760 strokeLinecap="round"761 strokeLinejoin="round"762 >763 <title>Stars</title>764 <path d="M13.7276 3.44418L15.4874 6.99288C15.7274 7.48687 16.3673 7.9607 16.9073 8.05143L20.0969 8.58575C22.1367 8.92853 22.6167 10.4206 21.1468 11.8925L18.6671 14.3927C18.2471 14.8161 18.0172 15.6327 18.1471 16.2175L18.8571 19.3125C19.417 21.7623 18.1271 22.71 15.9774 21.4296L12.9877 19.6452C12.4478 19.3226 11.5579 19.3226 11.0079 19.6452L8.01827 21.4296C5.8785 22.71 4.57865 21.7522 5.13859 19.3125L5.84851 16.2175C5.97849 15.6327 5.74852 14.8161 5.32856 14.3927L2.84884 11.8925C1.389 10.4206 1.85895 8.92853 3.89872 8.58575L7.08837 8.05143C7.61831 7.9607 8.25824 7.48687 8.49821 6.99288L10.258 3.44418C11.2179 1.51861 12.7777 1.51861 13.7276 3.44418Z"></path>765 </svg>766 );767}768769function Avatar({770 login,771 avatarUrl,772 size,773 theme,774}: {775 login: string;776 avatarUrl: string;777 size: number;778 theme: Theme;779}) {780 const [errored, setErrored] = useState(false);781 const ringStyle = {782 width: size,783 height: size,784 borderRadius: 9999,785 border: `1px solid ${theme.border}`,786 flexShrink: 0,787 } as const;788789 if (errored || !avatarUrl) {790 return (791 <div792 style={{793 ...ringStyle,794 background: theme.bgSubtle,795 display: "flex",796 alignItems: "center",797 justifyContent: "center",798 color: theme.fgMuted,799 fontSize: size * 0.42,800 fontWeight: 600,801 }}802 >803 {login.charAt(0).toUpperCase()}804 </div>805 );806 }807808 return (809 <Img810 src={avatarUrl}811 onError={() => setErrored(true)}812 style={{ ...ringStyle, objectFit: "cover" }}813 />814 );815}816817interface RowProps {818 stargazer: Stargazer;819 index: number;820 rowH: number;821 avatarSize: number;822 loginSize: number;823 dateLabel: string;824 accent: string;825 theme: Theme;826 isActive: boolean;827 settle: number;828 showSeparator: boolean;829 opacity: number;830}831832const Row = memo(function Row({833 stargazer,834 index,835 rowH,836 avatarSize,837 loginSize,838 dateLabel,839 accent,840 theme,841 isActive,842 settle,843 showSeparator,844 opacity,845}: RowProps) {846 return (847 <div848 style={{849 position: "relative",850 height: rowH,851 display: "flex",852 alignItems: "center",853 paddingLeft: 24,854 paddingRight: 24,855 background: "transparent",856 opacity,857 boxSizing: "border-box",858 borderBottom:859 showSeparator && !isActive ? `1px solid ${theme.border}` : "none",860 }}861 >862 {isActive && (863 <>864 <div865 style={{866 position: "absolute",867 inset: 0,868 background: theme.bgSubtle,869 opacity: settle,870 }}871 />872 <div873 style={{874 position: "absolute",875 left: 0,876 top: 0,877 bottom: 0,878 width: 2,879 background: accent,880 opacity: settle,881 }}882 />883 </>884 )}885 <div886 style={{887 position: "relative",888 display: "flex",889 alignItems: "center",890 width: "100%",891 }}892 >893 <Avatar894 login={stargazer.login}895 avatarUrl={stargazer.avatarUrl}896 size={avatarSize}897 theme={theme}898 />899 <div style={{ marginLeft: 20, minWidth: 0, flex: 1 }}>900 <div901 style={{902 fontSize: loginSize,903 fontWeight: 600,904 color: theme.fg,905 fontFamily: FONT_FAMILY,906 whiteSpace: "nowrap",907 overflow: "hidden",908 textOverflow: "ellipsis",909 lineHeight: 1.2,910 }}911 >912 {stargazer.login}913 </div>914 <div915 style={{916 fontSize: 18,917 fontWeight: 400,918 color: theme.fgMuted,919 fontFamily: FONT_FAMILY,920 lineHeight: 1.3,921 }}922 >923 {dateLabel}924 </div>925 </div>926 <div927 style={{928 display: "flex",929 alignItems: "center",930 gap: 8,931 color: theme.fgMuted,932 fontFamily: MONO_FAMILY,933 fontSize: 18,934 fontVariantNumeric: "tabular-nums",935 flexShrink: 0,936 }}937 >938 <StarGlyph size={20} fill={accent} />939 <span>#{index + 1}</span>940 </div>941 </div>942 </div>943 );944});945946// --- Main composition ------------------------------------------------------947948export function GitHubStars({949 repo = "acme/launch-kit",950 totalStars = 24813,951 stargazers = SAMPLE_STARGAZERS,952 orientation = "horizontal",953 accentColor = "#ffbb00",954 speed = 1,955 theme = "light",956 repoAvatarUrl,957}: GitHubStarsProps) {958 const frame = useCurrentFrame();959 const { durationInFrames, width, height } = useVideoConfig();960 const t = THEMES[theme] ?? THEMES.light;961 const isVertical = orientation === "vertical";962963 // Render at the native reference size for the orientation, then scale to fit964 // the actual canvas — keeps proportions at any resolution and letterboxes a965 // vertical layout cleanly inside a horizontal preview canvas.966 const refW = isVertical ? 720 : 1280;967 const refH = isVertical ? 1280 : 720;968 const stageScale = Math.min(width / refW, height / refH);969970 const rows = useMemo(() => downsampleStargazers(stargazers), [stargazers]);971 const N = rows.length;972973 // Progress drivers: monotonic counter ramp + non-monotonic elastic scroll.974 const counterProgress = computeCounterProgress({975 frame,976 speed,977 durationInFrames,978 });979 const pScroll = computeScrollProgress({ frame, speed, durationInFrames });980 const p = Math.max(0, Math.min(1, (frame * speed) / durationInFrames));981982 const current = counterProgress * totalStars;983984 // List viewport geometry (in reference px).985 const rowH = isVertical ? 96 : 88;986 const avatarSize = isVertical ? 60 : 56;987 const loginSize = isVertical ? 30 : 28;988 const dateFormat = isVertical ? "MMM yyyy" : "MMM d, yyyy";989 const formattedRows = useMemo(990 () =>991 rows.map((sg) => {992 try {993 return { sg, dateLabel: format(parseISO(sg.starredAt), dateFormat) };994 } catch {995 return { sg, dateLabel: sg.starredAt };996 }997 }),998 [rows, dateFormat],999 );10001001 const viewport = isVertical1002 ? { x: 48, y: 320, w: 624, h: 888, radius: 28 }1003 : { x: 560, y: 60, w: 640, h: 600, radius: 24 };10041005 const visibleRows = Math.floor(viewport.h / rowH);1006 const D = Math.max(0, (N - visibleRows + 1) * rowH);1007 const scrollY = -pScroll * D;10081009 const spacerRows = computeSpacerRows({1010 N,1011 rowH,1012 viewportH: viewport.h,1013 visibleRows,1014 });1015 const spacerPx = spacerRows * rowH;10161017 const settle = interpolate(p, [0.92, 1], [0, 1], {1018 extrapolateLeft: "clamp",1019 extrapolateRight: "clamp",1020 });10211022 // Counter zone type scale.1023 const counterSize = isVertical ? 96 : 120;1024 const starSize = isVertical ? 56 : 64;1025 const underlineMax = isVertical ? 200 : 240;1026 const underlineWidth = counterProgress * underlineMax;10271028 const fadeH = Math.round(viewport.h * 0.12);10291030 const listViewport = (1031 <div1032 style={{1033 position: "absolute",1034 left: viewport.x,1035 top: viewport.y,1036 width: viewport.w,1037 height: viewport.h,1038 overflow: "hidden",1039 borderRadius: viewport.radius,1040 border: `1px solid ${t.border}`,1041 background: t.bg,1042 }}1043 >1044 <div1045 style={{1046 translate: `0 ${scrollY}px`,1047 willChange: "transform",1048 }}1049 >1050 {formattedRows.map(({ sg, dateLabel }, i) => (1051 <Row1052 key={`${sg.login}-${i}`}1053 stargazer={sg}1054 index={i}1055 rowH={rowH}1056 avatarSize={avatarSize}1057 loginSize={loginSize}1058 dateLabel={dateLabel}1059 accent={accentColor}1060 theme={t}1061 isActive={i === N - 1}1062 settle={i === N - 1 ? settle : 0}1063 showSeparator={i < N - 1}1064 opacity={1}1065 />1066 ))}1067 {spacerPx > 0 && (1068 <div style={{ height: spacerPx }} aria-hidden="true" />1069 )}1070 </div>1071 <div1072 style={{1073 position: "absolute",1074 top: 0,1075 left: 0,1076 right: 0,1077 height: fadeH,1078 background: `linear-gradient(to bottom, ${t.bg}, transparent)`,1079 pointerEvents: "none",1080 }}1081 />1082 <div1083 style={{1084 position: "absolute",1085 bottom: 0,1086 left: 0,1087 right: 0,1088 height: fadeH,1089 background: `linear-gradient(to top, ${t.bg}, transparent)`,1090 pointerEvents: "none",1091 }}1092 />1093 </div>1094 );10951096 const underline = (1097 <div1098 style={{1099 height: 4,1100 width: underlineWidth,1101 background: accentColor,1102 borderRadius: 2,1103 }}1104 />1105 );11061107 const repoOwner = repo.split("/")[0] || repo;1108 const repoAvatarSize = isVertical ? 28 : 32;1109 const repoAvatarSrc =1110 repoAvatarUrl ?? "https://kuchi-media.kalarislabs.com/components/art/avatar-05.svg";11111112 const repoSlug = (1113 <div1114 style={{1115 display: "flex",1116 alignItems: "center",1117 gap: 12,1118 maxWidth: isVertical ? 600 : 392,1119 }}1120 >1121 <Avatar1122 login={repoOwner}1123 avatarUrl={repoAvatarSrc}1124 size={repoAvatarSize}1125 theme={t}1126 />1127 <div1128 style={{1129 fontSize: isVertical ? 20 : 24,1130 fontWeight: 500,1131 color: t.fgMuted,1132 fontFamily: FONT_FAMILY,1133 overflow: "hidden",1134 textOverflow: "ellipsis",1135 whiteSpace: "nowrap",1136 }}1137 >1138 {repo}1139 </div>1140 </div>1141 );11421143 const counterZone = isVertical ? (1144 <div1145 style={{1146 position: "absolute",1147 left: 0,1148 top: 0,1149 width: refW,1150 height: 300,1151 paddingTop: 72,1152 display: "flex",1153 flexDirection: "column",1154 alignItems: "center",1155 gap: 14,1156 }}1157 >1158 <div style={{ display: "flex", alignItems: "center", gap: 20 }}>1159 <StarGlyph size={starSize} fill={accentColor} />1160 <Odometer current={current} fontSize={counterSize} color={t.fg} />1161 </div>1162 {underline}1163 {repoSlug}1164 </div>1165 ) : (1166 <div1167 style={{1168 position: "absolute",1169 left: 80,1170 top: 0,1171 width: 392,1172 height: refH,1173 display: "flex",1174 flexDirection: "column",1175 justifyContent: "center",1176 alignItems: "flex-start",1177 }}1178 >1179 <StarGlyph size={starSize} fill={accentColor} />1180 <div style={{ height: 20 }} />1181 <Odometer current={current} fontSize={counterSize} color={t.fg} />1182 <div style={{ height: 16 }} />1183 {underline}1184 <div style={{ height: 20 }} />11851186 {repoSlug}1187 </div>1188 );11891190 return (1191 <AbsoluteFill style={{ background: t.bg }}>1192 <div1193 style={{1194 position: "absolute",1195 left: "50%",1196 top: "50%",1197 width: refW,1198 height: refH,1199 translate: "-50% -50%",1200 scale: `${stageScale}`,1201 }}1202 >1203 {counterZone}1204 {listViewport}1205 </div>1206 </AbsoluteFill>1207 );1208}









