chainlinkmeme
⬢ A community-curated archive of Chainlink memes — chainlinkme.me.
Browse, search, favorite, and react. Every meme has a permalink that unfurls beautifully in Discord, Twitter, and Telegram. The memeverse flies you through the whole archive as a 3D galaxy and can rebuild your face out of it; a tag constellation maps the archive as a cosmos; weekly snapshots preserve the top 7 memes each week; a Discord slash command pulls memes into any server on demand.
Architecture
GitHub repo ─► jsDelivr (image CDN, automatic)
│
│
├──► GitHub Pages (Astro, 100% pre-rendered)
│
└──► Cloudflare Worker ─► D1 (/api/reactions · /discord/interactions)
- Images + metadata live in this repo. The repo is the archive.
- Site is a static Astro build deployed to GitHub Pages — no Cloudflare Pages, no Next.js, no SSR.
- Worker handles the two small bits of state: per-meme reactions (D1-backed, edge-cached) and the Discord slash command. ~200 lines total.
- Images are served via jsDelivr directly from this public repo — no separate CDN setup, no S3.
Everything else is derived at build time. The live site can be rebuilt from scratch with git clone && pnpm install && pnpm build — the only external state is the D1 reactions table, which is allowed to be lossy.
Repo layout
memes/ # source of truth: one .jpg/.gif/.png/.webp + one .toml per meme
site/ # Astro frontend (GitHub Pages)
worker/ # Cloudflare Worker + D1 (reactions + Discord bot)
scripts/ # build-time + one-off tooling
.github/workflows/ # CI: validate PRs, deploy on merge, weekly snapshot
Features
The memeverse (/verse)
Every meme in the archive as a hex tile in one WebGL 2 galaxy.
- Star systems: every tag with 12+ memes becomes a spinning disc of tiles. Each meme lives in the system of its rarest qualifying tag, so the giant tags don't swallow the niche ones. Sergey holds the galactic core around a glowing chainlink hex; the other systems wind out along two spiral arms, each next to the system it shares the most memes with. Memes with no system drift on the outer rim.
- Stars that resolve into memes: far away, a tile renders as a star of its average colour; fly closer and it becomes the meme. Tiles big on screen stream in a sharp 256px copy.
- Fly: drag to orbit, scroll/pinch to zoom, right- or shift-drag to pan, click a meme to fly to it (info panel, reactions, prev/next through its system).
/ lights up a tag, r warps to a random meme, t starts an autopilot tour (good on a TV), ? shows the keys.
- Deep links:
#m=<slug> (every permalink has a "find it in the memeverse" button), #tag=pepe, #tour, #assemble, and #callsign=rory-clippy-fud, which flies a ccip.dev LinkMarine through the three dog-tag tags their callsign was drawn from.
Assemble (/verse/#assemble)
Drop in a photo (or take a selfie, or pick a meme, or the chainlink mark) and the galaxy pours out of its orbits to rebuild it as a honeycomb portrait made of the archive. Download it as a hex PFP or a poster, share it, or record a clip of the galaxy assembling it (MP4 where the browser can encode it, WebM otherwise; filmed straight off the canvas, no UI).
- Each hex is described the way the build describes every meme: mean CIE Lab colour over a 4×4 grid of bins inside the hex. The matcher shortlists by mean colour, picks by the full description, makes reuse progressively more expensive and never repeats a meme next to itself, so a face comes out of ~900 different memes rather than a few beige ones.
- A blend slider shifts each tile towards the photo's colour while keeping part of the meme's own contrast; the 3D view and the downloads apply the same maths.
- It all runs in the browser. The photo never leaves the device.
Gallery
- Responsive JS masonry (2/3/4 columns), append-only so scrolling back up never reshuffles memes
- Browse by vibe: a scrollable rail of the 24 biggest tags, each fronted by its most colourful meme as a hex (picked at build time from the memeverse atlas's colour features,
site/src/lib/tag-rail.ts); one tap filters the wall
- A command bar that sticks to the top while you scroll: tag search with synonym-aware autocomplete, fresh / shuffle order (shuffle is a seeded re-deal, so pagination stays stable), GIFs only, Favorites only, Random
- Cards carry a caption and their first tags, a "new" badge for recent additions, and one-click copy image (a PNG straight to the clipboard, paste it into X or Telegram; GIFs fall back to copying the link)
- Per-meme permalinks (
/m/<slug>) with full OG + Twitter cards
r for a random meme; / to focus search; j/k to navigate; f to favorite; i to copy the image; ? for the full keymap- View transitions between gallery and permalinks
- Dark / light themes (respects
prefers-color-scheme)
- The stage: the meme of the day as a holographic collector card (foil and glare follow the cursor) over a living honeycomb of the archive's most colourful memes, which drifts, shimmers, lights up around the pointer and flips tiles over. The pick is re-made in the browser for today's UTC date, so it matches the daily X post between deploys, and it flips to the next one at midnight with a countdown. The honeycomb's sheet (
atlas/hero.webp, ~145 KB) is rendered by scripts/build-verse-og.ts
- Hex-shaped scroll-to-top widget
Reactions
- Four reactions per meme: ❤️, 😂, ⚡, 💎
- Optimistic UI with rollback on failure, offline pill if the worker is unreachable
- Global counts served bulk from
/api/reactions, edge-cached
- Personal favorites persisted in localStorage
- Legacy
likes table preserved so pre-migration hearts still count
Tag constellation (/map)
- The archive rendered as a force-directed graph — tags are hexagons, edges are co-occurrences
- Hover highlights a tag's connections; click navigates into the gallery with that tag pre-filtered
- Wheel to zoom (anchored at cursor, 0.5× – 5×); click-drag to pan; "reset view" chip when off-identity
Weekly snapshots (/week)
- Every Monday a GitHub Action freezes the top 7 memes by reaction count and commits the snapshot as
site/src/data/weekly/YYYY-Www.json
- Historical weeks are browsable forever — no backfill, gaps stay honest
Discord bot
Summon any meme in your Discord server with /clmeme <tag>:
/clmeme sergey → a random sergey meme/clmeme moon wagmi → a meme matching either tag (weighted by score)/clmeme → a random meme from the archive
Install to your server →
Server admins only need applications.commands scope — no bot user, no gateway, no ongoing permissions. Every invocation hits the Cloudflare Worker, which verifies Discord's Ed25519 signature and embeds the meme inline.
Telegram bot
Summon any meme in Telegram with either entry point:
- Inline —
@chainlinkmemebot sergey in any chat. A picker appears; tap a thumbnail to send the meme. Works in DMs, groups, channels, and comment threads — no install step, no bot permissions.
- Command — DM the bot or add it to a group and run
/clmeme sergey. Empty query returns a random meme.
Open @chainlinkmemebot →
Like the Discord bot, there's no gateway or polling — Telegram POSTs each update to the Cloudflare Worker (/telegram/webhook), which verifies the secret-token header and replies with the send-photo action inline.
X (Twitter) bot
Once a day at 14:00 UTC, /tweet-daily posts the meme-of-the-day — the same meme the site's hero shows — as a native image (the GIF itself for animated memes) with its tags. The post carries no link on purpose: a URL-free post bills at X's $0.015 Post: Create rate instead of the $0.200 Content: Create with URL rate, and native media out-reaches link posts on X anyway.
Secrets (X_API_KEY / X_API_SECRET / X_ACCESS_TOKEN / X_ACCESS_SECRET) live in GitHub Actions.
Sticker export
Each permalink has a save as sticker button that exports to Signal-spec 512×512 — WebP for static memes, APNG for animated (≤300 KB, ≤3s loop). The APNG branch runs UPNG quantization entirely in-browser, adaptively dropping the color palette until it fits the 300 KB budget; the whole encoder bundle is lazy-loaded (~95 KB) and only ships when someone actually clicks the button. Drop the output straight into Signal, Telegram, Discord, or Slack.
OG images
Every meme has a pre-rendered 1200×630 OG card (baked by scripts/build-og-images.ts with Satori + Resvg, CI-cached by content hash). The home page has a custom 77-meme honeycomb mosaic. The memeverse's card (og/_verse.png) is the real galaxy layout, projected and composited by scripts/build-verse-og.ts.
Honeycomb grid (/grid)
Every meme in the archive, at once, as a single hex tessellation. Wheel to zoom, drag to pan, click any tile to open. Zoomed out, tiles come from the memeverse's sprite sheets (two images for the whole archive); full images take over as you zoom in.
Shuffle mode (keyboard-only)
Press s anywhere on the site for fullscreen one-meme-at-a-time mode. Space / → for next, ← for previous, Esc to exit. Unlisted — find it in the ? help dialog.
Public API
The canonical data source is manifest.json — the full archive, CORS-open, regenerated on every deploy. Worker endpoints on top of it:
| Endpoint | Description |
|---|
GET /api/random | JSON for a random meme. ?tag=xxx filters by tag. ?redirect=1 returns a 302 to the permalink. |
GET /api/search?q=... | Tag + synonym + title/description search. &limit=N (default 24, max 100). |
GET /api/tags | Every tag with its meme count, sorted by popularity. |
GET /api/reactions | Bulk { slug: { heart, laugh, bolt, diamond } } map (edge-cached 60s). |
Worker base URL: https://chainlinkmeme-api.pilgrim.workers.dev.
Embed widget
Each permalink has a copy embed button that gives you an <iframe> snippet you can drop into blogs, Notion, Discord embeds, etc. The embed page lives at /embed/:slug.
Develop locally
pnpm install
pnpm --filter site dev # site at http://localhost:4321
pnpm --filter worker dev # worker at http://localhost:8787
pnpm --filter site build # pre-render every meme page (~1,800 pages, ~5s)
Useful workspace scripts:
pnpm manifest # regenerate site/public/manifest.json from memes/*.toml
pnpm og # rebuild OG images (cache-friendly)
pnpm atlas # pack the memeverse's sprite sheets + mosaic features, render its OG card
pnpm validate # PR-style schema + vocab + uniqueness checks
pnpm weekly # compute this week's top-7 snapshot
pnpm tweet:daily -- --dry-run # preview today's daily post
pnpm discord:register # (re)register the /clmeme slash command
pnpm telegram:register # (re)register Telegram webhook + bot commands
Contribute a meme
Drop yourfile.jpg + yourfile.toml into memes/, open a PR.
title = "short display title" # optional
tags = ["sergey", "moon"] # required, must exist in memes/_vocab.toml
description = "context or lore" # optional
credit = "@someone" # optional
source_url = "https://..." # optional
nsfw = false # default false
# submitted_by + date_added are auto-filled by CI
See CONTRIBUTING.md for the full walkthrough.
Deploy
- Push to
main → deploy.yml runs three jobs:
backfill-meta — auto-fills submitted_by and date_added on new TOMLs, commits backbuild-and-deploy — builds manifest, renders OG images, packs the memeverse atlas, runs astro build, publishes to GitHub Pagesdeploy-worker — ships the Worker via wrangler deploy
- Weekly Monday 09:00 UTC →
weekly.yml writes the new snapshot and commits it to main
D1 migrations under worker/migrations/ are applied with pnpm wrangler d1 migrations apply chainlinkmeme --remote.
License
- Site + worker code: MIT (see
LICENSE)
- Memes: community-curated, individual attribution where known. Please don't submit anything you don't have the right to share.
