# ruby.sdk.blue

This repo is the source code of the documentation website [ruby.sdk.blue](https://ruby.sdk.blue) about the collection of gems called the Ruby SDK for ATProto.

## Links to specific repos

- [skyfall](https://tangled.org/mackuba.eu/skyfall) (firehose client)
- [minisky](https://tangled.org/mackuba.eu/minisky) (XRPC API client)
- [didkit](https://tangled.org/mackuba.eu/didkit) (DID/handle resolution utils, PLC directory)
- [blue_factory](https://tangled.org/mackuba.eu/blue_factory) (feed service builder)
- [tapfall](https://tangled.org/mackuba.eu/tapfall) (tap client)

And some sample projects using these:

- [bluesky-feeds-rb](https://tangled.org/mackuba.eu/bluesky-feeds-rb) – template of a full feed service project
- [Lycan](https://tangled.org/mackuba.eu/lycan) – search engine for your likes
- [Tootify](https://tangled.org/mackuba.eu/tootify) – Cross-poster to Mastodon
- [RatProto](https://tangled.org/mackuba.eu/ratproto) – command-line tool for accessing ATProto

## Examples

You can also find a lot of simple examples for the above gems in the [examples directory](./examples) in this repo.

To run the examples, first install the dependencies:

```
bundle install
```

Then run any example like this:

```
./examples/find_missing_follows.rb
```

All of the examples except the Tapfall one (`list_labellers.rb`) should run on Ruby 2.6 and above, including the default ones shipped in macOS 11+ (if anything doesn't work, let me know!).


## Credits

Copyright © 2026 Kuba Suder ([@mackuba.eu](https://bsky.app/profile/did:plc:oio4hkxaop4ao4wz2pp3f4cr)).

The code of the gems described here is available under the terms of the [zlib license](https://choosealicense.com/licenses/zlib/) (permissive, similar to MIT).

The examples in the `examples` folder are under the [WTFPL license](https://choosealicense.com/licenses/wtfpl/) – feel free to take any fragments of those and use them in your code without any strings attached.