GitHub - JitHubApp/JitHubV2: GitHub WinUI Client (original) (raw)

JitHub

JitHub is the ultimate UWP app for GitHub lovers 💖. It lets you browse GitHub repositories, issues, pull requests, and more on your Windows device. It is designed to be smooth, fluid, and native, using WinUI for the look and feel and optimized for touch. JitHub is fast, beautiful, and powerful 💪.

Features 🎁

• Browse GitHub repositories by topics, languages, or keywords 🔎
• View repository details, files, commits, issues, pull requests, and actions 📝
• Star, fork, watch, or clone any repository ⭐
• Create, edit, or close issues and pull requests ✅
• Comment on issues and pull requests with Markdown support 🗣️
• Manage your notifications and profile 🔔
• Switch between light and dark themes 🌞🌙

Screenshots 📸

Installation 💾

You can download JitHub from the Microsoft Store or build it from source.

Microsoft Store

Get JitHub from the Microsoft Store and enjoy the best GitHub experience on Windows 😍.

Build from source

To build JitHub from source, you need Visual Studio 2019 with the following workloads:

• Universal Windows Platform development 🖥️

JitHub is powered by the following NuGet packages:

• Microsoft.UI.Xaml 🎨
• Octokit 🐙
• Markdig 📑
• Html Agility Pack 🕸️
• Skiasharp ✏️
• Microsoft.Toolkit.Uwp ⚙️

Then, you need to create a file named appsettings.json in the JitHub project folder with the following content. Go to settings > Developer settings and create an OAuth app. Name it however you like, and in there you can get your clientID and secret. Copy them into the appsettings.json file. This file is gitignored, so please never commit it.

{ "Credential": { "ClientId": "" } }

Finally, set environment variable JithubAppSecret to your GitHub seret and JitHubClientId to your GitHub client ID.

Now you need to download the built vs code files. Run .\download-vscode.ps1 in PowerShell. This script will download the latest release of vs code from jithub-vs-code and unzip it to the JitHub/Assets/dist folder. No additional action needs to be performed.

After that, you can open the JitHub.sln file in Visual Studio and run the app.

Contributing 🙌

JitHub is an open source project and welcomes contributions from anyone. If you want to contribute, please follow these steps:

1. Fork this repository and clone it to your local machine. 🍴
2. Create a new branch for your feature or bug fix. 🌿
3. Make your changes and commit them with a descriptive message. 💬
4. Push your branch to your forked repository. 🚀
5. Create a pull request from your branch to this repository's main branch. 🙏
6. Wait for feedback or approval. 👍

Please follow the code of conduct and the coding style guide when contributing.

License 📄

JitHub is licensed under the MIT License. See LICENSE for details.