FAQ

Accounts

Do I need a Bluesky account?

Yes. SkyScribe has no separate accounts — you sign in with Bluesky, and your content is stored in your Bluesky account. You don't have to use Bluesky as a social network; the account can just be storage.

What happens to my content if I stop using SkyScribe?

It stays in your Bluesky account as standard AT Protocol records. Any site built with the SDK keeps working; a hosted SkyScribe Site stops when the subscription does, but the underlying Documents are untouched.

Why does SkyScribe ask for permission again sometimes?

Some actions need permission to write specific record types to your account. When SkyScribe adds a new capability, your existing sign-in doesn't cover it, so you're asked to sign in once more.

Content

Can one Document appear in two Publications?

No — a Document belongs to at most one Publication at a time. Publishing it somewhere new removes it from where it was.

Can two people write for the same Publication?

Yes — invite them as Collaborators. They write on their own accounts and submit Documents for you to approve.

Is there a limit on Publications or Documents?

No. Those are free AT Protocol records. The paid limits are on hosted sites (Site Slots) and image storage.

Sites

SkyScribe Site or my own frontend?

See SkyScribe Sites vs. your own frontend. Short version: hosted site for no-code; the SDK if you (or a developer) want full control.

Can I use my own domain for a hosted site?

Not yet — hosted sites are at your-name.skyscribe.site. A site built with the SDK can be on any domain you control.

Can one Publication power both a hosted site and an SDK site?

Yes, at the same time. They're just two readers of the same content.

The SDK

Why does the SDK say "Site", "Group", and "Article"?

Those are the AT Protocol names for what this guide calls a Publication, a Category, and a Document. The SDK's API predates SkyScribe's naming — see the mapping in SDK concepts.

Which SDK package do I install?

@scribe-atp/core if you're unsure — it works everywhere. There are companions for React, Next.js, Nuxt, Vue, Angular, and React Router; see Which package do you need?.