WIP! A BB-style forum, on the ATmosphere!
We're still working... we'll be back soon when we have something to show off!
node
typescript
hono
htmx
atproto
docs(bruno): add Admin Themes collection for ATB-57 write endpoints
+199
+54
bruno/AppView API/Admin Themes/Create Theme.bru
+54
bruno/AppView API/Admin Themes/Create Theme.bru
···
1
+
meta {
2
+
name: Create Theme
3
+
type: http
4
+
seq: 1
5
+
}
6
+
7
+
post {
8
+
url: {{appview_url}}/api/admin/themes
9
+
}
10
+
11
+
body:json {
12
+
{
13
+
"name": "Neobrutal Light",
14
+
"colorScheme": "light",
15
+
"tokens": {
16
+
"color-bg": "#f5f0e8",
17
+
"color-text": "#1a1a1a",
18
+
"color-primary": "#ff5c00"
19
+
},
20
+
"fontUrls": ["https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;700"]
21
+
}
22
+
}
23
+
24
+
assert {
25
+
res.status: eq 201
26
+
res.body.uri: isDefined
27
+
res.body.cid: isDefined
28
+
}
29
+
30
+
docs {
31
+
Create a new theme record on the Forum DID's PDS.
32
+
The firehose indexer creates the DB row asynchronously.
33
+
34
+
**Requires:** space.atbb.permission.manageThemes
35
+
36
+
Body:
37
+
- name (required): Theme display name, non-empty
38
+
- colorScheme (required): "light" or "dark"
39
+
- tokens (required): Plain object of CSS design token key-value pairs. Values must be strings.
40
+
- cssOverrides (optional): Raw CSS string for structural overrides (not rendered until ATB-62 sanitization ships)
41
+
- fontUrls (optional): Array of HTTPS URLs for font stylesheets
42
+
43
+
Returns (201):
44
+
{
45
+
"uri": "at://did:plc:.../space.atbb.forum.theme/abc123",
46
+
"cid": "bafyrei..."
47
+
}
48
+
49
+
Error codes:
50
+
- 400: Missing name/colorScheme/tokens, invalid colorScheme, non-HTTPS fontUrl, token value not a string, malformed JSON
51
+
- 401: Not authenticated
52
+
- 403: Missing manageThemes permission
53
+
- 503: ForumAgent not configured or PDS network error
54
+
}
+36
bruno/AppView API/Admin Themes/Delete Theme.bru
+36
bruno/AppView API/Admin Themes/Delete Theme.bru
···
1
+
meta {
2
+
name: Delete Theme
3
+
type: http
4
+
seq: 3
5
+
}
6
+
7
+
delete {
8
+
url: {{appview_url}}/api/admin/themes/{{theme_rkey}}
9
+
}
10
+
11
+
assert {
12
+
res.status: eq 200
13
+
res.body.success: eq true
14
+
}
15
+
16
+
docs {
17
+
Delete a theme record. Fails with 409 if the theme is currently set as
18
+
the defaultLightTheme or defaultDarkTheme in the theme policy.
19
+
20
+
**Requires:** space.atbb.permission.manageThemes
21
+
22
+
Path params:
23
+
- rkey: Theme record key (TID)
24
+
25
+
Returns (200):
26
+
{
27
+
"success": true
28
+
}
29
+
30
+
Error codes:
31
+
- 401: Not authenticated
32
+
- 403: Missing manageThemes permission
33
+
- 404: Theme not found
34
+
- 409: Theme is the current defaultLightTheme or defaultDarkTheme — update theme policy first
35
+
- 503: ForumAgent not configured or PDS network error
36
+
}
+56
bruno/AppView API/Admin Themes/Update Theme Policy.bru
+56
bruno/AppView API/Admin Themes/Update Theme Policy.bru
···
1
+
meta {
2
+
name: Update Theme Policy
3
+
type: http
4
+
seq: 4
5
+
}
6
+
7
+
put {
8
+
url: {{appview_url}}/api/admin/theme-policy
9
+
}
10
+
11
+
body:json {
12
+
{
13
+
"availableThemes": [
14
+
{ "uri": "at://did:plc:example/space.atbb.forum.theme/3lbllight1", "cid": "bafylight" },
15
+
{ "uri": "at://did:plc:example/space.atbb.forum.theme/3lbldark11", "cid": "bafydark" }
16
+
],
17
+
"defaultLightThemeUri": "at://did:plc:example/space.atbb.forum.theme/3lbllight1",
18
+
"defaultDarkThemeUri": "at://did:plc:example/space.atbb.forum.theme/3lbldark11",
19
+
"allowUserChoice": true
20
+
}
21
+
}
22
+
23
+
assert {
24
+
res.status: eq 200
25
+
res.body.uri: isDefined
26
+
res.body.cid: isDefined
27
+
}
28
+
29
+
docs {
30
+
Create or update the themePolicy singleton on the Forum DID's PDS.
31
+
Uses upsert semantics: works whether or not a policy record exists yet.
32
+
33
+
**Requires:** space.atbb.permission.manageThemes
34
+
35
+
Body:
36
+
- availableThemes (required): Non-empty array of { uri, cid } theme references.
37
+
Both defaultLightThemeUri and defaultDarkThemeUri must be present in this list.
38
+
- defaultLightThemeUri (required): AT-URI of the default light-mode theme.
39
+
Must be in availableThemes.
40
+
- defaultDarkThemeUri (required): AT-URI of the default dark-mode theme.
41
+
Must be in availableThemes.
42
+
- allowUserChoice (optional, default true): Whether users can pick their own theme.
43
+
44
+
Returns (200):
45
+
{
46
+
"uri": "at://did:plc:.../space.atbb.forum.themePolicy/self",
47
+
"cid": "bafyrei..."
48
+
}
49
+
50
+
Error codes:
51
+
- 400: Missing/empty availableThemes, missing defaultLightThemeUri/defaultDarkThemeUri,
52
+
default URI not in availableThemes list, malformed JSON
53
+
- 401: Not authenticated
54
+
- 403: Missing manageThemes permission
55
+
- 503: ForumAgent not configured or PDS network error
56
+
}
+53
bruno/AppView API/Admin Themes/Update Theme.bru
+53
bruno/AppView API/Admin Themes/Update Theme.bru
···
1
+
meta {
2
+
name: Update Theme
3
+
type: http
4
+
seq: 2
5
+
}
6
+
7
+
put {
8
+
url: {{appview_url}}/api/admin/themes/{{theme_rkey}}
9
+
}
10
+
11
+
body:json {
12
+
{
13
+
"name": "Neobrutal Light (Updated)",
14
+
"colorScheme": "light",
15
+
"tokens": {
16
+
"color-bg": "#f5f0e8",
17
+
"color-text": "#1a1a1a",
18
+
"color-primary": "#ff5c00"
19
+
}
20
+
}
21
+
}
22
+
23
+
assert {
24
+
res.status: eq 200
25
+
res.body.uri: isDefined
26
+
res.body.cid: isDefined
27
+
}
28
+
29
+
docs {
30
+
Update an existing theme record. Full replacement of the PDS record.
31
+
Optional fields (cssOverrides, fontUrls) fall back to their existing values
32
+
when omitted from the request body.
33
+
34
+
**Requires:** space.atbb.permission.manageThemes
35
+
36
+
Path params:
37
+
- rkey: Theme record key (TID)
38
+
39
+
Body: same as Create Theme (all fields).
40
+
41
+
Returns (200):
42
+
{
43
+
"uri": "at://did:plc:.../space.atbb.forum.theme/abc123",
44
+
"cid": "bafyrei..."
45
+
}
46
+
47
+
Error codes:
48
+
- 400: Invalid input (same as Create Theme)
49
+
- 401: Not authenticated
50
+
- 403: Missing manageThemes permission
51
+
- 404: Theme not found
52
+
- 503: ForumAgent not configured or PDS network error
53
+
}