···1414 "properties": {
1515 "path": {
1616 "type": "string",
1717- "description": "combine with the publication url or the document site to construct a full url to the document"
1717+ "description": "Combine with site or publication url to construct a canonical URL to the document. Prepend with a leading slash."
1818 },
1919 "site": {
2020 "type": "string",
2121 "format": "uri",
2222- "description": "URI to the site or publication this document belongs to (https or at-uri)"
2222+ "description": "Points to a publication record (at://) or a publication url (https://) for loose documents. Avoid trailing slashes."
2323 },
2424 "tags": {
2525 "type": "array",
···2727 "type": "string",
2828 "maxLength": 100,
2929 "maxGraphemes": 50
3030- }
3030+ },
3131+ "description": "Array of strings used to tag or categorize the document. Avoid prepending tags with hashtags."
3132 },
3233 "title": {
3334 "type": "string",
3435 "maxLength": 1280,
3636+ "description": "Title of the document.",
3537 "maxGraphemes": 128
3638 },
3739 "content": {
3840 "refs": [],
3941 "type": "union",
4040- "closed": false
4242+ "closed": false,
4343+ "description": "Open union used to define the record's content. Each entry must specify a $type and may be extended with other lexicons to support additional content formats."
4144 },
4245 "updatedAt": {
4346 "type": "string",
4444- "format": "datetime"
4747+ "format": "datetime",
4848+ "description": "Timestamp of the documents last edit."
4549 },
4650 "coverImage": {
4751 "type": "blob",
4852 "accept": [
4953 "image/*"
5054 ],
5151- "maxSize": 1000000
5555+ "maxSize": 1000000,
5656+ "description": "Image to used for thumbnail or cover image. Less than 1MB is size."
5257 },
5358 "bskyPostRef": {
5459 "ref": "com.atproto.repo.strongRef",
5555- "type": "ref"
6060+ "type": "ref",
6161+ "description": "Strong reference to a Bluesky post. Useful to keep track of comments off-platform."
5662 },
5763 "description": {
5864 "type": "string",
5965 "maxLength": 3000,
6666+ "description": "A brief description or excerpt from the document.",
6067 "maxGraphemes": 300
6168 },
6269 "publishedAt": {
6370 "type": "string",
6464- "format": "datetime"
7171+ "format": "datetime",
7272+ "description": "Timestamp of the documents publish time."
6573 },
6674 "textContent": {
6767- "type": "string"
7575+ "type": "string",
7676+ "description": "Plaintext representation of the documents contents. Should not contain markdown or other formatting."
6877 }
6978 }
7070- }
7979+ },
8080+ "description": "A document record representing a published article, blog post, or other content. Documents can belong to a publication or exist independently."
7181 }
7282 },
7383 "$type": "com.atproto.lexicon.schema",
+25
app/data/lexicons/graph.subscription.json
···11+{
22+ "id": "site.standard.graph.subscription",
33+ "defs": {
44+ "main": {
55+ "key": "tid",
66+ "type": "record",
77+ "record": {
88+ "type": "object",
99+ "required": [
1010+ "publication"
1111+ ],
1212+ "properties": {
1313+ "publication": {
1414+ "type": "string",
1515+ "format": "at-uri",
1616+ "description": "AT-URI reference to the publication record being subscribed to (ex: at://did:plc:abc123/site.standard.publication/xyz789)."
1717+ }
1818+ }
1919+ },
2020+ "description": "Record declaring a subscription to a publication"
2121+ }
2222+ },
2323+ "$type": "com.atproto.lexicon.schema",
2424+ "lexicon": 1
2525+}
+16-7
app/data/lexicons/publication.json
···1313 "properties": {
1414 "url": {
1515 "type": "string",
1616- "format": "uri"
1616+ "format": "uri",
1717+ "description": "Base publication url (ex: https://standard.site). The canonical document URL is formed by combining this value with the document path."
1718 },
1819 "icon": {
1920 "type": "blob",
2021 "accept": [
2122 "image/*"
2223 ],
2323- "maxSize": 1000000
2424+ "maxSize": 1000000,
2525+ "description": "Square image to identify the publication. Should be at least 256x256."
2426 },
2527 "name": {
2628 "type": "string",
2729 "maxLength": 1280,
3030+ "description": "Name of the publication.",
2831 "maxGraphemes": 128
2932 },
3033 "basicTheme": {
3134 "ref": "site.standard.theme.basic",
3232- "type": "ref"
3535+ "type": "ref",
3636+ "description": "Simplified publication theme for tools and apps to utilize when displaying content."
3337 },
3438 "description": {
3539 "type": "string",
3640 "maxLength": 3000,
4141+ "description": "Brief description of the publication.",
3742 "maxGraphemes": 300
3843 },
3944 "preferences": {
4045 "ref": "#preferences",
4141- "type": "ref"
4646+ "type": "ref",
4747+ "description": "Object containing platform specific preferences (with a few shared properties)."
4248 }
4349 }
4444- }
5050+ },
5151+ "description": "A publication record representing a blog, website, or content platform. Publications serve as containers for documents and define the overall branding and settings."
4552 },
4653 "preferences": {
4754 "type": "object",
4855 "properties": {
4956 "showInDiscover": {
5057 "type": "boolean",
5151- "default": true
5858+ "default": true,
5959+ "description": "Boolean which decides whether the publication should appear in discovery feeds."
5260 }
5353- }
6161+ },
6262+ "description": "Platform-specific preferences for the publication, including discovery and visibility settings."
5463 }
5564 },
5665 "$type": "com.atproto.lexicon.schema",
+10-5
app/data/lexicons/theme.basic.json
···1414 "refs": [
1515 "site.standard.theme.color#rgb"
1616 ],
1717- "type": "union"
1717+ "type": "union",
1818+ "description": "Color used for links and button backgrounds."
1819 },
1920 "background": {
2021 "refs": [
2122 "site.standard.theme.color#rgb"
2223 ],
2323- "type": "union"
2424+ "type": "union",
2525+ "description": "Color used for content background."
2426 },
2527 "foreground": {
2628 "refs": [
2729 "site.standard.theme.color#rgb"
2830 ],
2929- "type": "union"
3131+ "type": "union",
3232+ "description": "Color used for content text."
3033 },
3134 "accentForeground": {
3235 "refs": [
3336 "site.standard.theme.color#rgb"
3437 ],
3535- "type": "union"
3838+ "type": "union",
3939+ "description": "Color used for button text."
3640 }
3737- }
4141+ },
4242+ "description": "A simplified theme definition for publications, providing basic color customization for content display across different platforms and applications."
3843 }
3944 },
4045 "$type": "com.atproto.lexicon.schema",