Hopefully feature-complete Android Bluesky client written in Expo
atproto
bluesky
New README
+42
-34
+42
-34
README.md
+42
-34
README.md
···
1
-
# Welcome to your Expo app 👋
1
+
# Dusksky
2
2
3
-
This is an [Expo](https://expo.dev) project created with [`create-expo-app`](https://www.npmjs.com/package/create-expo-app).
4
-
5
-
## Get started
3
+
Alternative Bluesky client for Android (and maybe, in the future, web too!) mostly based on Material 3 made in Expo.
6
4
7
-
1. Install dependencies
5
+
The goal is to create a better and more fun client compared to the official one on Android, while also adding new features.
8
6
9
-
```bash
10
-
npm install
11
-
```
12
-
13
-
2. Start the app
14
-
15
-
```bash
16
-
npx expo start
17
-
```
7
+
Some planned features include:
8
+
- More profile customization options
9
+
- Emojis (reactions and probably in-post ones too)
10
+
- Audio posts
11
+
- Mindfulness (scroll limits, locking the app when opening it right after closing it)
12
+
- Backend selection (aka Appview)
18
13
19
-
In the output, you'll find options to open the app in a
14
+
## Contributing
15
+
For a few guidelines:
16
+
- Before making an issue, check the existing ones
17
+
- AI code contributions are not allowed (you are allowed to use AI to explain existing code or come up with a high-level approach, but all code needs to be made by hand)
18
+
- Check if your code is working as intended and doesn't break any part of the app before pushing it
19
+
- Before adding features or making big changes, make sure to discuss them in Issues (also specify information about any dependencies)
20
+
- When translating, you should know the target language (tool assistance allowed)
21
+
- Be respectful
20
22
21
-
- [development build](https://docs.expo.dev/develop/development-builds/introduction/)
22
-
- [Android emulator](https://docs.expo.dev/workflow/android-studio-emulator/)
23
-
- [iOS simulator](https://docs.expo.dev/workflow/ios-simulator/)
24
-
- [Expo Go](https://expo.dev/go), a limited sandbox for trying out app development with Expo
23
+
These guidelines exist because I care about the quality of my projects. If you are unhappy with any of them you are free to fork according to the guidelines below.
25
24
26
-
You can start developing by editing the files inside the **app** directory. This project uses [file-based routing](https://docs.expo.dev/router/introduction).
25
+
## Forking and custom builds
26
+
If you are providing a fork or a custom build, make sure to clearly state that it's not the upstream project and change all links to point to your repository or website instead.
27
+
Additionally you are required to follow all requirements provided by the License.
27
28
28
-
## Get a fresh project
29
+
## Development
29
30
30
-
When you're ready, run:
31
+
In order to work on this app, you're gonna need following things:
32
+
- Bun
33
+
- Android SDK
34
+
- 🧠
31
35
36
+
To install JS dependencies run:
32
37
```bash
33
-
npm run reset-project
38
+
bun install
34
39
```
35
40
36
-
This command will move the starter code to the **app-example** directory and create a blank **app** directory where you can start developing.
37
-
38
-
## Learn more
39
-
40
-
To learn more about developing your project with Expo, look at the following resources:
41
+
To run the bundler for development, run:
42
+
```bash
43
+
bunx expo start
44
+
```
41
45
42
-
- [Expo documentation](https://docs.expo.dev/): Learn fundamentals, or go into advanced topics with our [guides](https://docs.expo.dev/guides).
43
-
- [Learn Expo tutorial](https://docs.expo.dev/tutorial/introduction/): Follow a step-by-step tutorial where you'll create a project that runs on Android, iOS, and the web.
46
+
You're also gonna need to make a native development build.
44
47
45
-
## Join the community
48
+
Create the Android project:
49
+
```bash
50
+
bunx expo prebuild -p android
51
+
```
46
52
47
-
Join our community of developers creating universal apps.
53
+
Create the build and run it on the device:
54
+
```bash
55
+
bunx expo run:android --device --variant debugOptimized
56
+
```
48
57
49
-
- [Expo on GitHub](https://github.com/expo/expo): View our open source platform and contribute.
50
-
- [Discord community](https://chat.expo.dev): Chat with Expo users and ask questions.
58
+
You can learn more [here](https://docs.expo.dev/develop/development-builds/introduction/).