social.colibri.beta.actor.profile

colibri.social

Documentation

A Colibri profile. A public record on the user's own repo, kept separate from app.bsky.actor.profile so Colibri never needs write access to the Bluesky record.

main record

A Colibri profile. A public record on the user's own repo, kept separate from app.bsky.actor.profile so Colibri never needs write access to the Bluesky record.

Record Key literal:self Fixed literal value

Properties

avatar blob Optional

Avatar image.

banner blob Optional

Profile banner image.

description string Optional

Bio.

maxLength: 2560 bytesmaxGraphemes: 256 graphemes
displayName string Optional

Display name.

maxLength: 640 bytesmaxGraphemes: 64 graphemes
preferredBadge string Optional

Label value of the badge to display. Absent means the highest-priority badge.

maxLength: 64 bytes
syncBluesky boolean Optional

When true, displayName, description, avatar and banner are served from app.bsky.actor.profile instead of from this record.

Default: false
theme ref #theme Optional

Colibri-only profile theming.

View raw schema
{
  "key": "literal:self",
  "type": "record",
  "record": {
    "type": "object",
    "required": [],
    "properties": {
      "theme": {
        "ref": "#theme",
        "type": "ref",
        "description": "Colibri-only profile theming."
      },
      "avatar": {
        "type": "blob",
        "accept": [
          "image/jpeg",
          "image/png",
          "image/gif",
          "image/webp"
        ],
        "description": "Avatar image."
      },
      "banner": {
        "type": "blob",
        "accept": [
          "image/jpeg",
          "image/png",
          "image/gif",
          "image/webp"
        ],
        "description": "Profile banner image."
      },
      "description": {
        "type": "string",
        "maxLength": 2560,
        "description": "Bio.",
        "maxGraphemes": 256
      },
      "displayName": {
        "type": "string",
        "maxLength": 640,
        "description": "Display name.",
        "maxGraphemes": 64
      },
      "syncBluesky": {
        "type": "boolean",
        "default": false,
        "description": "When true, displayName, description, avatar and banner are served from app.bsky.actor.profile instead of from this record."
      },
      "preferredBadge": {
        "type": "string",
        "maxLength": 64,
        "description": "Label value of the badge to display. Absent means the highest-priority badge."
      }
    }
  },
  "description": "A Colibri profile. A public record on the user's own repo, kept separate from app.bsky.actor.profile so Colibri never needs write access to the Bluesky record."
}
theme object

Colibri-only profile theming. Always read from this record, even when syncBluesky is set.

Properties

accentColor string Optional

Accent colour as #rrggbb.

maxLength: 7 bytes
bannerColor string Optional

Fallback banner colour as #rrggbb, used when no banner image is set.

maxLength: 7 bytes
View raw schema
{
  "type": "object",
  "required": [],
  "properties": {
    "gradient": {
      "ref": "#themeGradient",
      "type": "ref",
      "description": "Two-colour gradient."
    },
    "accentColor": {
      "type": "string",
      "maxLength": 7,
      "description": "Accent colour as #rrggbb."
    },
    "bannerColor": {
      "type": "string",
      "maxLength": 7,
      "description": "Fallback banner colour as #rrggbb, used when no banner image is set."
    }
  },
  "description": "Colibri-only profile theming. Always read from this record, even when syncBluesky is set."
}
themeGradient object

A two-colour gradient.

Properties

primary string Optional

Primary colour as #rrggbb.

maxLength: 7 bytes
secondary string Optional

Secondary colour as #rrggbb.

maxLength: 7 bytes
View raw schema
{
  "type": "object",
  "required": [],
  "properties": {
    "primary": {
      "type": "string",
      "maxLength": 7,
      "description": "Primary colour as #rrggbb."
    },
    "secondary": {
      "type": "string",
      "maxLength": 7,
      "description": "Secondary colour as #rrggbb."
    }
  },
  "description": "A two-colour gradient."
}

Lexicon Garden

@