Skip to content

The agent that turns websites into APIs!

Add ShareDirectory component (saved, not wired up)

kalil0321b5cd95c125c3
diff --git a/website/src/components/share-directory/brand-icon.tsx b/website/src/components/share-directory/brand-icon.tsx
new file mode 100644
index 0000000..643d89b
--- /dev/null
+++ b/website/src/components/share-directory/brand-icon.tsx
@@ -0,0 +1,45 @@
+'use client';
+
+import { useState } from 'react';
+import { logoUrl } from './clients';
+
+// Brand logo on a clean tile; falls back to the accent monogram tile if the
+// logo fails to load (404 / offline). Client component so onError works.
+export function BrandIcon({
+ domain,
+ monogram,
+ accent,
+ size = 26,
+ className = '',
+}: {
+ domain: string;
+ monogram: string;
+ accent: string;
+ size?: number;
+ className?: string;
+}) {
+ const [failed, setFailed] = useState(false);
+ return (
+ <span
+ className={`grid place-items-center overflow-hidden shrink-0 ${className}`}
+ style={{ background: failed ? accent : '#fff' }}
+ >
+ {failed ? (
+ <span className="text-white font-semibold leading-none" style={{ fontSize: size * 0.46 }}>
+ {monogram}
+ </span>
+ ) : (
+ // eslint-disable-next-line @next/next/no-img-element
+ <img
+ src={logoUrl(domain)}
+ alt=""
+ width={size}
+ height={size}
+ loading="lazy"
+ onError={() => setFailed(true)}
+ style={{ width: size, height: size, objectFit: 'contain' }}
+ />
+ )}
+ </span>
+ );
+}
diff --git a/website/src/components/share-directory/clients.ts b/website/src/components/share-directory/clients.ts
new file mode 100644
index 0000000..8890415
--- /dev/null
+++ b/website/src/components/share-directory/clients.ts
@@ -0,0 +1,203 @@
+// Directory of clients & CLIs built with rae.
+//
+// PLACEHOLDER DATA. When this page is wired up for real, this array becomes the
+// committed data source populated via "Submit your client" pull requests (the
+// submission/cloud logic is still TBD — that's why the page isn't shipped yet).
+
+export type Category = 'AI' | 'Music' | 'Social' | 'Finance' | 'Shopping' | 'Dev';
+
+export type RaeClient = {
+ slug: string;
+ service: string;
+ monogram: string;
+ title: string; // SEO-flavored: "Unofficial X API"
+ blurb: string;
+ author: string;
+ stars: number;
+ lang: 'Python' | 'TypeScript';
+ category: Category;
+ tags: string[];
+ accent: string; // brand-ish accent, used as icon-tile bg + monogram fallback
+ domain: string; // brand domain, for the logo service
+ featured?: boolean;
+};
+
+export const CATEGORIES: Category[] = ['AI', 'Music', 'Social', 'Finance', 'Shopping', 'Dev'];
+
+// Brand icon by domain. DuckDuckGo's icon service is no-token, domain-keyed,
+// and reliable (Clearbit's free logo API is dead; Pipedream's logos are keyed
+// by internal app_id, not domain; logo.dev needs a token). One-line swap.
+export const logoUrl = (domain: string) => `https://icons.duckduckgo.com/ip3/${domain}.ico`;
+
+export const CLIENTS: RaeClient[] = [
+ {
+ slug: 'spotify',
+ service: 'Spotify',
+ monogram: 'Sp',
+ title: 'Unofficial Spotify API',
+ blurb: 'Search tracks, read playlists and pull audio features straight from the web player — no developer app, no rate-limited tokens.',
+ author: '@maelle',
+ stars: 412,
+ lang: 'Python',
+ category: 'Music',
+ tags: ['search', 'auth', 'playlists'],
+ accent: '#1db954',
+ domain: 'spotify.com',
+ featured: true,
+ },
+ {
+ slug: 'perplexity',
+ service: 'Perplexity',
+ monogram: 'Px',
+ title: 'Unofficial Perplexity API',
+ blurb: 'Drive Perplexity answers and follow-ups programmatically, including the sources panel and the model picker.',
+ author: '@dvv',
+ stars: 308,
+ lang: 'Python',
+ category: 'AI',
+ tags: ['stream', 'auth', 'sources'],
+ accent: '#20808d',
+ domain: 'perplexity.ai',
+ featured: true,
+ },
+ {
+ slug: 'suno',
+ service: 'Suno',
+ monogram: 'Su',
+ title: 'Unofficial Suno API',
+ blurb: 'Queue song generations, poll job status and download finished tracks — the captcha-gated flow handled for you.',
+ author: '@kalil',
+ stars: 286,
+ lang: 'Python',
+ category: 'Music',
+ tags: ['jobs', 'captcha', 'download'],
+ accent: '#000000',
+ domain: 'suno.com',
+ },
+ {
+ slug: 'notion',
+ service: 'Notion',
+ monogram: 'No',
+ title: 'Unofficial Notion API',
+ blurb: 'Read and write blocks the web app can but the public API still cannot — synced blocks, page comments and database views.',
+ author: '@hana',
+ stars: 241,
+ lang: 'TypeScript',
+ category: 'Dev',
+ tags: ['blocks', 'auth', 'sync'],
+ accent: '#111111',
+ domain: 'notion.so',
+ },
+ {
+ slug: 'linear',
+ service: 'Linear',
+ monogram: 'Li',
+ title: 'Unofficial Linear API',
+ blurb: 'Bulk-update issues and triage views by replaying the exact GraphQL calls the app makes, typed end to end.',
+ author: '@theo',
+ stars: 197,
+ lang: 'TypeScript',
+ category: 'Dev',
+ tags: ['graphql', 'issues', 'bulk'],
+ accent: '#5e6ad2',
+ domain: 'linear.app',
+ },
+ {
+ slug: 'vinted',
+ service: 'Vinted',
+ monogram: 'Vi',
+ title: 'Unofficial Vinted API',
+ blurb: 'Search listings, watch price drops and read seller feedback across every Vinted locale from one typed client.',
+ author: '@lou',
+ stars: 173,
+ lang: 'Python',
+ category: 'Shopping',
+ tags: ['search', 'locale', 'watch'],
+ accent: '#09b1ba',
+ domain: 'vinted.com',
+ },
+ {
+ slug: 'midjourney',
+ service: 'Midjourney',
+ monogram: 'Mj',
+ title: 'Unofficial Midjourney API',
+ blurb: 'Submit prompts, upscale, and animate jobs through the same endpoints the web app uses — Cloudflare handled.',
+ author: '@kalil',
+ stars: 168,
+ lang: 'Python',
+ category: 'AI',
+ tags: ['jobs', 'video', 'cloudflare'],
+ accent: '#1c1c1c',
+ domain: 'midjourney.com',
+ },
+ {
+ slug: 'wise',
+ service: 'Wise',
+ monogram: 'Wi',
+ title: 'Unofficial Wise API',
+ blurb: 'Pull live mid-market rates and your transfer history without the partner-program gate.',
+ author: '@sven',
+ stars: 142,
+ lang: 'Python',
+ category: 'Finance',
+ tags: ['rates', 'auth', 'history'],
+ accent: '#163300',
+ domain: 'wise.com',
+ },
+ {
+ slug: 'letterboxd',
+ service: 'Letterboxd',
+ monogram: 'Lb',
+ title: 'Unofficial Letterboxd API',
+ blurb: 'Read diaries, watchlists and ratings as typed objects — perfect for the "year in review" project they never shipped an API for.',
+ author: '@noor',
+ stars: 131,
+ lang: 'Python',
+ category: 'Social',
+ tags: ['profiles', 'lists', 'ratings'],
+ accent: '#00e054',
+ domain: 'letterboxd.com',
+ },
+ {
+ slug: 'elevenlabs',
+ service: 'ElevenLabs',
+ monogram: 'El',
+ title: 'Unofficial ElevenLabs API',
+ blurb: 'Reach the voice-design and dubbing endpoints the public SDK leaves out, with usage tracking baked in.',
+ author: '@ravi',
+ stars: 118,
+ lang: 'Python',
+ category: 'AI',
+ tags: ['tts', 'dubbing', 'usage'],
+ accent: '#000000',
+ domain: 'elevenlabs.io',
+ },
+ {
+ slug: 'strava',
+ service: 'Strava',
+ monogram: 'St',
+ title: 'Unofficial Strava API',
+ blurb: 'Get full activity streams and segment efforts without the 100-call-per-15-min cap the official API imposes.',
+ author: '@mira',
+ stars: 104,
+ lang: 'Python',
+ category: 'Social',
+ tags: ['activities', 'streams', 'segments'],
+ accent: '#fc4c02',
+ domain: 'strava.com',
+ },
+ {
+ slug: 'robinhood',
+ service: 'Robinhood',
+ monogram: 'Rh',
+ title: 'Unofficial Robinhood API',
+ blurb: 'Quote options chains and read your positions through the mobile endpoints, MFA flow included.',
+ author: '@dane',
+ stars: 96,
+ lang: 'Python',
+ category: 'Finance',
+ tags: ['quotes', 'mfa', 'positions'],
+ accent: '#00c805',
+ domain: 'robinhood.com',
+ },
+];
diff --git a/website/src/components/share-directory/index.ts b/website/src/components/share-directory/index.ts
new file mode 100644
index 0000000..465eb56
--- /dev/null
+++ b/website/src/components/share-directory/index.ts
@@ -0,0 +1,3 @@
+export { ShareDirectory } from './share-directory';
+export { CLIENTS, CATEGORIES, logoUrl } from './clients';
+export type { RaeClient, Category } from './clients';
diff --git a/website/src/components/share-directory/share-directory.tsx b/website/src/components/share-directory/share-directory.tsx
new file mode 100644
index 0000000..3082b69
--- /dev/null
+++ b/website/src/components/share-directory/share-directory.tsx
@@ -0,0 +1,109 @@
+import { BrandIcon } from './brand-icon';
+import { CLIENTS } from './clients';
+
+// "Sticker wall" directory of clients & CLIs built with rae.
+//
+// NOT YET WIRED INTO THE SITE. The visual design is final, but the data source
+// and "Submit your client" submission flow are still TBD. Drop <ShareDirectory />
+// into a route/section once that logic exists.
+
+const DISPLAY = "'opsz' 144, 'SOFT' 100, 'WONK' 1";
+const ROT = [-3, 2, -1.5, 3, -2.5, 1.5, -2, 2.5, -1, 3, -3, 1, -2];
+const TAPE_ROT = [-5, 4, -3, 6, -4, 3, -6, 5, -2, 4, -5, 3, -4];
+const PAPER = ['#fff27a', '#ffb3d1', '#c4edd0', '#bfe3ff', '#ffd6a5', '#e9d5ff'];
+
+// A strip of translucent scotch tape, hand-placed across the top of a note.
+function Tape({ angle }: { angle: number }) {
+ return (
+ <span
+ aria-hidden
+ className="absolute left-1/2 -top-2.5 -translate-x-1/2"
+ style={{
+ width: 80,
+ height: 22,
+ rotate: `${angle}deg`,
+ background:
+ 'linear-gradient(135deg, rgba(255,255,255,0.6) 0%, rgba(238,232,216,0.28) 45%, rgba(255,255,255,0.5) 100%)',
+ boxShadow: '0 1px 2px rgba(20,14,8,0.10)',
+ borderLeft: '1px solid rgba(255,255,255,0.6)',
+ borderRight: '1px solid rgba(255,255,255,0.6)',
+ }}
+ />
+ );
+}
+
+export function ShareDirectory() {
+ return (
+ <section className="bg-cream text-ink">
+ <div className="mx-auto max-w-7xl px-6 lg:px-10 py-20 md:py-28">
+ <div className="text-center mb-14">
+ <h1
+ className="font-display italic text-[clamp(2.4rem,6vw,4rem)] tracking-[-0.045em] leading-[0.9]"
+ style={{ fontVariationSettings: DISPLAY, fontWeight: 400 }}
+ >
+ Look what people <span style={{ color: 'var(--color-fd-primary)' }}>reverse-engineered.</span>
+ </h1>
+ </div>
+
+ <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-x-6 gap-y-12">
+ {CLIENTS.map((c, i) => (
+ <a
+ key={c.slug}
+ href="#"
+ className="group relative block no-underline text-[#241c14] transition-transform duration-200 hover:!rotate-0 hover:-translate-y-1.5"
+ style={{
+ rotate: `${ROT[i % ROT.length]}deg`,
+ background: PAPER[i % PAPER.length],
+ padding: '20px 16px 16px',
+ boxShadow: '5px 6px 14px rgba(20,14,8,0.18)',
+ }}
+ >
+ <Tape angle={TAPE_ROT[i % TAPE_ROT.length]} />
+ <div className="flex items-center gap-2.5 mb-2">
+ <BrandIcon
+ domain={c.domain}
+ monogram={c.monogram}
+ accent={c.accent}
+ size={20}
+ className="size-9 rounded-md"
+ />
+ <span className="text-lg font-semibold tracking-[-0.01em] text-[#241c14]">{c.service}</span>
+ </div>
+ <p className="text-[13px] leading-snug text-[#241c14]/80 min-h-[3.5em]">{c.blurb}</p>
+ <div className="mt-3 pt-2.5 border-t border-[#241c14]/20 flex items-center justify-between font-mono text-[10px] text-[#241c14]/70">
+ <span>{c.author}</span>
+ <span>★ {c.stars}</span>
+ </div>
+ </a>
+ ))}
+
+ {/* share CTA note */}
+ <a
+ href="#"
+ className="group relative grid place-items-center no-underline text-[#241c14] transition-transform duration-200 hover:!rotate-0 hover:-translate-y-1.5"
+ style={{
+ rotate: `${ROT[CLIENTS.length % ROT.length]}deg`,
+ background: '#fffdf8',
+ padding: '20px 16px 16px',
+ minHeight: 176,
+ boxShadow: '5px 6px 14px rgba(20,14,8,0.18)',
+ border: '2px dashed rgba(36,28,20,0.35)',
+ }}
+ >
+ <Tape angle={TAPE_ROT[CLIENTS.length % TAPE_ROT.length]} />
+ <div className="text-center">
+ <span
+ className="font-display italic text-3xl leading-none"
+ style={{ fontVariationSettings: DISPLAY, color: 'var(--color-fd-primary)' }}
+ >
+ +
+ </span>
+ <p className="text-[15px] font-semibold mt-1.5">Share your client</p>
+ <p className="font-mono text-[10px] uppercase tracking-widest text-[#241c14]/55 mt-1">opens a PR</p>
+ </div>
+ </a>
+ </div>
+ </div>
+ </section>
+ );
+}