Project hub
A lightweight TypeScript SDK for displaying real-time Discord status, activities, and Spotify presence on websites, with support for modern web frameworks.
PresenceKit
Bring your Discord presence to your website.
PresenceKit is a lightweight TypeScript SDK for displaying real-time Discord status, games, Spotify activity, and more across modern web applications.
Built for JavaScript, TypeScript, React, Next.js, Vue, Svelte, and other frameworks.
Features
Live presence — Real-time updates using SSE with automatic polling fallback.
Rich activities — Games, Spotify tracks, custom statuses, and activity details.
Smart artwork — Automatic activity images with graceful fallbacks.
Developer-friendly — Typed APIs, React hooks, and ready-made UI components.
Privacy-first — Explicit opt-in sharing without requiring Discord credentials.
Quick Start
Install PresenceKit using your preferred package manager:
Retrieve a user's Discord presence:
import { createPresenceClient } from "@iconical/presencekit";
const client = createPresenceClient();
const data = await client.getPresence("DISCORD_USER_ID");
console.log(data.presence?.status);For React applications, use the ready-made component:
import { LivePresenceCard } from "@iconical/presencekit/react-ui";
<LivePresenceCard userId="DISCORD_USER_ID" />;For Non-Developers
You may use the card links, which is basically an SVG generator for readme, etc.
PresenceKit Cards
Privacy & Sharing
PresenceKit is entirely opt-in. Users enable sharing through the /confirm Discord command and can revoke access anytime using /disconnect.
Enable your Discord presence by joining our official Discord server below:
Resources
License
PresenceKit is available under the PresenceKit Source-Available License v1.0, permitting personal and commercial usage, modifications, and contributions under its terms.
Built with ❤️ by Iconical.