Skip to content
pubscout

bluesky

2.18.4, released yesterday by atprotodart.com

A Dart and Flutter library for Bluesky Social and the AT Protocol.

$ flutter pub add bluesky
Source repository

What it does

Provides complete API coverage for Bluesky Social, AT Protocol, chat, and Ozone moderation tools. It handles user authentication, feeds, profiles, and real-time event firehoses.

AI-written summary of version 2.15.6, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You are building an application specifically for Bluesky Social.
  • You need to integrate AT Protocol services, feeds, or chat functionality.

Skip it when

  • You are building a general REST or GraphQL backend application unrelated to Bluesky.
  • You only need standard Firebase or Supabase authentication and storage.

Strengths

  • Complete coverage of app.bsky, chat.bsky, and tools.ozone endpoints.
  • Supports advanced authentication including session management and OAuth DPoP.
  • Includes client-side notification grouping and real-time firehose support.

Weaknesses

  • Tightly coupled to Bluesky and AT Protocol specifications.
  • Relies on external code generation annotations for data models.

Setup

Kind
Pure Dart
Effort
Low
Code generation
Yes (build_runner)
Direct dependencies
6

Add the dependency via pub add and initialize the client using either basic credentials or OAuth.

import 'package:bluesky/atproto.dart';
import 'package:bluesky/bluesky.dart';

Future<void> main(List<String> args) async {
  final session = await createSession(
    service: 'bsky.social',
    identifier: 'your.handle.bsky.social',
    password: 'your-app-password',
  );

  final bsky = Bluesky.fromSession(session.data);
  final timeline = await bsky.feed.getTimeline(limit: 50);
}

Alternatives

Packages that do the same job and could replace bluesky.

Works with

Packages commonly used together with bluesky: ones it builds on, ones built on it, and its own family.