Quick Start

Get started with Standard.site lexicons.

What You Need

• An AT Protocol Identity
• A website or blog (any domain works)

Basic Implementation

1. Reference the Lexicons

Standard.site lexicons are published under the site.standard namespace. The main lexicons are:

• site.standard.publication - Publication metadata
• site.standard.document - Document content and metadata
• site.standard.graph.subscription - User-publication relationships

2. Create a Publication Record

A publication requires a url and name:

{
  "$type": "site.standard.publication",
  "url": "https://myblog.com",
  "name": "My Blog",
  "description": "A personal blog about technology",
  "preferences": {
    "showInDiscover": true
  }
}

3. Verify the Publication

Add a .well-known endpoint to the domain:

https://myblog.com/.well-known/site.standard.publication

This should return the publication's AT-URI:

at://did:plc:yourDID/site.standard.publication/rkey

4. Create a Document Record

Documents require site, title, and publishedAt:

{
  "$type": "site.standard.document",
  "site": "at://did:plc:abc123/site.standard.publication/3lwafzkjqm25s",
  "title": "My First Post",
  "path": "/posts/my-first-post",
  "description": "An introduction to my blog",
  "publishedAt": "2024-01-20T14:30:00.000Z",
  "tags": ["introduction", "blog"],
  "textContent": "Full text content here..."
}

5. Verify the Document

Add a <link> tag to the document's HTML:

<link
  rel="site.standard.document"
  href="at://did:plc:yourDID/site.standard.document/rkey"
/>

Extensibility

While the minimum required properties are straightforward, additional properties can be added as needed. The lexicons are designed to be starting points, not constraints.

Next Steps

• Learn about Verification in detail
• Explore the Publication schema
• Review Document properties and options
• Check out Implementations for tools and examples