# app.kimbia.share

> Published by [kimbia.app](https://lexicon.garden/identity/did:plc:gktrthagvfvzkotyr3n2foox)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:gktrthagvfvzkotyr3n2foox/app.kimbia.share)
- [Documentation](https://lexicon.garden/lexicon/did:plc:gktrthagvfvzkotyr3n2foox/app.kimbia.share/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:gktrthagvfvzkotyr3n2foox/app.kimbia.share/examples)

## Definitions

### `app.kimbia.share`

**Type**: `record`

One social share of a Kimbia activity or adventure (e.g. a post to Bluesky). A share is public by nature - it links the external post back to the underlying activity record.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `image` | `blob` | Yes | The baked share card image. |
| `layout` | `string` | Yes | The visual layout used to render the share card. |
| `platform` | `string` | Yes | Where this share was posted. |
| `createdAt` | `string` (datetime) | Yes | When the share was created. |
| `activityRef` | `string` | No | AT-URI of the published activity (or adventure) record this share is about. Absent until the underlying record is itself published. |
| `externalUri` | `string` | Yes | AT-URI of the published external post (e.g. the Bluesky post). |

## Raw Schema

```json
{
  "id": "app.kimbia.share",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "platform",
          "layout",
          "externalUri",
          "image",
          "createdAt"
        ],
        "properties": {
          "image": {
            "type": "blob",
            "accept": [
              "image/png",
              "image/jpeg"
            ],
            "maxSize": 2000000,
            "description": "The baked share card image."
          },
          "layout": {
            "type": "string",
            "maxLength": 128,
            "description": "The visual layout used to render the share card.",
            "knownValues": [
              "laUne",
              "feuillet"
            ]
          },
          "platform": {
            "type": "string",
            "maxLength": 128,
            "description": "Where this share was posted.",
            "knownValues": [
              "bsky"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the share was created."
          },
          "activityRef": {
            "type": "string",
            "maxLength": 2048,
            "description": "AT-URI of the published activity (or adventure) record this share is about. Absent until the underlying record is itself published."
          },
          "externalUri": {
            "type": "string",
            "maxLength": 2048,
            "description": "AT-URI of the published external post (e.g. the Bluesky post)."
          }
        }
      },
      "description": "One social share of a Kimbia activity or adventure (e.g. a post to Bluesky). A share is public by nature - it links the external post back to the underlying activity record."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```