Getting started

What is SkyScribe?

SkyScribe is three things that work together. Understanding which is which makes the rest of this guide much easier to follow.

1. The authoring app

The app at skyscribe.app is where you write and organise your content. You compose long-form writing in a rich text editor, group it into sections, manage a shared image library, and invite other people to write alongside you.

Everything you create is saved to your own Bluesky account — specifically, to your account's Personal Data Server (PDS). SkyScribe never holds the only copy.

2. SkyScribe Sites

A SkyScribe Site is a hosted blog that SkyScribe builds and runs for you. You pick a template, colours, and fonts in a design wizard, connect it to your content, and it goes live at your-name.skyscribe.site (or a custom domain you own). No code, no servers to manage.

SkyScribe Sites are part of the paid PRO subscription.

3. The SDK

The SDK is a set of open-source code packages (@scribe-atp/core and framework-specific companions) for developers. Instead of using a SkyScribe Site, a developer can pull your published content into a site or app they build themselves — in React, Vue, Next.js, Astro, or plain TypeScript — and style it however they like.

The SDK is free. You only pay for whatever hosting you choose to run it on.

The through-line: your content is portable

        ┌─────────────────────────┐
        │   You write in the      │
        │   SkyScribe app         │
        └───────────┬─────────────┘
                    │  saved to
                    ▼
        ┌─────────────────────────┐
        │  Your Bluesky account   │   ← the single source of truth
        │  (your PDS)             │
        └─────┬───────────────┬───┘
              │               │
   read by    ▼               ▼   read by
     ┌──────────────┐   ┌──────────────────┐
     │ SkyScribe    │   │ A site built     │
     │ Site         │   │ with the SDK     │
     └──────────────┘   └──────────────────┘

A hosted SkyScribe Site and a hand-built SDK site are just two different readers of the same content. You can run both at once, switch from one to the other later, or use neither and still keep everything you have written.

Next

Core concepts introduces the handful of terms — Publication, Document, Category, Builder Site — that the rest of this guide relies on.

Settings

Appearance