Embed

<Embed url="…"> turns a single URL into a small, opinionated link card. Metadata is fetched at build time on the server, cached for 7 days, and rendered as static HTML — no iframes, no client-side JavaScript, no third-party tracking pixels.

Providers

Usage

<Embed url="https://github.com/tsaiggo/verto" />

<Embed url="https://www.youtube.com/watch?v=dQw4w9WgXcQ" />

<Embed url="https://x.com/jack/status/20" />

{/* Force the bookmark renderer regardless of URL detection */}
<Embed url="https://github.com/tsaiggo/verto" as="bookmark" />

{/* Override metadata — useful for private URLs or when the live page is
    rate-limited. When *any* override is set, no network call is made. */}
<Embed
  url="https://example.com"
  title="Internal RFC"
  description="Architecture proposal — see #design Slack channel"
  image="/local-preview.png"
/>

Live examples

Caching & rate limits

Resolved metadata is cached on disk at node_modules/.cache/verto/embeds.json for 7 days. If a GitHub API call fails (e.g. you've hit the 60 req/hr unauthenticated limit), the component degrades gracefully to an OpenGraph lookup, then to a minimal bookmark card — your page will always render.

Set GITHUB_TOKEN in your build environment to raise the limit to 5000 req/hour. The token is only used to add an Authorization header for GitHub REST calls and is never persisted in the cache.

Props