The SkyScribe SDK is a set of TypeScript packages for showing content written in SkyScribe on a website you build yourself: an SDK-driven website. Authors write and publish in SkyScribe. The content lives in their own Bluesky account, and the SDK fetches it for your site.
Not a developer?
You probably want a SkyScribe Site instead: pick a design, choose colours and fonts, and launch, with no coding and nothing to install. See SkyScribe Sites vs. SDK-driven websites.
Upgrading from 4.x?
Version 5 renamed the API to the site.standard terms: Publication, Document and Category. See Upgrading to 5.0. Coming from @scribe-atp/*? See Migrating from @scribe-atp.
Published content is stored on the author's AT Protocol Personal Data Server (PDS): a public, decentralised data store. The SDK handles everything between "I have an author's handle" and "I have their Documents":
alice.bsky.social) to the author's permanent DIDIt also works with content written in Scribe CMS, the older authoring tool, which writes the same records.
Note
The SDK uses the same names as SkyScribe and the site.standard records: a Publication holds Categories, which hold Documents. See Concepts.
| Package | For | Provides |
|---|---|---|
@skyscribe-sdk/core | Any framework, or none. Start here if unsure. | Plain async functions, no runtime dependencies |
@skyscribe-sdk/react | React SPAs and client-rendered components | usePublication, useDocumentBySlug, useDocument hooks |
@skyscribe-sdk/react-router-framework | React Router v7/v8 framework (server) mode | Loader factories that wire up request.signal |
@skyscribe-sdk/next | Next.js 13+ App Router | generateStaticParams / generateMetadata factories |
@skyscribe-sdk/nuxt | Nuxt 3+ | A full module: auto-imports and useAsyncData integration |
@skyscribe-sdk/vue | Vue 3+ | useScribePublication, useScribeDocumentBySlug, useScribeDocument composables |
@skyscribe-sdk/angular | Angular 16+ | ScribeService (Observables), injectPublication / injectDocumentBySlug (Signals) |
@skyscribe-sdk/social | React | LikeButton, SubscribeButton, ShareButton for reader engagement |
@skyscribe-sdk/styles | Any framework | Themeable CSS for rendering Document content |
For SvelteKit, Astro, or any other meta-framework that loads data on the server, install @skyscribe-sdk/core and call fetchPublication / fetchDocumentBySlug directly in your loaders or server components. See Other frameworks.