No description
Find a file
2023-07-07 13:41:48 -04:00
.github 🎨 2023-06-29 21:06:26 +02:00
.vscode remove unused vscode setting 2021-07-06 13:08:33 -03:00
app Revert accidental comment modification 2023-07-07 13:41:48 -04:00
docs Merge branch 'development' into reuse-workflow 2023-07-04 09:43:47 +02:00
eslint-rules We can have nice things! 2022-03-04 00:45:39 +01:00
gemoji@50865e8895 Get some gemoji 2016-09-02 16:44:44 -04:00
script Merge branch 'development' into reuse-workflow 2023-07-04 09:43:47 +02:00
vendor Upgrade to Yarn 1.21.1 2020-03-02 09:48:57 -08:00
.eslintignore Get rid of unused coverage reporting 2022-05-04 12:13:38 +02:00
.eslintrc.yml Update es lint rules 2023-05-31 08:29:19 -04:00
.gitattributes Force unix line endings in WSL github helper 2020-09-02 18:12:47 +02:00
.gitignore Ignore VS Code logs in project gitignore 2022-04-29 15:54:13 -04:00
.gitmodules switched this submodule over to using HTTPS 2017-04-11 17:52:04 +10:00
.markdownlint.js Add markdownlint to package json 2022-08-29 06:51:24 -04:00
.node-version Use Node 18.14.0 2023-05-02 14:18:03 -04:00
.nvmrc Use Node 18.14.0 2023-05-02 14:18:03 -04:00
.prettierignore format all json files 2019-05-03 09:24:59 -03:00
.prettierrc.yml Update prettier and eslint for optional chaining support 2020-06-24 17:43:46 +00:00
.python-version Update the Python version to 3.9 in dotfiles 2021-05-15 02:52:52 +02:00
.tool-versions Use Node 18.14.0 2023-05-02 14:18:03 -04:00
.yarnrc Upgrade to Yarn 1.21.1 2020-03-02 09:48:57 -08:00
changelog.json Enable section lists and add changelog line 2023-07-04 16:37:43 +02:00
CODE_OF_CONDUCT.md Update contact behavior to be more clear 2018-08-16 08:01:05 -07:00
LICENSE Remove the date range 2017-04-10 13:43:44 -04:00
package.json Merge branch 'development' into reuse-workflow 2023-07-04 09:43:47 +02:00
README.md Remove references to old app, specific linux distributions 2023-04-26 08:37:19 +02:00
SECURITY.md Create SECURITY.md 2022-11-09 12:42:36 -05:00
tsconfig.json Turn on ES2022 🎉 2022-05-04 09:06:43 +02:00
yarn.lock strip out electron-builder config for packaging on Linux 2023-07-03 17:44:42 -03:00

GitHub Desktop

GitHub Desktop is an open source Electron-based GitHub app. It is written in TypeScript and uses React.

A screenshot of the GitHub Desktop application showing changes being viewed and committed with two attributed co-authors

Where can I get it?

Download the official installer for your operating system:

Linux is not officially supported; however, you can find installers created for Linux from a fork of GitHub Desktop in the Community Releases section.

Beta Channel

Want to test out new features and get fixes before everyone else? Install the beta channel to get access to early builds of Desktop:

The release notes for the latest beta versions are available here.

Community Releases

There are several community-supported package managers that can be used to install GitHub Desktop:

  • Windows users can install using winget c:\> winget install github-desktop or Chocolatey c:\> choco install github-desktop
  • macOS users can install using Homebrew package manager: $ brew install --cask github

Installers for various Linux distributions can be found on the shiftkey/desktop fork.

Is GitHub Desktop right for me? What are the primary areas of focus?

This document describes the focus of GitHub Desktop and who the product is most useful for.

I have a problem with GitHub Desktop

Note: The GitHub Desktop Code of Conduct applies in all interactions relating to the GitHub Desktop project.

First, please search the open issues and closed issues to see if your issue hasn't already been reported (it may also be fixed).

There is also a list of known issues that are being tracked against Desktop, and some of these issues have workarounds.

If you can't find an issue that matches what you're seeing, open a new issue, choose the right template and provide us with enough information to investigate further.

The issue I reported isn't fixed yet. What can I do?

If nobody has responded to your issue in a few days, you're welcome to respond to it with a friendly ping in the issue. Please do not respond more than a second time if nobody has responded. The GitHub Desktop maintainers are constrained in time and resources, and diagnosing individual configurations can be difficult and time consuming. While we'll try to at least get you pointed in the right direction, we can't guarantee we'll be able to dig too deeply into any one person's issue.

How can I contribute to GitHub Desktop?

The CONTRIBUTING.md document will help you get setup and familiar with the source. The documentation folder also contains more resources relevant to the project.

If you're looking for something to work on, check out the help wanted label.

Building Desktop

To setup your development environment for building Desktop, check out: setup.md.

More Resources

See desktop.github.com for more product-oriented information about GitHub Desktop.

See our getting started documentation for more information on how to set up, authenticate, and configure GitHub Desktop.

License

MIT

The MIT license grant is not for GitHub's trademarks, which include the logo designs. GitHub reserves all trademark and copyright rights in and to all GitHub trademarks. GitHub's logos include, for instance, the stylized Invertocat designs that include "logo" in the file title in the following folder: logos.

GitHub® and its stylized versions and the Invertocat mark are GitHub's Trademarks or registered Trademarks. When using GitHub's logos, be sure to follow the GitHub logo guidelines.