Lexicon Garden

me.linkna.linkinbio

A user's link-in-bio page containing cards, theme configuration, and social icons.

Repository @linkna.me did:plc:py7scbwsfz53fg2lniwggdgd namespace authority
Details · record, key literal:self
Kindrecord
Record keyliteral:self
Authoritylinkna.me
Indexed
Compare Edit in builder → Fork →

Record

record · key literal:self

Properties

socialIcons

array

Social media icons displayed on the profile.

itemsref
Reference

theme

string

Deprecated: use themeConfig instead.

themeConfig

ref
Reference

#connectedServices

object

Saved service credentials/identifiers for pre-filling widget forms.

Properties

githubUsername

string

GitHub username.

goodreadsUserId

string

Goodreads numeric user ID.

lastfmUsername

string

Last.fm username.

#githubContributionDay

object

A single day's contribution data from GitHub.

Properties

count

requiredinteger

Number of contributions on this day.

date

requiredstring

Date in YYYY-MM-DD format.

level

requiredinteger

Contribution intensity level (0=none, 4=highest).

  • minimum: 0
  • maximum: 4

#goodreadsBook

object

A book from a Goodreads shelf.

Properties

author

requiredstring

Book author.

coverUrl

string

URL to the book cover image.

rating

integer

User's rating (1-5), or absent if unrated.

  • minimum: 0
  • maximum: 5

title

requiredstring

Book title.

#headerCard

object

A section header/divider card.

Properties

alignment

string

Text alignment for the header. Defaults to the user's button alignment.

  • enum: left | center | right

enabled

boolean

Whether the header is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

text

requiredstring

Header text displayed as a section divider.

  • maxLength: 100

type

requiredstring

Card type discriminator.

  • const: "header"

#linkCard

object

A standard link card.

Properties

enabled

boolean

Whether the card is visible on the public page. Defaults to true.

highlighted

boolean

Whether the card is visually highlighted.

id

string

Unique identifier for the card.

text

string

Display text for the card (falls back to URL domain if empty).

  • maxLength: 100

type

string

Card type discriminator. Value: 'link' or absent for link cards.

url

string · uri

URL the card links to.

#mediumArticle

object

A Medium article.

Properties

claps

requiredinteger

Number of claps.

publishedAt

requiredstring

When the article was published.

readingTime

integer

Estimated reading time in minutes.

subtitle

string

Article subtitle.

title

requiredstring

Article title.

url

requiredstring

Article URL.

#redditPost

object

A Reddit post.

Properties

numComments

requiredinteger

Number of comments.

score

requiredinteger

Post score.

subreddit

requiredstring

Subreddit name.

title

requiredstring

Post title.

url

requiredstring

Post URL.

#socialIcon

object

A social media icon link.

Properties

id

requiredstring

Unique identifier for the icon.

platform

requiredstring

Platform identifier (e.g., 'bluesky', 'twitter', 'instagram').

url

requiredstring · uri

URL to the user's profile on this platform.

#tealfmPlay

object

A recently played track from teal.fm.

Properties

artistName

requiredstring

Artist name(s).

coverUrl

string

URL to the album cover image (from Cover Art Archive).

originUrl

string

URL to the track on the original music service.

playedTime

string · datetime

When the track was played.

releaseName

string

Album/release name.

trackName

requiredstring

Track/song name.

#themeConfig

object

Theme configuration for the page appearance.

Properties

backgroundColor

string

Page background color.

backgroundGradient

string

CSS gradient for the page background.

backgroundImage

blob

Background wallpaper image blob.

  • maxSize: 10000000
  • accept: image/png, image/jpeg, image/webp

backgroundImageCredit

string · uri

Optional credit URL for the wallpaper image artist. Stored for attribution purposes only, not displayed on the public page.

buttonAlignment

string

Button content alignment. Default: left.

  • knownValues: left | right

buttonHoverGlow

boolean

Whether buttons glow on hover. Default: false.

buttonHoverGlowColor

string

Color for the button hover glow effect.

cardBackgroundColor

string

Individual card/button background color.

cardBorderColor

string

Card/button border color.

cardBorderRadius

string

Card/button border radius.

  • knownValues: none | sm | md | lg | full

cardHoverColor

string

Card/button border color on hover.

cardShadow

string

Card/button shadow intensity.

  • knownValues: none | sm | md | lg | xl

cardTextColor

string

Card/button text color.

contentCardColor

string

Card container background color.

cursorSparkles

boolean

Whether cursor has sparkle trail. Default: false.

cursorStyle

string

Custom cursor style. Default: default.

  • knownValues: default | hello-kitty

fontFamily

string

Font family for the page.

fontSize

string

Font size. Default: md.

  • knownValues: sm | md | lg

particles

string

Background particle effect. Default: none.

  • knownValues: none | white | blue | leaves | grid-sm | grid-lg

preset

string

Theme preset ID (e.g., 'custom', 'agate', 'air', 'astrid', 'aura').

profileAlignment

string

Profile section alignment. Default: center.

  • knownValues: left | center | right

profilePictureShape

string

Profile picture shape. Default: circle.

  • knownValues: circle | rounded | square

profilePictureSize

string

Profile picture size. Default: sm.

  • knownValues: sm | md | lg

profileTextColor

string

Profile section text color.

showBranding

boolean

Whether Linkname branding is visible. Default: true.

socialIconsBorderColor

string

Border color for social icons dock/sphere.

socialIconsColor

string

Social icons color.

socialIconsShape

string

Social icons container shape. Default: dock.

  • knownValues: dock | sphere

socialIconsShapeColor

string

Background color for social icons dock/sphere.

#videoAspectRatio

object

Video aspect ratio dimensions.

Properties

height

requiredinteger

Video height.

width

requiredinteger

Video width.

#widgetBeehiiv

object

A Beehiiv publication widget card.

Properties

description

string

Publication description.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

imageUrl

string

Publication image URL.

lastSyncedAt

string · datetime

When the publication data was last fetched.

publicationId

requiredstring

Beehiiv publication ID.

publicationName

requiredstring

Beehiiv publication name.

publicationUrl

requiredstring

URL to the Beehiiv publication.

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

type

requiredstring

Card type discriminator.

  • const: "beehiiv"

#widgetClock

object

A clock, countdown, or stopwatch timer widget card.

Properties

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

label

string

Optional display label for the widget.

  • maxLength: 100

mode

requiredstring

Widget mode: clock (timezone display), countdown (to a target date), or timer (interactive stopwatch).

  • knownValues: clock | countdown | timer

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

targetDate

string · datetime

ISO 8601 target date for countdown mode.

timezone

string

IANA timezone identifier for clock mode (e.g. 'America/New_York').

type

requiredstring

Card type discriminator.

  • const: "clock"

#widgetDiscord

object

A Discord server widget card.

Properties

bannerUrl

string

Server banner URL.

description

string

Server description.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

iconUrl

string

Server icon URL.

id

requiredstring

Unique identifier for the card.

inviteUrl

requiredstring

Discord invite URL.

lastSyncedAt

string · datetime

When the server data was last fetched.

memberCount

integer

Total member count.

presenceCount

integer

Online member count.

serverId

requiredstring

Discord server ID.

serverName

requiredstring

Discord server name.

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

type

requiredstring

Card type discriminator.

  • const: "discord"

#widgetGithub

object

A GitHub contributions graph widget card.

Properties

contributions

requiredarray

Contribution data for the last year.

itemsref
Reference

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

githubUsername

requiredstring

GitHub username.

id

requiredstring

Unique identifier for the card.

lastSyncedAt

string · datetime

When the contribution data was last fetched from GitHub.

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2

totalContributions

integer

Total number of contributions in the last year.

type

requiredstring

Card type discriminator.

  • const: "github"

#widgetGoodreads

object

A Goodreads bookshelf widget card.

Properties

books

requiredarray

Books on the currently-reading shelf.

itemsref
Reference

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

goodreadsUserId

requiredstring

Goodreads numeric user ID.

id

requiredstring

Unique identifier for the card.

lastSyncedAt

string · datetime

When the book data was last fetched from Goodreads.

readBooks

array

Books on the read shelf (used by 1x2 size).

itemsref
Reference

shelf

requiredstring

Shelf name (currently-reading, read, or to-read).

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2

type

requiredstring

Card type discriminator.

  • const: "goodreads"

#widgetLastfm

object

A Last.fm recently played tracks widget card.

Properties

coverArtNotice

string

Copyright notice for cover art images.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

lastSyncedAt

string · datetime

When the play data was last fetched from Last.fm.

lastfmUsername

requiredstring

Last.fm username for fetching scrobbles.

plays

requiredarray

Recently played tracks from Last.fm.

itemsref
Reference

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2

type

requiredstring

Card type discriminator.

  • const: "lastfm"

#widgetMap

object

A map location widget card.

Properties

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

latitude

requiredstring

Latitude coordinate as string (AT Protocol does not support floats).

locationName

requiredstring

Display name for the location.

longitude

requiredstring

Longitude coordinate as string (AT Protocol does not support floats).

mapImageRef

blob

Cached static map image blob to avoid repeated Stadia Maps API calls.

  • maxSize: 5000000
  • accept: image/png, image/jpeg

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

style

string

Map style. Default: light.

  • knownValues: light | dark

type

requiredstring

Card type discriminator.

  • const: "map"

zoom

integer

Map zoom level (1-18). Default: 12.

#widgetMedium

object

A Medium profile widget card.

Properties

articles

array

Recent articles.

itemsref
Reference

bio

string

Medium bio.

displayName

string

Medium display name.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

followerCount

integer

Number of followers.

id

requiredstring

Unique identifier for the card.

lastSyncedAt

string · datetime

When the Medium data was last fetched.

profileUrl

requiredstring

Medium profile URL.

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

type

requiredstring

Card type discriminator.

  • const: "medium"

username

requiredstring

Medium username.

#widgetPatreon

object

A Patreon campaign widget card.

Properties

campaignId

requiredstring

Patreon campaign ID.

campaignUrl

requiredstring

URL to the Patreon campaign.

creationName

string

Name of the creation/project.

creatorName

requiredstring

Patreon creator name.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

imageUrl

string

Campaign image URL.

lastSyncedAt

string · datetime

When the campaign data was last fetched.

patronCount

integer

Number of patrons.

postCount

integer

Number of posts.

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

type

requiredstring

Card type discriminator.

  • const: "patreon"

#widgetReddit

object

A Reddit profile widget card.

Properties

avatarUrl

string

Reddit avatar URL.

commentKarma

integer

Comment karma.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

karma

integer

Total karma.

lastSyncedAt

string · datetime

When the Reddit data was last fetched.

linkKarma

integer

Link karma.

profileUrl

requiredstring

Reddit profile URL.

recentPosts

array

Recent posts.

itemsref
Reference

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

type

requiredstring

Card type discriminator.

  • const: "reddit"

username

requiredstring

Reddit username.

#widgetSubstack

object

A Substack publication widget card.

Properties

authorName

string

Author name.

coverImageUrl

string

Publication cover image URL.

description

string

Publication description.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

imageUrl

string

Publication image URL.

lastSyncedAt

string · datetime

When the publication data was last fetched.

postCount

integer

Number of posts.

publicationId

requiredstring

Substack publication ID.

publicationName

requiredstring

Substack publication name.

publicationUrl

requiredstring

URL to the Substack publication.

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

subscriberCount

integer

Number of subscribers.

type

requiredstring

Card type discriminator.

  • const: "substack"

#widgetTealfm

object

A teal.fm recently played tracks widget card.

Properties

coverArtNotice

string

Copyright notice for cover art images.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

lastSyncedAt

string · datetime

When the play data was last fetched from the PDS.

plays

requiredarray

Recently played tracks.

itemsref
Reference

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2

source

string

Data source for the widget. 'lastfm' for imported Last.fm scrobbles, 'tealfm' (default) for native AT Protocol plays.

  • knownValues: tealfm | lastfm

type

requiredstring

Card type discriminator.

  • const: "tealfm"

#widgetTwitch

object

A Twitch channel widget card.

Properties

displayName

string

Twitch display name.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

isLive

boolean

Whether the channel is currently live.

lastSyncedAt

string · datetime

When the channel data was last fetched.

profileImageUrl

string

Twitch profile image URL.

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

streamGame

string

Current stream game/category.

streamTitle

string

Current stream title.

type

requiredstring

Card type discriminator.

  • const: "twitch"

username

requiredstring

Twitch username.

viewerCount

integer

Current viewer count.

#widgetVideo

object

A video widget card.

Properties

alt

string

Alt text for accessibility.

  • maxLength: 1000

aspectRatio

ref

Video aspect ratio.

Reference

createdAt

string · datetime

When the video was uploaded.

did

requiredstring

Author DID for constructing PDS blob URLs.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

loop

boolean

Whether the video loops. Defaults to true.

muted

boolean

Whether the video is muted. Defaults to true.

showOverlay

boolean

Whether to show the title overlay. Defaults to false.

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

title

string

Video title overlay.

  • maxLength: 100

type

requiredstring

Card type discriminator.

  • const: "video"

videoBlobRef

requiredblob

Reference to the uploaded video blob.

#widgetYoutube

object

A YouTube channel widget card.

Properties

channelId

requiredstring

YouTube channel ID.

channelName

requiredstring

YouTube channel name.

channelUrl

requiredstring

URL to the YouTube channel.

enabled

boolean

Whether the widget is visible on the public page. Defaults to true.

id

requiredstring

Unique identifier for the card.

lastSyncedAt

string · datetime

When the video data was last fetched.

latestVideo

ref

The latest video from the channel.

Reference

size

string

Widget display size. Default: 1x1.

  • knownValues: 1x1 | 1x2 | 2x2 | 2x1

type

requiredstring

Card type discriminator.

  • const: "youtube"

#youtubeVideo

object

A YouTube video.

Properties

isShort

boolean

Whether this is a YouTube Short.

publishedAt

requiredstring

When the video was published.

title

requiredstring

Video title.

videoId

requiredstring

YouTube video ID.