Lexicons

{
  "lexicon": 1,
  "id": "app.standard-reader.labeler.defs",
  "defs": {
    "labelerPolicies": {
      "type": "object",
      "required": [
        "labelValues"
      ],
      "properties": {
        "labelValues": {
          "type": "array",
          "items": {
            "type": "ref",
            "ref": "com.atproto.label.defs#labelValue"
          },
          "description": "The label values which this labeler publishes. May include global or custom (labeler-defined) values."
        },
        "labelValueDefinitions": {
          "type": "array",
          "items": {
            "type": "ref",
            "ref": "com.atproto.label.defs#labelValueDefinition"
          },
          "description": "Label values created by this labeler and scoped exclusively to it. Each value provides its own meaning and behaviors."
        }
      }
    },
    "labelerView": {
      "type": "object",
      "required": [
        "did"
      ],
      "properties": {
        "did": {
          "type": "string",
          "format": "did"
        },
        "displayName": {
          "type": "string",
          "maxGraphemes": 64,
          "maxLength": 640
        },
        "description": {
          "type": "string",
          "maxGraphemes": 300,
          "maxLength": 3000
        },
        "avatar": {
          "type": "string",
          "format": "uri"
        },
        "policies": {
          "type": "ref",
          "ref": "#labelerPolicies"
        },
        "indexedAt": {
          "type": "string",
          "format": "datetime"
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.collection",
  "defs": {
    "main": {
      "type": "record",
      "description": "Curated magazine collection manifest for a site.standard.document. Uses the same record key as the document it extends so both records can be fetched with one predictable pair of GETs.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "document",
          "items",
          "createdAt"
        ],
        "properties": {
          "document": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the site.standard.document record this collection renders."
          },
          "editorial": {
            "type": "ref",
            "ref": "app.standard-reader.collection#editorial"
          },
          "colophon": {
            "type": "ref",
            "ref": "app.standard-reader.collection#colophon"
          },
          "items": {
            "type": "array",
            "maxLength": 42,
            "items": {
              "type": "ref",
              "ref": "app.standard-reader.collection#item"
            },
            "description": "Ordered curated articles plus optional per-item notes."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the collection manifest was first published."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the collection manifest was last edited."
          }
        }
      }
    },
    "editorial": {
      "type": "object",
      "description": "Optional editorial intro shown ahead of the curated pieces.",
      "properties": {
        "title": {
          "type": "string",
          "maxLength": 160
        },
        "body": {
          "type": "union",
          "refs": [
            "at.markpub.markdown"
          ],
          "description": "Editorial body as Markpub markdown (legacy plain string accepted on read during migration)."
        }
      }
    },
    "colophon": {
      "type": "object",
      "description": "Optional closing credits on the magazine end spread.",
      "properties": {
        "body": {
          "type": "union",
          "refs": [
            "at.markpub.markdown"
          ],
          "description": "Colophon body as Markpub markdown (legacy plain string accepted on read during migration)."
        }
      }
    },
    "item": {
      "type": "object",
      "required": [
        "document"
      ],
      "properties": {
        "document": {
          "type": "string",
          "format": "at-uri",
          "description": "AT URI of an included site.standard.document."
        },
        "note": {
          "type": "union",
          "refs": [
            "at.markpub.markdown"
          ],
          "description": "Optional Markpub markdown note shown ahead of the piece (legacy plain string accepted on read during migration)."
        }
      }
    },
    "documentLink": {
      "type": "object",
      "required": [
        "uri"
      ],
      "description": "Inverse link entry for site.standard.document#links pointing back at this collection sidecar.",
      "properties": {
        "uri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT URI of the app.standard-reader.collection sidecar record."
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.collectionsPublication",
  "defs": {
    "main": {
      "type": "record",
      "description": "Marks a site.standard.publication as a Standard Reader collections series. Uses the same record key as the publication it marks.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "publication",
          "createdAt"
        ],
        "properties": {
          "publication": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the site.standard.publication record used to publish collections."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When this publication was marked as a collections series."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.graph.follow",
  "defs": {
    "main": {
      "type": "record",
      "description": "Follows another user (a DID, not a publication). Presence of the record means followed; deleting it unfollows. The rkey is derived from the subject DID so each followed user maps to a single record. A followed user's recommends and documents enrich the reader's home feed.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "subject",
          "createdAt"
        ],
        "properties": {
          "subject": {
            "type": "string",
            "format": "did",
            "description": "DID of the user being followed."
          },
          "excludedPublications": {
            "type": "array",
            "maxLength": 1000,
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "description": "Publications owned by the followed user that the reader has explicitly opted out of (following a user subscribes to all their publications except these). AT URIs of site.standard.publication records."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the reader followed the user."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.labeler.subscription",
  "defs": {
    "main": {
      "type": "record",
      "description": "Subscribes the reader to a labeler service (like adding a Bluesky moderation service). Presence of the record means subscribed; deleting it unsubscribes. The rkey is derived from the labeler DID so each labeler maps to a single record. Successor to app.standard-reader.labelerSubscription, nested under the labeler NSID group.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "labeler",
          "createdAt"
        ],
        "properties": {
          "labeler": {
            "type": "string",
            "format": "did",
            "description": "DID of the labeler service being subscribed to."
          },
          "labels": {
            "type": "array",
            "description": "Per-label visibility overrides for this labeler's label values.",
            "items": {
              "type": "ref",
              "ref": "#labelPref"
            }
          },
          "enabled": {
            "type": "boolean",
            "default": true,
            "description": "Whether this labeler's labels are applied while reading. `false` keeps the subscription (and its per-label preferences) but stops the labeler acting here — for a labeler the reader wants on another app but not this one. Absent means enabled."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the reader subscribed to the labeler."
          }
        }
      }
    },
    "labelPref": {
      "type": "object",
      "description": "How the reader wants a single label value from this labeler treated.",
      "required": [
        "val",
        "visibility"
      ],
      "properties": {
        "val": {
          "type": "string",
          "maxLength": 128,
          "description": "The label value this preference applies to."
        },
        "visibility": {
          "type": "string",
          "maxLength": 16,
          "knownValues": [
            "ignore",
            "warn",
            "hide"
          ],
          "description": "ignore = show normally; warn = content warning / blur; hide = filter out."
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.labelerSubscription",
  "defs": {
    "main": {
      "type": "record",
      "description": "Subscribes the reader to a labeler service (like adding a Bluesky moderation service). Presence of the record means subscribed; deleting it unsubscribes. The rkey is derived from the labeler DID so each labeler maps to a single record.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "labeler",
          "createdAt"
        ],
        "properties": {
          "labeler": {
            "type": "string",
            "format": "did",
            "description": "DID of the labeler service being subscribed to."
          },
          "labels": {
            "type": "array",
            "description": "Per-label visibility overrides for this labeler's label values.",
            "items": {
              "type": "ref",
              "ref": "#labelPref"
            }
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the reader subscribed to the labeler."
          }
        }
      }
    },
    "labelPref": {
      "type": "object",
      "description": "How the reader wants a single label value from this labeler treated.",
      "required": [
        "val",
        "visibility"
      ],
      "properties": {
        "val": {
          "type": "string",
          "maxLength": 128,
          "description": "The label value this preference applies to."
        },
        "visibility": {
          "type": "string",
          "maxLength": 16,
          "knownValues": [
            "ignore",
            "warn",
            "hide"
          ],
          "description": "ignore = show normally; warn = content warning / blur; hide = filter out."
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.list",
  "defs": {
    "main": {
      "type": "record",
      "description": "A named, ordered, shareable list of publications (like a Bluesky user list, but for site.standard.publication subscriptions). Lists are one level deep; a publication may appear in multiple lists.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": [
          "name",
          "publications",
          "createdAt"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 640,
            "maxGraphemes": 64,
            "description": "Display name of the list."
          },
          "description": {
            "type": "string",
            "maxLength": 3000,
            "maxGraphemes": 300,
            "description": "Optional description shown on the list's public page."
          },
          "publications": {
            "type": "array",
            "maxLength": 500,
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "description": "Ordered AT URIs of the site.standard.publication records in this list."
          },
          "users": {
            "type": "array",
            "maxLength": 500,
            "items": {
              "type": "string",
              "format": "did"
            },
            "description": "Ordered DIDs of the users (authors) in this list. Optional; a list may hold publications, users, or both."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the list was created."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.listSave",
  "defs": {
    "main": {
      "type": "record",
      "description": "Saves another reader's app.standard-reader.list into this reader's app (like adding a Bluesky list). Presence of the record means saved; deleting it removes the list again.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "list",
          "createdAt"
        ],
        "properties": {
          "list": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the app.standard-reader.list record being saved."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the list was saved."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.publicationTheme",
  "defs": {
    "main": {
      "type": "record",
      "description": "Standard Reader typography for a collections publication. Uses the same record key as the publication. Colors remain on the publication's site.standard.theme.basic record.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "publication",
          "createdAt"
        ],
        "properties": {
          "publication": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the site.standard.publication this theme applies to."
          },
          "fonts": {
            "type": "ref",
            "ref": "app.standard-reader.publicationTheme#fonts"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the theme record was first published."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the theme record was last edited."
          }
        }
      }
    },
    "fonts": {
      "type": "object",
      "description": "Google Font family names for collection title and body typography.",
      "properties": {
        "title": {
          "type": "string",
          "maxLength": 60
        },
        "body": {
          "type": "string",
          "maxLength": 60
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.read",
  "defs": {
    "main": {
      "type": "record",
      "description": "Marks a site.standard.document as read by the reader. Presence of the record means read; deleting it marks the article unread again.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "subject",
          "createdAt"
        ],
        "properties": {
          "subject": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the site.standard.document record that was read."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the reader opened / marked the article read."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.standard-reader.sidebarPref",
  "defs": {
    "main": {
      "type": "record",
      "description": "A reader's personal sidebar preferences: the top-level arrangement of list groups and ungrouped subscriptions (one level deep), which groups are collapsed, how automatic sort orders subscriptions, and which primary nav items are hidden. A singleton record (rkey `self`).",
      "key": "literal:self",
      "record": {
        "type": "object",
        "required": [
          "updatedAt"
        ],
        "properties": {
          "listOrder": {
            "type": "array",
            "maxLength": 1000,
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "description": "Legacy: ordered AT URIs of the reader's list groups (own + saved), used as a fallback top-level list order only while `treeOrder` is empty. Superseded by `treeOrder`, which also carries ungrouped subscriptions interleaved with lists; new writes should prefer `treeOrder`."
          },
          "treeOrder": {
            "type": "array",
            "maxLength": 2000,
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Manual top-level order of the sidebar's subscriptions tree: list-group AT URIs interleaved with ungrouped publication AT URIs / person DIDs, exactly as arranged via drag-and-drop. Applies only when `subscriptionSort` is 'default'. Entries not present are appended in their natural order. Takes precedence over the legacy `listOrder` once populated."
          },
          "subscriptionSort": {
            "type": "string",
            "maxLength": 16,
            "knownValues": [
              "default",
              "recent",
              "alpha",
              "unread"
            ],
            "description": "How the sidebar's subscriptions are ordered: 'default' (the reader's manual arrangement per `treeOrder`, or natural/stored order — the default), 'recent' (most recent activity first, interleaving publications and people), 'alpha' (name), or 'unread' (highest unread count first). Absent means 'default'."
          },
          "collapsed": {
            "type": "array",
            "maxLength": 1000,
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "description": "AT URIs of the list groups the reader has collapsed in the sidebar."
          },
          "customizeNav": {
            "type": "boolean",
            "description": "Whether the reader has enabled 'Customize sidebar'. When true, the `hiddenNav` items are hidden; when false or absent, every primary nav item is shown regardless of `hiddenNav`."
          },
          "hiddenNav": {
            "type": "array",
            "maxLength": 32,
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Stable ids of the primary sidebar nav items the reader has hidden (e.g. 'home', 'latest', 'discover', 'search', 'saved', 'collections'). Subscriptions and its list groups are never hideable."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "description": "When these preferences were last changed."
          }
        }
      }
    }
  }
}