org.hypercerts.collection

hypercerts.org

Documentation

A collection/group of items (activities and/or other collections). Collections support recursive nesting.

main record

A collection/group of items (activities and/or other collections). Collections support recursive nesting.

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

Client-declared timestamp when this record was originally created

items array of ref #item Optional

Array of items in this collection with optional weights.

maxLength: 1000 items
location ref com.atproto.repo.strongRef Optional

A strong reference to the location where this collection's activities were performed. The record referenced must conform with the lexicon app.certified.location.

shortDescription string Optional

Short summary of this collection, suitable for previews and list views. Rich text annotations may be provided via `shortDescriptionFacets`.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes
shortDescriptionFacets array of ref app.bsky.richtext.facet Optional

Rich text annotations for `shortDescription` (mentions, URLs, hashtags, etc).

tags array of ref com.atproto.repo.strongRef Optional

References to org.hypercerts.vocab.tag records classifying this record. All listed tags apply simultaneously (logical AND); the array carries no ordering, weighting, negation, inheritance, or rule logic, and never will — any future expression logic must arrive as a new field and must never reinterpret this one.

maxLength: 20 items
title string Required

Display name for this collection (e.g. 'Q1 2025 Impact Projects')

maxLength: 800 bytesmaxGraphemes: 80 graphemes
type string Optional

The type of this collection. Values beyond the known set are permitted.

maxLength: 64 bytes
Known values: favorites, project, portfolio, program
View raw schema 
{
  "description": "A collection/group of items (activities and/or other collections). Collections support recursive nesting.",
  "key": "tid",
  "record": {
    "properties": {
      "avatar": {
        "description": "The collection's avatar/profile image as a URI or image blob.",
        "refs": [
          "org.hypercerts.defs#uri",
          "org.hypercerts.defs#smallImage"
        ],
        "type": "union"
      },
      "banner": {
        "description": "Larger horizontal image to display behind the collection view.",
        "refs": [
          "org.hypercerts.defs#uri",
          "org.hypercerts.defs#largeImage"
        ],
        "type": "union"
      },
      "createdAt": {
        "description": "Client-declared timestamp when this record was originally created",
        "format": "datetime",
        "type": "string"
      },
      "description": {
        "description": "Long-form description of the collection. An inline string for plain text or markdown, a Leaflet linear document for rich-text content, or a strong reference to an external description record.",
        "refs": [
          "org.hypercerts.defs#descriptionString",
          "pub.leaflet.pages.linearDocument",
          "com.atproto.repo.strongRef"
        ],
        "type": "union"
      },
      "items": {
        "description": "Array of items in this collection with optional weights.",
        "items": {
          "ref": "#item",
          "type": "ref"
        },
        "maxLength": 1000,
        "type": "array"
      },
      "location": {
        "description": "A strong reference to the location where this collection's activities were performed. The record referenced must conform with the lexicon app.certified.location.",
        "ref": "com.atproto.repo.strongRef",
        "type": "ref"
      },
      "shortDescription": {
        "description": "Short summary of this collection, suitable for previews and list views. Rich text annotations may be provided via `shortDescriptionFacets`.",
        "maxGraphemes": 300,
        "maxLength": 3000,
        "type": "string"
      },
      "shortDescriptionFacets": {
        "description": "Rich text annotations for `shortDescription` (mentions, URLs, hashtags, etc).",
        "items": {
          "ref": "app.bsky.richtext.facet",
          "type": "ref"
        },
        "type": "array"
      },
      "signatures": {
        "description": "Optional cryptographic signatures attesting to this record's content.",
        "ref": "app.certified.signature.defs#list",
        "type": "ref"
      },
      "tags": {
        "description": "References to org.hypercerts.vocab.tag records classifying this record. All listed tags apply simultaneously (logical AND); the array carries no ordering, weighting, negation, inheritance, or rule logic, and never will — any future expression logic must arrive as a new field and must never reinterpret this one.",
        "items": {
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "maxLength": 20,
        "type": "array"
      },
      "title": {
        "description": "Display name for this collection (e.g. 'Q1 2025 Impact Projects')",
        "maxGraphemes": 80,
        "maxLength": 800,
        "type": "string"
      },
      "type": {
        "description": "The type of this collection. Values beyond the known set are permitted.",
        "knownValues": [
          "favorites",
          "project",
          "portfolio",
          "program"
        ],
        "maxLength": 64,
        "type": "string"
      }
    },
    "required": [
      "title",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
item object

An item in a collection, with an identifier and optional weight.

Properties

itemIdentifier ref com.atproto.repo.strongRef Required

Strong reference to an item in this collection. Items can be activities (org.hypercerts.claim.activity), features (org.hypercerts.entity.feature), and/or other collections (org.hypercerts.collection).

itemWeight string Optional

Optional weight for this item (positive numeric value stored as string). Weights do not need to sum to a specific total; normalization can be performed by the consuming application as needed.

maxLength: 100 bytes
View raw schema 
{
  "description": "An item in a collection, with an identifier and optional weight.",
  "properties": {
    "itemIdentifier": {
      "description": "Strong reference to an item in this collection. Items can be activities (org.hypercerts.claim.activity), features (org.hypercerts.entity.feature), and/or other collections (org.hypercerts.collection).",
      "ref": "com.atproto.repo.strongRef",
      "type": "ref"
    },
    "itemWeight": {
      "description": "Optional weight for this item (positive numeric value stored as string). Weights do not need to sum to a specific total; normalization can be performed by the consuming application as needed.",
      "maxLength": 100,
      "type": "string"
    }
  },
  "required": [
    "itemIdentifier"
  ],
  "type": "object"
}

Lexicon Garden

@