ComponentsNavigation

Subscribe links

"Listen on / follow on" links for a podcast, a channel, a blog or a changelog: the platforms you pass, with your own icons (no logos are bundled), plus a Copy RSS feed button and the feed address for people who paste it into an app. Buttons in a row, or a list with one line per channel.

components/subscribe-links.tsxtheme · material · accent · density · font

Listen on

Feed address: https://example.com/podcast/feed.xml

Installation

$ pnpm add @vamos-ui/react

The whole kit as one package — get updates by bumping the version. Add the styles to globals.css: @import "@vamos-ui/react/styles.css";

Usage

import { SubscribeLinks } from "@vamos-ui/react";

<SubscribeLinks
  title="Listen on"
  feedUrl="https://example.com/feed.xml"
  links={[
    { label: "Your podcast app", href: "podcast://example.com/feed.xml" },
    { label: "Episodes by email", href: "/subscribe" },
  ]}
/>

Platform names and logos are trademarks of their owners: pass text and, if you have the rights, your own icons.

The copy result is announced in a status region; a failed copy shows a visible hint to select the address.

Examples

List with descriptions

variant="list": one row per channel, with a line on what people get there.

Feed only

An empty links array leaves just the copy button and address — a changelog or a blog.

Feed address: https://example.com/changelog/rss.xml

API

SubscribeLinks

PropTypeDefault
links
Where people can follow, best first. newTab defaults to true for absolute http(s) links.
{ label; href; icon?; description?; newTab?; primary? }[]—
feedUrl
RSS / Atom feed: adds the copy button and the visible address.
string—
showFeedUrl
Show the address under the links.
booleantrue
variant
A wrapping row of buttons, or rows with descriptions.
"buttons" | "list""buttons"
title / headingLevel
Heading that names the group; without it the group is named "Follow".
ReactNode / 2 | 3 | 4—
onCopyFeed
After the feed address was copied.
(url: string) => void—
labels
Dictionary namespace "subscribeLinks" (en, tr, de, fr, es, ar built in).
Partial<SubscribeLinksLabels>—