Skip to main content

Introduction 🎉

atproto.dart is a comprehensive SDK for building AT Protocol and Bluesky applications in Dart and Flutter. Whether you're creating a social media client, content management tool, or decentralized application, our packages handle the complexity so you can focus on your app's unique features.

Why Choose atproto.dart?​

  • 🚀 Production Ready: Battle-tested packages with comprehensive test coverage and null safety
  • ⚡️ Developer Focused: Intuitive APIs that feel natural to Dart and Flutter developers
  • 🔧 Complete Toolkit: Everything from high-level Bluesky APIs to low-level AT Protocol primitives
  • 📚 Well Documented: Extensive documentation with real-world examples and best practices
  • 🎯 Type Safe: Sound null safety and compile-time checking throughout

Quick Start: Post to Bluesky in 5 Minutes ⏱️​

Let's build a simple Bluesky posting app to see how straightforward atproto.dart makes AT Protocol development.

Install the Bluesky Package​

dart pub add bluesky

Create Your First Bluesky Post​

post_to_bluesky.dart
import 'package:bluesky/atproto.dart' as atp;
import 'package:bluesky/bluesky.dart' as bsky;

Future<void> main() async {
  // Authenticate with your Bluesky account.
  // Generate an app password in Settings > App Passwords.
  final session = await atp.createSession(
    identifier: 'your-handle.bsky.social',
    password: 'your-app-password',
  );

  // Create a Bluesky client.
  final bluesky = bsky.Bluesky.fromSession(session.data);

  // Post to your timeline.
  await bluesky.feed.post.create(text: 'Hello from my Dart app! 🎯');

  print('Posted successfully!');
}

Run Your App​

dart run post_to_bluesky.dart

That's it! You've just created a working Bluesky client in a handful of lines. The same simplicity extends to building feeds, managing follows, handling media uploads, and every other AT Protocol feature.

tip

You can see a list of available packages in atproto.dart in the Packages/Tools section.

Key Features ✨​

🎯 Dart-Native Design​

Built specifically for Dart and Flutter developers with familiar patterns and conventions.

  • 100% Null Safety: Catch errors at compile time, not runtime
  • Type-Safe APIs: IntelliSense and autocomplete for every method and property
  • Flutter Integration: Works seamlessly with your existing Flutter projects

🔧 Complete AT Protocol Toolkit​

Everything you need to build on the AT Protocol, from high-level social features to low-level primitives.

  • Social APIs: Posts, follows, likes, reposts, and direct messages
  • Identity Management: Handle resolution, DID operations, and profile management
  • Content Handling: Media uploads, rich text formatting, and content moderation
  • Protocol Primitives: AT URIs, NSIDs, XRPC, and multiformat support

🏗️ Extensible Architecture​

Designed to support any AT Protocol service, not just Bluesky.

  • Modular Packages: Use only what you need for your specific use case
  • Service Agnostic: Core AT Protocol support works with any compliant service
  • Custom Lexicons: Easy integration of new AT Protocol schemas and endpoints

📦 Packages You'll Actually Reach For​

  • bluesky: The full Bluesky toolkit — posts, feeds, chat, moderation. Start here.
  • atproto: AT Protocol itself, for services beyond Bluesky.
  • atproto_oauth: OAuth 2.0 with DPoP — the recommended way to sign users in.
  • bluesky_text: Facet detection and correct post-length counting.
  • bluesky_cli: Try the APIs from your terminal in under a minute — dart pub global activate bluesky_cli.

Lower-level packages like at_primitives, xrpc, and multiformats come along automatically. See the package overview for the full list of 15 packages and how they fit together.

Design Principles 🎨​

Minimal Learning Curve​

Complex AT Protocol concepts like XRPC, DIDs, and content addressing are abstracted away. You work with familiar Dart patterns while we handle the protocol complexity behind the scenes.

Consistent Standards​

All packages follow the same naming conventions, error handling patterns, and API design principles. Learn one package, and you'll feel at home with all the others.

Intuitive APIs​

Method names and class structures mirror the concepts you already know from social media and web development. No need to learn AT Protocol jargon to be productive.

Documentation First​

Every feature includes comprehensive documentation with real-world examples. We believe great documentation is as important as great code.

Stay Informed 😇​

Something Missing?​ 👀​

If you find issues with the documentation or have suggestions on how to improve the documentation or the project in general, please file an issue for us, or send a post mentioning the @shinyakato.dev Bluesky account.

Talk to us first!