AD
Boost Your Brand on BlueSky—Exclusive banner space to amplify your reach within the BlueSky community.
BSkyInfo LogoBskyInfo
All ToolsCategoriesCollectionsFeed DirectoryLabeler DirectoryArticlesGuidesGlossaryBluesky SDKsSponsor
Submit
All ToolsCategoriesCollectionsFeed DirectoryLabeler DirectoryGuidesGlossaryArticlesBluesky SDKsSponsorSubmit
  1. SDKs
  2. /JavaScript
  3. /graysky
mozzius

graysky

A JavaScript SDK for Bluesky and AT Protocol by mozzius

a bluesky client for ios and android

GitHub Stats

630stars
59forks
10contributors
76open issues

Dates

Created:April 15, 2023
Last updated:June 15, 2025

README

The following content is from graysky's GitHub repository. All rights reserved by the original author.

Graysky

Crowdin

Graysky is a Bluesky client written in React Native.

Get it here: https://graysky.app/download

Getting Started

You'll need pnpm, and some sort of simulator or device to run the app on.

pnpm install
cp .env.example .env

EAS setup (optional) Set EAS_PROJECT_ID, APP_ID, and OWNER in .env

In the /apps/expo directory, build the dev client using EAS:

pnpm build:dev-client:ios-simulator
// or
pnpm build:dev-client:android

You can then start the expo server with:

pnpm dev

Future Roadmap

  • Change handle
    • own domain
    • bsky.social
    • community handles
  • Push notifications
  • Drafts
  • Full lists support
  • Share post as image
  • Pro features
    • Polls
    • Analytics

Android local APK builds

  • Install Android Studio, and the Android SDK
  • Install Azul Zulu OpenJDK (brew install --cask zulu17) and then set JAVA_HOME to the path of the JDK, which will probably be /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home
  • Copy google-services.json.example to google-services.json, or add your own Firebase config
  • Make Gradle faster in ~/.gradle/gradle.properties:
org.gradle.jvmargs=-Xmx20g -XX:MaxMetaspaceSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8 -XX:+UseParallelGC -XX:MaxMetaspaceSize=2g
org.gradle.parallel=true
org.gradle.configureondemand=true
org.gradle.daemon=false
org.gradle.caching=true

You can now either run pnpm build:android to build and submit the app, or if you want to sign a build manually you can do the following:

  • Create a signing key in Android Studio
  • Build it with: eas build --platform android --profile production-apk --non-interactive --local --output="./foo.apk" --wait
  • Sign it with: /Users/alice/Library/Android/sdk/build-tools/33.0.0/apksigner sign -ks sideload.jks foo.apk

iOS local builds

In the /apps/expo directory:

pnpm build:ios

Sponsors

Thank you to @thepriceisright for sponsoring my work on this project!

Contributors

Graysky is primarily developed by @mozzius.dev. If you'd like to show your support for the project, you can sponsor me.

However, I'm not the only one who's contributed to this project. I'd like to especially thank @alice.bsky.sh for her work on adding dark mode, and getting Android builds working, and thank @holden.bsky.social for their invaluable accessibility improvements.

All Contributors

My eternal thanks to the following people for their contributions to Graysky:

  • @alice.bsky.sh
  • @holden.bsky.social
  • @matthewstanciu.com
  • @mary.my.id
  • @st-cyr.bsky.social

Topics

at-protocolblueskybluesky-clientreact-native

Related SDKs

mary-extatcute

a collection of lightweight TypeScript packages for AT Protocol, the protocol powering Bluesky.

333•JavaScript
aliceisjustplayinglabeler-starter-kit-bsky

Use this repository to get started with your own Bluesky Labeler.

171•JavaScript
bluesky-socialfeed-generator

ATProto Feed Generator Starter Kit

1874•JavaScript
bluesky-socialatproto

AT Protocol Reference Implementation (TypeScript)

8609•JavaScript
skyware-jsfirehose

A dead simple client for subscribing to an ATProto Relay ("firehose").

38•JavaScript
skyware-jsjetstream

A fully typed client for the Bluesky Jetstream (https://github.com/bluesky-social/jetstream) service.

47•JavaScript

Resources

GitHub RepositoryProject Website

License

MIT

Author

mozzius
mozzius
@holden.bsky.social

Activity

Last commit: June 15, 2025
Commit frequency: Unknown

Our Sponsors

Your Brand Here!

50K+ engaged viewers every month

Limited spots available!

📧 Contact us via email🦋 Contact us on Bluesky
BSkyInfo LogoBskyInfo

The Most Comprehensive Bluesky Tools Directory

Stay updated with the latest Bluesky tools and ecosystem news 🦋

Bluesky butterfly logo
Quick LinksSubmit a ToolSponsorAboutLegal Information
ToolsFeed DirectoryLabeler DirectorySchedulingAnalyticsAll ToolsCategoriesCollectionsTags
ResourcesArticlesBluesky GuidesBluesky GlossaryBluesky SDKsBluesky ResourcesSkyRaffleMeida Coverage
Our ProductsRaffleBlueAiTeach ToolsLaiewAI affiliate listFirstoCoast Fire Calculator

This website may contain affiliate links

© 2025 BskyInfo. All rights reserved.