After you have built a Flow in Power Automate, a canvas app or model-driven app in Power Apps, an agent in Copilot Studio, or any other Power Platform component, you may consider documenting it to allow others to get a better understanding of how it works, to ensure that any specific configuration is kept somewhere else as well, or for other reasons. However, manually documenting the technical implementation can be quite time consuming.
This is where PowerDocu can help!
PowerDocu contains a Windows GUI executable to easily perform technical documentations. It allows the automatic generation of technical documentation for Cloud Flows, Canvas Apps, Model-Driven Apps, Copilot Studio Agents, AI Models, and Solutions (including all contained components). The documentation can be generated as a Word document, as HTML, or in Markdown format (for example to host it in GitHub or Azure DevOps).
- Download the latest release from the Releases page. Choose between the version that requires .NET installed or the standalone package that includes everything.
- Run PowerDocu.exe and head to the Settings tab. Select your preferred output format (Word, Markdown, HTML, or all) and adjust documentation options as needed. Click "Save current configuration as default" to persist your settings. See Settings for all available options.
- Update connector icons by pressing the green download icon in the "Other Options" section. This ensures your documentation includes the latest connector icons.
- Generate documentation — click "Next", then select your exported Flow (.zip), Canvas App (.msapp), or Solution (.zip) file. PowerDocu will generate the documentation in a subfolder next to the source file.
For detailed instructions on exporting Flows, Apps, Agents, and Solutions from the Power Platform, see Installation & Usage.
Watch an introduction and demo of PowerDocu
As part of a Microsoft 365 Community call, an overview and a demo of PowerDocu were given. Want to see the tool in action? Check out this recording on YouTube:
Another recording was done for the Low Code Revolution show hosted by April Dunnam:
Examples of generated documentation
Visit Examples for more details. The screenshots below give an overview of what gets generated
The documentation for each Cloud Flow or Agent Flow includes
- A generated Word document, HTML, or Markdown content including sections on
- General information of the Flow
- The connectors that are used by the Flow
- The Trigger that starts the Flow
- The actions used in the Flow
- A high-level and a detailed diagram of the Flow
- PNG and SVG renditions of the high-level and detailed diagrams
The documentation for each Canvas App includes
- A generated Word document, HTML, or Markdown content including sections on
- General information of the app and its properties
- The global variables and collections used in the app (and in which controls they are used)
- The Data Sources used
- The Resources used
- An overview of the various screens inside the app and the controls inside them
- A detailed list of all controls, together with all their properties
The documentation for each Model-Driven App includes
- A generated Word document, HTML, or Markdown content including sections on
- General information and metadata of the app
- Security roles and permissions
- Site map visualization
- Associated tables and views
- Custom pages
- App settings and resources
The documentation for each Copilot Studio Agent includes
- A generated Word document, HTML, or Markdown content including sections on
- Agent metadata, description, and instructions
- Knowledge sources
- Tools, actions, and connected services
- Topics, triggers, and activation methods
- Entities and variables
- Flow graphs for each topic and data flow diagrams across topics
The documentation for each AI Model includes
- A generated Word document, HTML, or Markdown content including sections on
- AI model metadata and configuration
The documentation for a Solution includes
- Generated documentation for each Canvas App inside the solution
- Generated documentation for each Cloud Flow inside the solution
- Generated documentation for each Model-Driven App inside the solution
- Generated documentation for each Agent inside the solution
- Generated documentation for each AI Model inside the solution
- Details of the solution itself, including a list of all components inside and documented Dataverse tables
NOTE: If you find any bugs or other issues, please log an Issue in this GitHub project. For any improvement recommendations and suggestions, please open a Discussion. Most importantly, if you want to contribute to this project's code, please fork this repository and submit appropriate Pull Requests. Any kind of contribution is more than welcome!
Please refer to Installation & Usage for information on how to install PowerDocu and how to use it to generate documentation.
Please have a look at the examples provided.
Please have a look at the roadmap for PowerDocu.
If you can think of ways to improve it, here are some things that you can do:
- If it is not working properly or if you find a bug, please log a detailed Issue
- If you have a suggestion on what could be added or what could be done better, please add it under Discussions. Also, please have a look at the existing discussions and add any comments you may have
- Found some ugly code that should be improved? Got an idea for some additional functionality and want to implement it yourself? Please create a fork of this repo, make your changes, and submit a Pull Request!
- Blueprints for Power and Agents is an Open Source Plugin for GitHub Copilot CLI & Claude Code: https://promptclickrun.github.io/power-agents-blueprint/
- The Power CAT Tools app is your ultimate companion for enhancing your development experience within Microsoft Power Platform. The AI documentation part of it leverages AI to created documentation for you: https://github.com/microsoft/Power-CAT-Tools/blob/main/AI_DOCUMENTATION.md
- Mightora Power Platform DevOps Extension is a collection of pipeline tasks designed to automate and streamline the development, deployment, and management of Power Platform solution: https://marketplace.visualstudio.com/items?itemName=mightoraio.mightora-power-platform-devOps-extension (video: https://www.youtube.com/watch?v=iljeesT50uM)
- FlowToVisio, a tool to create Visio representations of your Cloud Flows: https://github.com/LinkeD365/FlowToVisio
Older solutions (likely not actively maintained anymore)
- PowerApps-docstring is a console based, pipeline ready application that automatically generates user and technical documentation for PowerApps: https://github.com/sebastian-muthwill/powerapps-docstring
- Power Apps Helper is a VSCode extension that allows you to generate a solution dependency diagram for your whole environment: https://never-stop-learning.de/analyse-dataverse-solution-dependencies/