The Most Famous & Powerful Dart/Flutter Library for Bluesky Social 🦋
1. Guide 🌎
This library provides the most productive way to use the AT Protocol API and Bluesky API in Dart/Flutter apps.
The library is cross-platform and is already used in many applications. See official showcase for more details.
Give a ⭐ on GitHub repository and follow shinyakato.dev on Bluesky!
1.1. Features ⭐
- ✅ Zero Dependency
- ✅ Supports Powerful Built-In Retry using Exponential BackOff And Jitter
- ✅ Supports All Endpoints for
app.bsky.*
,chat.bsky.*
andtools.ozone.*
- ✅ Well Documented and Well Tested
- ✅ Supports Powerful Firehose API
- ✅ Supports Powerful Moderation API
- ✅ 100% Null Safety
- ✅ Built In atproto Features
1.2. Getting Started 💪
See example or official documents from following links.
1.3. Supported Endpoints 👀
See official documents from following links.
1.4. More Tips 🏄
See official documents from following links.
- Session Management
- App Password
- Other Than
bsky.social
- De/Serialize
- Thrown Exceptions
- Rate Limits
- Union Types
- Firehose API
- Timeout Duration
- Advanced Built-In Retry
- Lexicon/Object IDs
- Pagination
- Unspecced Inputs
- Moderation API
1.5. Contribution 🏆
If you would like to contribute to bluesky, please create an issue or create a Pull Request.
There are many ways to contribute to the OSS. For example, the following subjects can be considered:
- There are request parameters or response fields that are not implemented.
- Documentation is outdated or incomplete.
- Have a better way or idea to achieve the functionality.
- etc...
You can see more details from resources below:
Or you can create a discussion if you like.
Feel free to join this development, diverse opinions make software better!
1.6. Support ❤️
The simplest way to show us your support is by giving the project a star at GitHub and Pub.dev.
You can also support this project by becoming a sponsor on GitHub:
You can also show on your repository that your app is made with bluesky by using one of the following badges:
[![Powered by bluesky](https://img.shields.io/badge/Powered%20by-bluesky-00acee.svg)](https://github.com/myConsciousness/atproto.dart)
[![Powered by bluesky](https://img.shields.io/badge/Powered%20by-bluesky-00acee.svg?style=flat-square)](https://github.com/myConsciousness/atproto.dart)
[![Powered by bluesky](https://img.shields.io/badge/Powered%20by-bluesky-00acee.svg?style=for-the-badge)](https://github.com/myConsciousness/atproto.dart)
1.7. License 🔑
All resources of bluesky is provided under the BSD-3
license.
Copyright 2023 Shinya Kato. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided the conditions.
Note
License notices in the source are strictly validated based on.github/header-checker-lint.yml
. Please check header-checker-lint.yml for the permitted standards.
1.8. More Information 🧐
bluesky was designed and implemented by Shinya Kato (@myConsciousness).
Libraries
- app_bsky_actor_defs
- app_bsky_actor_get_profiles
- app_bsky_actor_get_suggestions
- app_bsky_actor_profile
- app_bsky_actor_search_actors
- app_bsky_actor_search_actors_typeahead
- app_bsky_embed_defs
- app_bsky_embed_external
- app_bsky_embed_images
- app_bsky_embed_record
- app_bsky_embed_record_with_media
- app_bsky_embed_video
- app_bsky_feed_defs
- app_bsky_feed_describe_feed_generator
- app_bsky_feed_generator
- app_bsky_feed_get_actor_feeds
- app_bsky_feed_get_actor_likes
- app_bsky_feed_get_feed
- app_bsky_feed_get_feed_generator
- app_bsky_feed_get_feed_generators
- app_bsky_feed_get_feed_skeleton
- app_bsky_feed_get_likes
- app_bsky_feed_get_list_feed
- app_bsky_feed_get_post_thread
- app_bsky_feed_get_posts
- app_bsky_feed_get_quotes
- app_bsky_feed_get_reposted_by
- app_bsky_feed_get_suggested_feeds
- app_bsky_feed_get_timeline
- app_bsky_feed_like
- app_bsky_feed_post
- app_bsky_feed_postgate
- app_bsky_feed_repost
- app_bsky_feed_search_posts
- app_bsky_feed_threadgate
- app_bsky_graph_block
- app_bsky_graph_defs
- app_bsky_graph_follow
- app_bsky_graph_get_actor_starter_packs
- app_bsky_graph_get_blocks
- app_bsky_graph_get_followers
- app_bsky_graph_get_follows
- app_bsky_graph_get_known_followers
- app_bsky_graph_get_list
- app_bsky_graph_get_list_blocks
- app_bsky_graph_get_list_mutes
- app_bsky_graph_get_lists
- app_bsky_graph_get_mutes
- app_bsky_graph_get_relationships
- app_bsky_graph_get_starter_pack
- app_bsky_graph_get_starter_packs
- app_bsky_graph_get_suggested_follows_by_actor
- app_bsky_graph_list
- app_bsky_graph_listblock
- app_bsky_graph_listitem
- app_bsky_graph_starterpack
- app_bsky_labeler_defs
- app_bsky_labeler_get_services
- app_bsky_labeler_service
- app_bsky_notification_get_unread_count
- app_bsky_notification_list_notifications
- app_bsky_notification_register_push
- app_bsky_richtext_facet
- app_bsky_unspecced_defs
- app_bsky_unspecced_get_popular_feed_generators
- app_bsky_unspecced_get_suggestions_skeleton
- app_bsky_unspecced_get_tagged_suggestions
- app_bsky_unspecced_search_actors_skeleton
- app_bsky_unspecced_search_posts_skeleton
- app_bsky_video_defs
- app_bsky_video_get_job_status
- app_bsky_video_get_upload_limits
- app_bsky_video_upload_video
- atproto
- bluesky
- bluesky_chat
- cardyb
- chat_bsky_actor_declaration
- chat_bsky_actor_defs
- chat_bsky_convo_defs
- chat_bsky_convo_get_convo
- chat_bsky_convo_get_convo_for_members
- chat_bsky_convo_get_log
- chat_bsky_convo_get_messages
- chat_bsky_convo_leave_convo
- chat_bsky_convo_list_convos
- chat_bsky_convo_mute_convo
- chat_bsky_convo_send_message_batch
- chat_bsky_convo_unmute_convo
- chat_bsky_convo_update_read
- chat_bsky_moderation_get_actor_metadata
- chat_bsky_moderation_get_message_context
- com_atproto_admin_defs
- com_atproto_admin_get_account_infos
- com_atproto_admin_get_invite_codes
- com_atproto_admin_get_subject_status
- com_atproto_admin_search_accounts
- com_atproto_admin_send_email
- com_atproto_admin_update_subject_status
- com_atproto_identity_get_recommended_did_credentials
- com_atproto_identity_resolve_handle
- com_atproto_identity_sign_plc_operation
- com_atproto_label_defs
- com_atproto_label_query_labels
- com_atproto_label_subscribe_labels
- com_atproto_moderation_create_report
- com_atproto_moderation_defs
- com_atproto_repo_apply_writes
- com_atproto_repo_create_record
- com_atproto_repo_defs
- com_atproto_repo_delete_record
- com_atproto_repo_describe_repo
- com_atproto_repo_get_record
- com_atproto_repo_list_missing_blobs
- com_atproto_repo_list_records
- com_atproto_repo_put_record
- com_atproto_repo_strong_ref
- com_atproto_repo_upload_blob
- com_atproto_server_check_account_status
- com_atproto_server_create_account
- com_atproto_server_create_app_password
- com_atproto_server_create_invite_code
- com_atproto_server_create_invite_codes
- com_atproto_server_create_session
- com_atproto_server_defs
- com_atproto_server_describe_server
- com_atproto_server_get_account_invite_codes
- com_atproto_server_get_service_auth
- com_atproto_server_get_session
- com_atproto_server_list_app_passwords
- com_atproto_server_refresh_session
- com_atproto_server_request_email_update
- com_atproto_server_reserve_signing_key
- com_atproto_sync_get_latest_commit
- com_atproto_sync_get_repo_status
- com_atproto_sync_list_blobs
- com_atproto_sync_list_repos
- com_atproto_sync_subscribe_repos
- com_atproto_temp_check_signup_queue
- core
- ids
- lex_namespaces
- moderation
- ozone
- tools_ozone_communication_defs
- tools_ozone_communication_list_templates
- tools_ozone_moderation_defs
- tools_ozone_moderation_emit_event
- tools_ozone_moderation_query_events
- tools_ozone_moderation_query_statuses
- tools_ozone_moderation_search_repos
- tools_ozone_server_get_config
- tools_ozone_team_add_member
- tools_ozone_team_defs
- tools_ozone_team_list_members
- tools_ozone_team_update_member