// Social integration · 3 steps · ~2 min

Bluesky Setup

The easiest of all the social setups. Bluesky is built on open protocols, no developer program, no app review, no OAuth dance. Two minutes and you're done.

// You will end up with
// One important thing

Bluesky only shows the app password once. Copy it immediately when it appears, if you close the dialog without saving, you can't recover it, you have to revoke and make a new one. Same rule as any API key.

  1. 1
    Bluesky

    Know your handle

    Your handle is what you type when you log in. It includes the full domain, with no @ prefix.

    • Default format: yourname.bsky.social
    • Custom domain (if you set one up): mike.stanhattie.com

    Check yours by opening your Bluesky profile, the handle shows under your display name. Copy the full thing, including the domain.

    Don't include the @ symbol. ArtDrop rejects @artdrop.bsky.social and accepts artdrop.bsky.social.

  2. 2
    App password

    Create an app password on bsky.app

    Works the same on web and mobile:

    1. Open bsky.app and log in.
    2. Hamburger menu (top left on web, avatar tap on mobile), then Settings.
    3. Open Privacy and Security.
    4. Tap App Passwords.
    5. Click Add App Password.
    6. Name it something you'll recognize later. Suggested: ArtDrop.
    7. Click Create App Password.
    8. Copy the password immediately. It's shown once in a dialog like abcd-efgh-ijkl-mnop, 19 characters with hyphens.

    The hyphens are part of the password, don't strip them. Treat this like an API key: don't commit it to git, don't post it in Slack.

  3. 3
    Paste and save

    Enter both values in ArtDrop

    Back in ArtDrop's Social page, Bluesky section:

    • Handle: your handle from Step 1 (no @, include the full domain).
    • App Password: the xxxx-xxxx-xxxx-xxxx string from Step 2.

    Hit Save. ArtDrop creates a session with com.atproto.server.createSession right away, a failed login shows up immediately.

// What app passwords can (and can't) do

Bluesky app passwords are intentionally limited. With this password, ArtDrop can:

ArtDrop cannot:

If the password ever leaks, revoke it from the same App Passwords screen and make a new one. Revocation is instant, no waiting period.

// Common gotchas
// Stuck?

Bluesky setup almost never has issues. If ArtDrop is rejecting a password you just created, paste it into the bsky.app login page manually to confirm it works. If that fails too, revoke and retry. Otherwise email support@getartdrop.com.

Official reference: Bluesky docs, AT Protocol.