FluentHub
The stylish yet powerful GitHub client for Windows.
Build status
Architecture | Debug | Sideload | Store |
---|---|---|---|
x64 | |||
ARM64 |
Localization status
Contributing to translations is of great benefit to the project.
Project | Status |
---|---|
FluentHub.App |
Installation and running FluentHub
Requirements
- Windows 10 or Windows 11 (Build 10.0.19041.0 or newer)
Via Microsoft Store
This is the preferred installation method. It allows you to always be on the latest version when we release new builds via automatic updates.
Via GitHub
Released builds can be manually downloaded from this repository's releases page.
Download the FluentHub_<versionNumber>.msixbundle
file from the Assets
section. In order to install the app, you can simply double-click on the .msixbundle file, and the app installer should automatically run. If that fails for any reason, you can try the following command with a PowerShell prompt:
# NOTE: If you are using PowerShell 7+, please run
# Import-Module Appx -UseWindowsPowerShell
# before using Add-AppxPackage.
Add-AppxPackage FluentHub_<versionNumber>.msixbundle
Building the Code
Requirements
- Windows 10 (Build 10.0.19041.0) or newer with Developer Mode enabled in the Windows Settings
- Git
- Visual Studio 2022:
- Windows App SDK (version 10.0.22621.0)
- .NET 7 SDK (check the box named .NET Desktop Development)
- Windows App SDK
1. Clone the repository
git clone https://github.com/FluentHub/FluentHub
2. Prepare OAuth credentials
See the documentation.
Important
If you skip this step, Visual Studio will give a fatal error that the AppCredentials.config
file does not exist.
3. Build the project
- Open
FluentHub.sln
. - Hit 'Set as Startup item' on
FluentHub.Package
in the Solution Explorer. - Build with
Debug
,x64
,FluentHub.Package
.
Screenshots
Coming soon
Contributing
There are multiple ways to participate in the community:
- Submit bugs and feature requests.
- Review the documentation and make pull requests for anything from typos to additional and new idea
- Review source code changes
If you are interested in fixing issues and contributing directly to the code base, please refer to the documentation, which covers the following:
- How to build and run from source
- The development workflow, including debugging and running tests
- Coding guidelines
- Submitting pull requests
- Finding an issue to work on
- Contributing to translations on Crowdin
Feedback
- Request a new feature
- Upvote popular feature requests
- File an issue
- Join our Discord and let us know what you think
Credit
- Some application icons were created by Icons8.
- Many thanks to Joseph Beattie for creating our current logo.