interstellar-kbin/README.md

37 lines
2.1 KiB
Markdown
Raw Normal View History

# Interstellar
An app for Kbin, Mbin, and Lemmy; connecting you to the fediverse.
## Downloads
[![](assets/readme/google-play-badge.png)](https://play.google.com/store/apps/details?id=one.jwr.interstellar)
[![](assets/readme/flathub-badge.png)](https://flathub.org/apps/one.jwr.interstellar)
See the [latest release](https://github.com/jwr1/interstellar/releases/latest) for direct APK files, an AppImage, and more platforms.
2023-12-11 22:36:54 +01:00
## Discussion
2024-03-29 15:46:45 +01:00
You can ask questions, report bugs, or make suggestions either here on [GitHub](https://github.com/jwr1/interstellar/issues), or in the [Interstellar magazine](https://kbin.earth/m/interstellar). You can also join the [Matrix room](https://matrix.to/#/#interstellar-app:matrix.org) for real-time discussion.
## Screenshots
<div align="center">
<img src="assets/screenshots/desktop-3.png" width="800"></img>
2024-04-18 20:22:36 +02:00
<img src="assets/screenshots/desktop-2.png" width="800"></img>
<br>
<img src="assets/screenshots/mobile-1.png" width="300"></img>
<img src="assets/screenshots/mobile-2.png" width="300"></img>
</div>
2023-12-11 22:36:54 +01:00
## Contributing
Interstellar uses [Flutter](https://flutter.dev) as its framework, so make sure you have the [Flutter SDK installed](https://docs.flutter.dev/get-started/install) before doing anything else. Then, run `flutter doctor -v` to see instructions for setting up different build platforms (e.g. android studio for APKs). Once that's done, use `dart run build_runner build` to build the generated code for models (this only needs to run once unless you modify one of the models). Finally, you can use `flutter run` to develop, and `flutter build {platform}` for release files.
### Generating app icon
The app icon is under the `assets/icons` folder, where the `logo.png` file is just the transparent one overlayed on the current background color `#423862`. This is generated with the [flutter_launcher_icons](https://pub.dev/packages/flutter_launcher_icons) package, and all relevant configuration is in the `pubspec.yaml` file.
Icons created by [Benjamin Mathis](https://github.com/BenjMathis1)
To generate a new icon, simply run the following: `dart run flutter_launcher_icons`