e.xyehr.cn
forked from
standard.site/standard.site
Standard.site landing page built in Next.js
aka.dad
1---
2title: Quick Start
3description: Getting started with Standard.site lexicons.
4date: 2026-02-10
5atUri: "at://did:plc:re3ebnp5v7ffagz6rb6xfei4/site.standard.document/3mek5jhkri72r"
6ogImage: opengraph-image-docs-quick-start-v2.png
7---
8
9import { StandardSite } from '@/app/components/docs'
10
11# Quick Start
12
13Get started with <StandardSite /> lexicons.
14
15## What You Need
16
17- An AT Protocol [Identity](https://atproto.com/guides/identity)
18- A website or blog (any domain works)
19
20## Basic Implementation
21
22### 1. Reference the Lexicons
23
24<StandardSite /> lexicons are published under the `site.standard` namespace. The main lexicons are:
25
26- [`site.standard.publication`](/docs/lexicons/publication) - Publication metadata
27- [`site.standard.document`](/docs/lexicons/document) - Document content and metadata
28- [`site.standard.graph.subscription`](/docs/lexicons/subscription) - User-publication relationships
29
30### 2. Create a Publication Record
31
32A publication requires a `url` and `name`:
33
34```json
35{
36 "$type": "site.standard.publication",
37 "url": "https://myblog.com",
38 "name": "My Blog",
39 "description": "A personal blog about technology",
40 "preferences": {
41 "showInDiscover": true
42 }
43}
44```
45
46### 3. Verify the Publication
47
48Add a `.well-known` endpoint to the domain:
49
50```
51https://myblog.com/.well-known/site.standard.publication
52```
53
54This should return the publication's AT-URI:
55
56```
57at://did:plc:yourDID/site.standard.publication/rkey
58```
59
60### 4. Create a Document Record
61
62Documents require `site`, `title`, and `publishedAt`:
63
64```json
65{
66 "$type": "site.standard.document",
67 "site": "at://did:plc:abc123/site.standard.publication/3lwafzkjqm25s",
68 "title": "My First Post",
69 "path": "/posts/my-first-post",
70 "description": "An introduction to my blog",
71 "publishedAt": "2024-01-20T14:30:00.000Z",
72 "tags": ["introduction", "blog"],
73 "textContent": "Full text content here..."
74}
75```
76
77### 5. Verify the Document
78
79Add a `<link>` tag to the document's HTML:
80
81```html
82<link
83 rel="site.standard.document"
84 href="at://did:plc:yourDID/site.standard.document/rkey"
85/>
86```
87
88## Extensibility
89
90While the minimum required properties are straightforward, additional properties can be added as needed. The lexicons are designed to be starting points, not constraints.
91
92## Next Steps
93
94- Learn about [Verification](/docs/verification) in detail
95- Explore the [Publication](/docs/lexicons/publication) schema
96- Review [Document](/docs/lexicons/document) properties and options
97- Check out [Implementations](/docs/implementations) for tools and examples