From fd0577bd56234625989ea90ce8e926a15c33e3f3 Mon Sep 17 00:00:00 2001
From: tidbit1 <194808961+tidbit1@users.noreply.github.com>
Date: Mon, 19 May 2025 10:20:30 +0100
Subject: [PATCH 1/2] improve ReadMe
---
README.md | 98 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
1 file changed, 94 insertions(+), 4 deletions(-)
diff --git a/README.md b/README.md
index 10a6fc7..ef90ed7 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,97 @@
-
+
-Easily manage your own business by tracking sales, organizing contacts, and generating reports, with Nutshell.
+
-
+## **About the App**
+The Nutshell app integrates your Nutshell B2B CRM platform directly into Deskpro, enabling support and sales teams to work together more efficiently. With this integration, agents can view, create, and link Nutshell contacts, leads, and activities to Deskpro tickets without leaving the helpdesk. Access real-time CRM data, manage leads, and keep customer information up to date — all from within Deskpro. This streamlines workflows, improves visibility for agents, and helps teams close deals faster while delivering excellent customer support.
+
+## **Setting up the app in Deskpro**
+You can follow our [setup guide](./SETUP.md) for a step-by-step guide to setting up the Nutshell 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/nutshell.git
+
+# Change to the project directory
+cd nutshell
+
+# 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/nutshell/graphs/contributors)
+
+
+## License
+Distributed under the MIT License. See [LICENSE.md](LICENSE.md) for more information.
\ No newline at end of file
From 02ffd338fc60f1547e29b0d7e383f441d41cc3e4 Mon Sep 17 00:00:00 2001
From: tidbit1 <194808961+tidbit1@users.noreply.github.com>
Date: Mon, 19 May 2025 10:27:55 +0100
Subject: [PATCH 2/2] add hero and screenshot for ReadMe
---
docs/readme/app-screenshot.png | Bin 0 -> 175359 bytes
readme.svg | 195 +++++++++++++++++++++++++++++++++
2 files changed, 195 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..a9dbbeb44abf67765b550ad91c173ccc2b11cf7c
GIT binary patch
literal 175359
zcmZU4cQl+`^zJ*uAVZ=Hi85MD^csRNqLVOs7cEGX=)H{IB1i-gWk^Jg9zBRIdPMIM
zy+rTjzVrRoy=&cj|FT%-%sG4S^Xz9od!Hz@n&M6P9XJ30H