Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,36 +19,36 @@ For those able & willing to help fix issues and/or implement features ...
### Development environment

Make sure you have
- JDK(JBR) 25
- JDK 25
- Xcode 26 if you're building for iOS

### Code guidelines
Flare uses [ktlint](https://github.com/pinterest/ktlint) to check the code style for Kotlin, so make sure run `./gradlew ktlintFormat` and fix the errors before you submit any PR.

### Building
### Android
- Make sure you have JDK(JBR) 25 installed
- Make sure you have JDK 25 installed
- Run `./gradlew installDebug` to build and install the debug version of the app
- You can open the project in Android Studio or IntelliJ IDEA if you want

### iOS
- Make sure you have JDK(JBR) 25 installed
- Make sure you have JDK 25 installed
- Make sure you have a Mac with Xcode 26 installed
- open `iosApp/Flare.xcodeproj` in Xcode
- Build and run the app

### Server
- Flare Server uses Ktor with Kotlin Native, which only works on Linux X64 and MacOS X64/ARM64
- Make sure you have JDK(JBR) 25 installed
- Make sure you have JDK 25 installed
- Run `./gradlew :server:runDebugExecutableMacosArm64 -PrunArgs="--config-path=path/to/server/src/commonMain/resources/application.yaml"` to build and run the server, remember to replace `path/to/server/src/commonMain/resources/application.yaml` with the path to your config file
- The server will run on `http://localhost:8080` by default

### Desktop
- Make sure you have JDK(JBR) 25 installed.
- Make sure you have JDK 25 installed.
- Run `./gradlew run` to build and run the debug version of the desktop app.

### Project structure
The project is split into 3 parts:
The project is split into theses parts:
- `shared`: The common code, including bussiness logic.
- `shared/commonMain`: Bussiness logic without any UI.
- `shared/api`: Shared API definition for the server and client
Expand Down
43 changes: 6 additions & 37 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
![badge-macOS](https://img.shields.io/badge/macOS-Sonoma-black)
![badge-Linux](https://img.shields.io/badge/Linux-AppImage-black)

Flare is an open-source, privacy-first social client that brings Mastodon, Misskey, Bluesky, X, and RSS into one unified timeline. It supports cross-posting, lists, feeds, DMs, RSS management, and AI-powered features such as translation and summaries. Built with Kotlin Multiplatform, Flare shares its core logic across Android, iOS, macOS, Windows, and Linux, turning fragmented social feeds into a personal information hub.
Flare is an open-source, privacy-first social client that brings Mastodon, Misskey, Bluesky, X, Nostr, and RSS into one unified timeline. It supports cross-posting, lists, feeds, DMs, RSS management, and AI-powered features such as translation and summaries. Built with Kotlin Multiplatform, Flare shares its core logic across Android, iOS, macOS, Windows, and Linux, turning fragmented social feeds into a personal information hub.

<a href="https://apps.microsoft.com/detail/9NLRN0BKZ357?referrer=appbadge&mode=direct">
<img src="https://get.microsoft.com/images/en-us%20dark.svg" width="190"/>
Expand Down Expand Up @@ -41,56 +41,25 @@ Here're some features we're planning to implement in the future.
- [ ] Quick reply
- [ ] Support for Meta Threads
- [ ] Support for Discourse forum
- [x] Support for Nostr
- [x] Desktop Client
- [ ] Web Client(?)

Here're some features we've done before.
- [x] Mixed timeline
- [x] AI powered features
- [x] Translation
- [x] Summary
- [x] Anonymous mode enhancement, option to change data source
- [x] Local history
- [x] RSS feed support
- [x] Support for vvo platform
- [x] Anonymous mode, no need to login
- [x] Customizable tabs
- [x] Local filtering
- [x] Crossposting
- [x] Translation

### Mastodon
- [x] Support for polls
- [x] Support global/local timelines
- [x] Support for lists
- [x] Support for bookmarks/faovrites timelines

### Misskey
- [x] Support for polls
- [x] Support for lists
- [x] Support for antennas
- [x] Support for faovrites timeline

### Bluesky
- [x] Support for lists
- [x] Support for feeds
- [x] Support DM

## Building
### Android
- Make sure you have JDK(JBR) 25 installed
- Make sure you have JDK 25 installed
- Run `./gradlew installDebug` to build and install the debug version of the app
- You can open the project in Android Studio or IntelliJ IDEA if you want

### iOS
- Make sure you have JDK(JBR) 25 installed
- Make sure you have JDK 25 installed
- Make sure you have a Mac with Xcode 26 installed
- open `iosApp/Flare.xcodeproj` in Xcode
- Build and run the app

### Server
- Flare Server uses Ktor with Kotlin Native, which only works on Linux X64 and MacOS X64/ARM64
- Make sure you have JDK 25(JBR) installed
- Make sure you have JDK 25 installed
- Run `./gradlew :server:runDebugExecutableMacosArm64 -PrunArgs="--config-path=path/to/server/src/commonMain/resources/application.yaml"` to build and run the server, remember to replace `path/to/server/src/commonMain/resources/application.yaml` with the path to your config file
- The server will run on `http://localhost:8080` by default
#### Docker
Expand All @@ -107,7 +76,7 @@ If you prefer using Docker, you can use Docker Compose to run prebuild Server Im
- Run `docker compose up -d`

### Desktop
- Make sure you have JDK(JBR) 25 installed
- Make sure you have JDK 25 installed
- Run `./gradlew run` to build and run the debug version of the desktop app.

## Contributing
Expand Down
Binary file modified docs/cover1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 4 additions & 4 deletions iosApp/Flare.xcodeproj/project.pbxproj
Original file line number Diff line number Diff line change
Expand Up @@ -330,7 +330,7 @@
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
ASSETCATALOG_COMPILER_INCLUDE_ALL_APPICON_ASSETS = NO;
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 29;
CURRENT_PROJECT_VERSION = 34;
DEVELOPMENT_TEAM = 7LFDZ96332;
ENABLE_PREVIEWS = YES;
ENABLE_USER_SCRIPT_SANDBOXING = NO;
Expand All @@ -350,7 +350,7 @@
"$(inherited)",
"@executable_path/Frameworks",
);
MARKETING_VERSION = 1.3.0;
MARKETING_VERSION = 1.4.0;
PRODUCT_BUNDLE_IDENTIFIER = dev.dimension.flare;
PRODUCT_NAME = "$(TARGET_NAME)";
STRING_CATALOG_GENERATE_SYMBOLS = YES;
Expand All @@ -370,7 +370,7 @@
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
ASSETCATALOG_COMPILER_INCLUDE_ALL_APPICON_ASSETS = NO;
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 29;
CURRENT_PROJECT_VERSION = 34;
DEVELOPMENT_TEAM = 7LFDZ96332;
ENABLE_PREVIEWS = YES;
ENABLE_USER_SCRIPT_SANDBOXING = NO;
Expand All @@ -390,7 +390,7 @@
"$(inherited)",
"@executable_path/Frameworks",
);
MARKETING_VERSION = 1.3.0;
MARKETING_VERSION = 1.4.0;
PRODUCT_BUNDLE_IDENTIFIER = dev.dimension.flare;
PRODUCT_NAME = "$(TARGET_NAME)";
STRING_CATALOG_GENERATE_SYMBOLS = YES;
Expand Down
22 changes: 16 additions & 6 deletions metadata/en-US/full_description.txt
Original file line number Diff line number Diff line change
@@ -1,8 +1,18 @@
Flare is an open-source, privacy-first social client that brings together multiple decentralized and federated networks into one seamless timeline. Whether you follow people on Mastodon, Bluesky, Misskey, or prefer RSS feeds, Flare lets you see everything in one place — no need to switch between apps.
Flare is a free and open source client for the social web. Browse, post, and
interact across Mastodon, Bluesky, X, Misskey, and Nostr from a single app.

Features:
- Unified timeline covering Mastodon, Misskey, Bluesky, X, and RSS feeds.
- Crossposting: share your thoughts across multiple platforms simultaneously.
- Full support for features common in federated social networks (polls, lists, favourites/bookmarks, etc.) depending on the platform.
- AI-powered tools: translation, summaries, local history to help you catch up quickly.
- Strong focus on privacy and control: anonymous mode, local filtering, data transparency.

- Unified timeline: merge feeds from multiple accounts and platforms into one
stream
- Cross-posting: compose once, publish to multiple platforms
- Adaptive layout: multi-column grid and split-view panels on tablets
- Built-in RSS/Atom reader with OPML import
- Customizable tab bar with any timeline, list, or feed as a tab
- Full compose: polls, content warnings, media alt text, visibility controls
- Guest mode: browse Mastodon without an account
- Local keyword filters
- Dynamic theming, custom colors, adjustable fonts
- No ads, no tracking, no telemetry

Licensed under AGPL-3.0.
Binary file modified metadata/en-US/images/featureGraphic.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified metadata/en-US/images/phoneScreenshots/1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified metadata/en-US/images/phoneScreenshots/2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified metadata/en-US/images/phoneScreenshots/3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified metadata/en-US/images/phoneScreenshots/4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified metadata/en-US/images/phoneScreenshots/5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified metadata/en-US/images/phoneScreenshots/6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified metadata/en-US/images/phoneScreenshots/7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed metadata/en-US/images/phoneScreenshots/8.png
Binary file not shown.
Binary file added metadata/en-US/images/tenInchScreenshots/1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added metadata/en-US/images/tenInchScreenshots/2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added metadata/en-US/images/tenInchScreenshots/3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added metadata/en-US/images/tenInchScreenshots/4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added metadata/en-US/images/tenInchScreenshots/5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added metadata/en-US/images/tenInchScreenshots/6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added metadata/en-US/images/tenInchScreenshots/7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion metadata/en-US/short_description.txt
Original file line number Diff line number Diff line change
@@ -1 +1 @@
All your Mastodon, Bluesky, Misskey, X, RSS feeds, in one APP.
Browse Mastodon, Bluesky, X, Misskey, Nostr and RSS all in one app.
Loading