atproto.dart

AT Protocol and Bluesky Social Things for Dart/Flutter 🦋

---

---

• 1. Motivation 💪
• 2. Packages & Tools ⚒️
  • 2.1. Dart Packages
  • 2.2. CLI Tool
  • 2.3. GitHub Actions Workflow
• 3. Developer Quickstart 🏎️
  • 3.1. Clone Project
  • 3.2. Install Melos
  • 3.3. Setup Project
  • 3.4. Useful Commands
• 4. Who is using atproto.dart? 👀
• 5. Support

Welcome to atproto.dart 🦋

This project will maximize your development productivity about AT Protocol and Bluesky things.

1. Motivation 💪

AT Protocol and Bluesky are awesome.

This wonderful platform needs a standard and highly integrated SDK. atproto.dart provides the best development experience in such matters for Dart/Flutter devs.

2. Packages & Tools ⚒️

2.1. Dart Packages

Package	pub.dev	Docs
at_identifier: core library for the syntax in the AT Protocol standard		README
nsid: core library for parsing NSIDs in the AT Protocol standard		README
at_uri: core library for parsing AT URI in the AT Protocol standard		README
xrpc: core library for XRPC communication, wrapped HTTP client		README
multiformats: core library for parsing IPFS-related things		README
atproto_core: core library for clients and tools		README
lexicon: core library for parsing Lexicon in the AT Protocol standard		README
did_plc: client library for plc.directory endpoints		README
atproto_oauth: client library for OAuth DPoP		README
atproto: client library for com.atproto.* endpoints		README / GUIDE
bluesky: client library for com.atproto.*, app.bsky.* and chat.bsky.* endpoints		README / GUIDE
bluesky_text: library for parsing Bluesky text (mentions, links, tags, etc)		README / GUIDE

2.2. CLI Tool

Tool	Install	Docs
bluesky_cli: command line tool for app.bsky.* endpoints	dart pub global activate bluesky_cli	README

2.3. GitHub Actions Workflow

Workflow	Marketplace	Docs
bluesky-post: workflow for scheduled post to Bluesky from GitHub Actions		README

3. Developer Quickstart 🏎️

This project consists of several packages and is managed using Melos. The Melos commands makes it easy to set up this project.

3.1. Clone Project

git clone https://github.com/myConsciousness/atproto.dart.git

3.2. Install Melos

First you need to clone this project and install Melos with following command.

dart pub global activate melos

3.3. Setup Project

Then you just execute setup command as follows. The setup command easily solves all the initial setup when cloning this huge project.

melos setup

3.4. Useful Commands

Command	Description
melos setup	Set up the atproto.dart project when cloned. Run dart pub get and dart run build_runner build in all Dart packages.
melos get	Run dart pub get command in all packages.
melos analyze	Run dart analyze in all packages.
melos fmt	Run dart format and dart run import_sorter:main in all packages.
melos build	Run dart run build_runner build in all packages.
melos test	Run all Dart tests in this project.

4. Who is using atproto.dart? 👀

The following projects/services are using atproto.dart packages:

• APOD BOT (bot) maintained by @shinyakato.dev
• SkyFeed (web) maintained by @redsolver.dev
• SkyBridge (proxy) maintained by @videah.net
• SkyClad (mobile) maintained by @igz0.bsky.social
• deck.blue (web) maintained by @deck.blue
• SkyThrow (mobile) maintained by @rukari.bsky.social, @hidea.bsky.social

You can see more at showcase, special thanks!

5. Support