[
  {
    "path": "LICENSE",
    "content": "MIT License\n\nCopyright (c) 2024 Stuart Ridout & Erik Olsson\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction to use, including without limitation to\nthe rights to use, copy, modify, merge, publish, distribute or sublicense\ncopies of the Software, and while this work is supplied for FREE, you're NOT \nallowed to resell or repackage this app in any commercial offer. You are \nallowed to sell your own Prompt IP and Prompt libraries to import into the app, \nand to permit persons to whom the Software is furnished to do so, subject to \nthe following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n"
  },
  {
    "path": "README.md",
    "content": "## <img align=\"right\" width=\"140\" height=\"120\" src=\"Documentation/images/promptbuddy-logo.png\"> Overview\n### Welcome to the official page for Prompt Buddy! \nWith the Prompt Buddy app, you get a space in Microsoft Teams where your team (or even your entire organization) can share and discover their favourite AI prompts.  The app is preloaded with Microsoft Copilot, and other categories, but you can add your own if you've developed your own AI apps that people are using.\n\nIt's really easy to use and by giving your favourite prompts a ❤️, it raises the most impactful prompts to the top of the leaderboard!\n\n![Screenshot showing overview of the Prompt Buddy app in Light mode with App category](Documentation/images/promptbuddy.png)\n\nIt supports dark mode 🖤 and offers a mobile layout when using Teams on your phone📲. \n\n![Screenshot showing overview of the Prompt Buddy app in Dark mode with Persona category](Documentation/images/PromptBuddy-DarkMode-Customize.png)\n\nPrompt Buddy is a Teams application built on the Power Platform. \n\nOnce installed, it can be [customized and extended](https://docs.microsoft.com/en-us/powerapps/teams/customize-sample-apps) by the installer of the application. \n\n## Installing\nIt's easy! Just click the below link to view our short video tutorial for **Install (6 min) & Demo (8 min)** as an admin.\n\nFollow the steps and Prompt Buddy installs as an unmanaged solution in your environment for Microsoft Teams.\n# [**▶️Video: Install (6 min) & Demo (8 min)📺**](https://aka.ms/PromptBuddyVideo)\n\n**_Recommended_: Install in Teams**\n\n**This is the easiest and quickest method to get started with this app template.** The provisioning is fully automated once the process starts and may take upto 2-3 minutes. You will get the option to chose which team in Teams you'd like to install this app in. \n\nIf this is the first Power App in the team, a new Dataverse for Teams environment will be provisioned, the app installed, automatically shared with all members of the team and tabbed to the channel you select. You will be able to [edit the app](https://docs.microsoft.com/en-us/powerapps/teams/customize-sample-apps) after installation by opening to the Power Apps app in Teams.\n\nNote that this provisions the 'unmanaged' solution in your Teams environment. As noted below, this means that you can take advantage of any future updates being made to the app by updating the application (follow same steps as original installation).\n\nYou'll find more information on features and adoption tips in the [Solution Overview](Documentation/images/Solution%20Overview%20-%20Prompt%20Buddy%20(Public%20version).pdf).\n\n## Updating\n**Smooth Updates**\n\nIf/When you import a new release of Prompt Buddy into the same environment, it updates any existing installation while keeping all your settings and prompts intact. Just follow the video again. Now that's smoooooth.\n\nGood to know: \n\nNew releases can contain new or improved sample prompts (view changelog for details). If you already imported sample prompts from a previous release, we recommend that you edit the JSON script to only include new ones to avoid duplicates.\nShould you happen to be reading this _after_ importing the same sample prompts twice (whoops), simply visit each category from the manager tab to delete any duplicates. \n\n\n***\n\n## NEW! Business Value Report - A free Power BI Template for Prompt Buddy (optional add on)\n\nWant more stats and data on your internal prompts? \n\nYou also get a Business Value Calculator to show and project internal ROI and cost savings!\n\n\n![Business Value Report - Value Calculator section](Documentation/images/ValueCalculatorView.png)\n_This example shows cost savings of prompt sharing in € Euros based on very low usage (6%) and 1,000 employees with an avg. €33 hourly cost._\n_You can easily change all numbers to match your organization and switch between currencies like $ Dollars, £ Pounds, ¥ Yen etc._\n\n\n**Installing the Prompt Buddy Business Value Report** \n\n_⚠️The Business Value Report requires Prompt Buddy to already be installed⚠️_\n\nAll you need is Power BI Desktop (free) and your unique URL.\n1. Make sure you have [Power BI Desktop](https://apps.microsoft.com/detail/9NTXR16HNW1T?hl=en-us&gl=US&ocid=pdpshare) installed from the Microsoft Store.\n\n2. [Download the Prompt Buddy Report PBIT-file](https://github.com/stuartridout/promptbuddy/blob/main/Prompt%20Buddy%20Report%20(Power%20BI).pbit) then simply double click it or open it from Power BI Desktop.\n\n3. You will be asked to enter your unique Dataverse URL. You must remove https:// and the final / for your URL to work.\n\n<img src=\"Documentation/images/Prompt%20Buddy%20Report%20parameter.png\" width=\"500\">\n\nHow to find your unique Dataverse URL:\n\n**Option 1** - Go to [Environments in Power Platform Admin Center](https://admin.powerplatform.microsoft.com/manage/environments) - Hover over the environment where Prompt Buddy is installed to view the URL.\n\nWrite it down or take a screenshot for Copilot to transcribe 😉\n<img width=\"1590\" height=\"642\" alt=\"image\" src=\"https://github.com/user-attachments/assets/fa10ba70-f26c-49cb-a2af-968bc2b44d0b\" />\n\n_**❗Important!** You must enter your URL into Power BI without https:// and the final /, or you will receive an error._\n\n**Option 2** - Head over to the [Power Automate Portal](https://make.powerautomate.com). From here, in the upper right corner, you can select environments. Select the environment where Prompt Buddy is installed. This is usually the same name as the Team in which you have made the installation.\n\n<img src=\"Documentation/images/Prompt%20Buddy%20PowerAutomate%20Environments.png\" width=\"300\">\n\nA new page will open. Now select the settings cog wheel on the upper right corner then open \"Session details\". In this box you'll find the instance URL. Copy the value and paste it into the Power BI Template.\n\n_**❗Important!** You must enter your URL into Power BI without https:// and the final /, or you will receive an error._\n\n<img src=\"Documentation/images/Prompt%20Buddy%20Session%20Details.png\" width=\"600\">\n\nAre you a Power BI wizard 🧙‍♂️? You can edit the report to your liking. Go to [Microsoft MVP Ville's blog](https://www.villezekeviking.com/prompt-buddy-power-bi-template/) to learn more.\n\n\n## FAQ\n##### _\"If we use Prompt Buddy, do we need Microsoft Copilot Prompt Gallery (formerly Copilot lab)?\"_ [- Yes, they're Better Together! - View full answer](https://github.com/stuartridout/promptbuddy/issues/2#issuecomment-2034184541)\n##### _\"Can I share Prompt Buddy as an app in Teams for my entire organization?\"_ - [Yes! Here's how](https://github.com/stuartridout/promptbuddy/issues/46#issue-2481273836)\n##### _\"I'm a Microsoft employee. Where can I access the internal version?\"_ - [aka.ms/PromptBuddy](https://aka.ms/PromptBuddy) _\"-Ok, but how can I add it in Teams?\"_ [aka.ms/PromptBuddy/Teams](https://aka.ms/PromptBuddy/Teams)\n##### _\"Simple link to share this page with a friend?\"_ - [aka.ms/GetPromptBuddy](https://aka.ms/GetPromptBuddy)\n\n\n\n\n\n**We hope you enjoy Prompt Buddy!**\n\n**/Stuart & Erik**\n\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft \ntrademarks or logos is subject to and must follow \n[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\nAny use of third-party trademarks or logos are subject to those third-party's policies.\n\n## <img align=\"right\" width=\"420\" height=\"360\" src=\"Documentation/images/promptbuddy-logo.png\">\n"
  }
]