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.