FluentHub

A stylish yet powerful GitHub client.

🎁 Installation

Via Microsoft Store

Release mode is currently unstable and therefore packages shall not be uploaded for new versions.

Via GitHub

Release mode is currently unstable and therefore packages shall not be uploaded for new versions.

Building from source ⭐Recommended⭐

This is our preferred method. See the build section.

📸 Screenshots

May not always be up-to-date due to constant changes to the user interface

🧑‍💻 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

🏗️ Codebase Structure

.
├──lib                               // Library for submodules.
|  └──octokit.graphql.net            // Official library for GitHub GraphQL API.
└──src                               // The source code.
   ├──FluentHub.Uwp                  // Code for most front-end elements of the app.
   ├──FluentHub.Core                 // Core elements of the app.
   ├──FluentHub.Octokit              // Code for most back-end and API-related elements of the app such as mutations and queries.
   └──FluentHub.Octokit.Generation   // GitHub GraphQL API model generator.

🗃️ Contributors

🦜 Feedback

• Request a new feature
• Upvote popular feature requests
• File an issue
• Join our Discord and let us know what you think

🔨 Building the Code

1. Prerequisites

Ensure you have following components:

• Windows 10 2004 (10.0.19041.0) or later with Developer Mode on in the Windows Settings
• Git
• Visual Studio 2022 with following individual components:
  • the Windows 11 (10.0.22000.0) SDK
  • UWP Development Kit
  • .NET SDK

2. Git

Clone the repository:

git clone https://github.com/FluentHub/FluentHub

Initialize submodules recursively:

git submodule update --init --recursive

3. Prepare OAuth credentials

See the documentation.

Warning: If you skip this step, Visual Studio will give a fatal error that the AppCrededntials.config file does not exist.

4. Build the project

• Open FluentHub.sln.
• Hit 'Set as Startup item' on FluentHub.Uwp in the Solution Explorer.
• Build with DEBUG|x64|FluentHub.Uwp (Universal Windows).

💳 Credit

• Some application icons created by Icons8.
• Many thanks to Joseph Beattie for creating our current logo.

📱 Contact

The easiest way to contact us is to join our Discord.

If you would like to ask a question, please reach out to us via Twitter:

• Tomoyuki Terashita, Lead Developer: @onein528
• Jupiter, Developer: @DeveloperWOW64
• Gabriel Fontán, Developer: @BobbyESPGabiles
• Luandersonn Airton, Developer: @luandersonn

⚖️ License

Copyright (c) 2022 FluentHub Team

Licensed under the MIT license as stated in the LICENSE.