Skip to content

Comments

Add new pages: AppSpecs, PubkyApp, HTTPRelay, PubkyBackup, PubkyModeration#48

Open
gcomte wants to merge 2 commits intomainfrom
docs/add-new-pages
Open

Add new pages: AppSpecs, PubkyApp, HTTPRelay, PubkyBackup, PubkyModeration#48
gcomte wants to merge 2 commits intomainfrom
docs/add-new-pages

Conversation

@gcomte
Copy link
Contributor

@gcomte gcomte commented Feb 16, 2026

New documentation pages for ecosystem components: App Specs (data model), pubky.app client, HTTP Relay (auth flow), Pubky Backup (credible exit), and Pubky Moderation (content moderation).


## Overview

pubky.app is a social media-like web application built on top of [[Explore/PubkyCore/Introduction|Pubky Core]]. It serves as the flagship example of how to build applications using the Pubky [[SDK]] for authentication and data storage, combined with [[Explore/PubkyApp/Backend/PubkyNexus|Nexus]] for fast social feeds.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is a fast social feed?


### Data Flow
1. **Writes** go to [[Homeserver|homeserver]] via [[SDK]]
2. Homeserver notifies [[Explore/PubkyApp/Backend/PubkyNexus|Nexus]] of changes
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nexus queries Homeserver for changes

- **QR Code Authentication** via [[PubkyRing|Pubky Ring]]
- **Offline support** — PWA with service worker caching and local-first writes

## Architecture
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this would be better named "Codebase Structure" or similar

---
title: "HTTP Relay"
---

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It may be useful to link to https://httprelay.io/ for people familiar with the concept


## Known Issues

### Mobile Browser Background Timeout
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I dont think the issues part is needed here

---
title: "Pubky Backup"
---

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mark this as under development and that updates in behaviour are expected

@gcomte gcomte force-pushed the docs/add-new-pages branch from 85d06cc to 901627a Compare February 20, 2026 18:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants