-View your GitHub issues from Deskpro and link them to tickets you are working on
+
-
+## **About the App**
+The GitHub App enhances your Deskpro experience by integrating GitHub's powerful issue tracking and repository management features directly into your helpdesk. With this app, agents can link tickets to GitHub issues, track their progress in real-time, and streamline collaboration between support and development teams.
-[Find out more about our Github App](https://www.deskpro.com/apps/github)
+## **Setting up the app in Deskpro**
+You can follow our [set-up guide](./SETUP.md) for a step-by-step guide to setting up the GitHub app in Deskpro.
+
+## Development
+
+### With DevContainers (Recommended)
+To make development easier and avoid version conflicts, we recommend using **DevContainers** for local development. This approach ensures that everyone on the team uses the same environment, reducing setup issues and version mismatches between dependencies.
+
+#### Why use DevContainers?
+- **Consistency:** All developers work in the same environment, with the same versions of dependencies, tools, and configurations.
+- **Speed:** The DevContainer setup is quick to start, letting you focus on coding rather than environment setup.
+- **Isolation:** Avoid conflicts between different versions of Node.js, PNPM, or other dependencies by using the predefined container setup.
+
+#### Getting Started with DevContainers
+1. Ensure that you have [Docker](https://www.docker.com/get-started) and [VS Code](https://code.visualstudio.com/) installed.
+2. Open the project in [VS Code](https://code.visualstudio.com/).
+3. If you have the **Remote - Containers** extension installed, [VS Code](https://code.visualstudio.com/) should automatically detect the `.devcontainer` configuration in this project and prompt you to reopen the folder in the container.
+4. After opening the project in the DevContainer, run:
+ ```bash
+ pnpm start
+ ```
+
+You should now be able to view the app in your browser. For more information about developing [Deskpro apps](https://www.deskpro.com/apps), [Visit the docs](https://support.deskpro.com/ga/guides/developers/anatomy-of-an-app).
+
+### Natively
+_We recommend using the DevContainer mentioned above for Consistency, Speed and Isolation._
+
+This app was developed primarily using **TypeScript**, **React**, and **Vite**.
+
+#### Setup
+To run this project locally:
+
+ ```bash
+# Clone the repository
+git clone https://github.com/DeskproApps/github.git
+
+# Change to the project directory
+cd github
+
+# Install dependencies
+pnpm install
+
+# Run the development server
+pnpm start
+```
+
+You should now be able to view the app in your browser. For more information about developing [Deskpro Apps](https://www.deskpro.com/apps), [Visit the Docs](https://support.deskpro.com/ga/guides/developers/anatomy-of-an-app).
+
+### Testing
+We've included `jest` to run tests. It will look anywhere in `/src` for test suite files ending in `.test.tsx` or `.test.ts`.
+
+You can run all tests using:
+
+```bash
+pnpm test
+```
+
+## Versioning
+Every app deployment requires that the version property in the `manifest.json` file be updated to reflect the new app version. This is so Deskpro can detect changes and add/upgrade apps accordingly. As such, we've made altering versions easy by having CI make the actual version change for you. Here's what we do:
+
+* We increment **patch** versions, i.e. 1.0.1, automatically. This is the default
+* **Minor** versions, i.e. 1.1.0, are incremented if you add the `minor-version` GitHub label to your PR
+* **Major** versions, i.e. 2.0.0, are incremented if you add the `major-version` GitHub label to your PR
+
+## Top Contributors
+[](https://github.com/deskproapps/github/graphs/contributors)
+
+
+## License
+Distributed under the MIT License. See [LICENSE.md](LICENSE.md) for more information.
\ No newline at end of file
From e20244b053608831b9fbf0dadebfb64b6aa25b96 Mon Sep 17 00:00:00 2001
From: tidbit1 <194808961+tidbit1@users.noreply.github.com>
Date: Tue, 13 May 2025 14:47:49 +0100
Subject: [PATCH 2/3] fix typo
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 40e7009..ef40a15 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@
The GitHub App enhances your Deskpro experience by integrating GitHub's powerful issue tracking and repository management features directly into your helpdesk. With this app, agents can link tickets to GitHub issues, track their progress in real-time, and streamline collaboration between support and development teams.
## **Setting up the app in Deskpro**
-You can follow our [set-up guide](./SETUP.md) for a step-by-step guide to setting up the GitHub app in Deskpro.
+You can follow our [setup guide](./SETUP.md) for a step-by-step guide to setting up the GitHub app in Deskpro.
## Development
From f93beecc8e68cac314b47fffcea34e4cd541eee3 Mon Sep 17 00:00:00 2001
From: tidbit1 <194808961+tidbit1@users.noreply.github.com>
Date: Tue, 13 May 2025 15:05:04 +0100
Subject: [PATCH 3/3] add hero and screenshot for ReadMe
---
docs/readme/app-screenshot.png | Bin 0 -> 36100 bytes
readme.svg | 189 +++++++++++++++++++++++++++++++++
2 files changed, 189 insertions(+)
create mode 100644 docs/readme/app-screenshot.png
create mode 100644 readme.svg
diff --git a/docs/readme/app-screenshot.png b/docs/readme/app-screenshot.png
new file mode 100644
index 0000000000000000000000000000000000000000..61810a39dbb19ceb09e0d5f5a0b6f9844642e27e
GIT binary patch
literal 36100
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
+ 
+ 
+ 
+ 
+ 
+
+