git.stevedylan.dev

chore: updated docs e51d33d5

Steve · 2026-01-31 20:31 2 file(s) · +26 −2

docs/docs/pages/config.mdx +8 −1

| `identity` | `string` | No | - | Which stored identity to use |
| `frontmatter` | `object` | No | - | Custom frontmatter field mappings |
| `ignore` | `string[]` | No | - | Glob patterns for files to ignore |
| `bluesky` | `object` | No | - | Bluesky posting configuration |
| `bluesky.enabled` | `boolean` | No | `false` | Post to Bluesky when publishing documents |
| `bluesky.maxAgeDays` | `number` | No | `30` | Only post documents published within this many days |

### Example


  "frontmatter": {
    "publishDate": "date"
  },
  "ignore": ["_index.md"]
  "ignore": ["_index.md"],
  "bluesky": {
    "enabled": true,
    "maxAgeDays": 30
  }
}
```


docs/docs/pages/publishing.mdx +18 −1

sequoia publish --dry-run
```

This will print out the posts that it has discovered, what will be published, and how many. Once everything looks good, send it!
This will print out the posts that it has discovered, what will be published, and how many. If Bluesky posting is enabled, it will also show which posts will be shared to Bluesky. Once everything looks good, send it!

```bash [Terminal]
sequoia publish

```

Sync will use your ATProto handle to look through all of the `standard.site.document` records on your PDS, and pull down the records that are for the publication in the config.

## Bluesky Posting

Sequoia can automatically post to Bluesky when new documents are published. Enable this in your config:

```json
{
  "bluesky": {
    "enabled": true,
    "maxAgeDays": 30
  }
}
```

When enabled, each new document will create a Bluesky post with the title, description, and canonical URL. If a cover image exists, it will be embedded in the post. The combined content is limited to 300 characters.

The `maxAgeDays` setting prevents flooding your feed when first setting up Sequoia. For example, if you have 40 existing blog posts, only those published within the last 30 days will be posted to Bluesky.

## Troubleshooting


15	15		\| `identity` \| `string` \| No \| - \| Which stored identity to use \|
16	16		\| `frontmatter` \| `object` \| No \| - \| Custom frontmatter field mappings \|
17	17		\| `ignore` \| `string[]` \| No \| - \| Glob patterns for files to ignore \|
	18	+	\| `bluesky` \| `object` \| No \| - \| Bluesky posting configuration \|
	19	+	\| `bluesky.enabled` \| `boolean` \| No \| `false` \| Post to Bluesky when publishing documents \|
	20	+	\| `bluesky.maxAgeDays` \| `number` \| No \| `30` \| Only post documents published within this many days \|
18	21
19	22		### Example
20	23

31	34		"frontmatter": {
32	35		"publishDate": "date"
33	36		},
34		-	"ignore": ["_index.md"]
	37	+	"ignore": ["_index.md"],
	38	+	"bluesky": {
	39	+	"enabled": true,
	40	+	"maxAgeDays": 30
	41	+	}
35	42		}
36	43		```
37	44

10	10		sequoia publish --dry-run
11	11		```
12	12
13		-	This will print out the posts that it has discovered, what will be published, and how many. Once everything looks good, send it!
	13	+	This will print out the posts that it has discovered, what will be published, and how many. If Bluesky posting is enabled, it will also show which posts will be shared to Bluesky. Once everything looks good, send it!
14	14
15	15		```bash [Terminal]
16	16		sequoia publish

27	27		```
28	28
29	29		Sync will use your ATProto handle to look through all of the `standard.site.document` records on your PDS, and pull down the records that are for the publication in the config.
	30	+
	31	+	## Bluesky Posting
	32	+
	33	+	Sequoia can automatically post to Bluesky when new documents are published. Enable this in your config:
	34	+
	35	+	```json
	36	+	{
	37	+	"bluesky": {
	38	+	"enabled": true,
	39	+	"maxAgeDays": 30
	40	+	}
	41	+	}
	42	+	```
	43	+
	44	+	When enabled, each new document will create a Bluesky post with the title, description, and canonical URL. If a cover image exists, it will be embedded in the post. The combined content is limited to 300 characters.
	45	+
	46	+	The `maxAgeDays` setting prevents flooding your feed when first setting up Sequoia. For example, if you have 40 existing blog posts, only those published within the last 30 days will be posted to Bluesky.
30	47
31	48		## Troubleshooting
32	49