"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.
Listen on
Feed address: https://example.com/podcast/feed.xml
Installation
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.
Follow the journal
- Weekly emailEvery Friday, the week's posts in one letter
- Feed reader (opens in a new tab)Atom feed for any reader app
- Reading listSaved pieces, updated monthly
Feed address: https://example.com/journal/atom.xml
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
| Prop | Type | Default |
|---|---|---|
linksWhere people can follow, best first. newTab defaults to true for absolute http(s) links. | { label; href; icon?; description?; newTab?; primary? }[] | — |
feedUrlRSS / Atom feed: adds the copy button and the visible address. | string | — |
showFeedUrlShow the address under the links. | boolean | true |
variantA wrapping row of buttons, or rows with descriptions. | "buttons" | "list" | "buttons" |
title / headingLevelHeading that names the group; without it the group is named "Follow". | ReactNode / 2 | 3 | 4 | — |
onCopyFeedAfter the feed address was copied. | (url: string) => void | — |
labelsDictionary namespace "subscribeLinks" (en, tr, de, fr, es, ar built in). | Partial<SubscribeLinksLabels> | — |