web
You’re offline. This is a read only version of the page.
close
Skip to main content

Notifications

Announcements

Community site session details

Community site session details

Session Id :
Power Platform Community / Forums / Power Apps / how do you document a ...
Power Apps
Unanswered

how do you document a PowerApp?

(2) ShareShare
ReportReport
Posted on by 362

Does anyone have any tips how to document all the settings and curlies in a complex PowerApp, so that the next person along does not have to figure everything out by trial and error? InfoPath had a horrible rule inspector, but PowerApps does not seem to have anything. Is that true?

 

So, what do people do to document their powerful apps?

Categories:
I have the same question (0)
  • v-monli-msft Profile Picture
    on at

    Hi @teylyn1,

     

    You can backup the app by exporting an app as a package.

     

    You can export an app via the following steps:

    image

    • Select Export (preview) for the app you want to export

    image

    • Enter a Name and Description for the package

    image

    • Within the ‘Review Package Content’ section you can optionally add comments or notes or change the setting for how each individual resource will be imported into the target environment during package import

    image

    • When you are done select Export and the package file will begin downloading within a few seconds

    Regards,

    Mona

  • Mike2500 Profile Picture
    1,247 Super User 2024 Season 1 on at

    Manually. PowerApps was designed as an end user tool, and lacks standard IT functions like proper source control, good versioning, and support for any sort of documentation. So, manually.

     

    By manually, I mean it would be great for someone to keep up a doc that lists the logic and reasoning of how the form works. For example, a list of all variables, and a list of every component that changes the value of a variable and why. It goes without saying that this sort of thing sounds ok, but many people have difficulty keeping the docs up to date.

  • teylyn1 Profile Picture
    362 on at

    more than two years later and there still is no better way?

     

  • teylyn1 Profile Picture
    362 on at

    I don't know who set this as the "answer" but it is NOT the answer to my question. So I unselected it. My question is about all the variables, controls, rules, logic, etc that happens inside the app. How is that best documented? Still no answer other than "painfully manual".

  • Community Power Platform Member Profile Picture
    on at

    standardize your names, comment your code, and keep a change log. manual is all there is right now, but if you look at the app version number your can record it. I also tend to save to desktop to archive releases.

  • Mike2500 Profile Picture
    1,247 Super User 2024 Season 1 on at

    Indeed, two years later, the answer is still "painfully manual". However, perhaps check out the new experimental "PSAopa" tool that allows you to edit power apps in Visual Studio. While experimental, it shows that the issue is being worked on? Maybe in another year or two we'll have better capabilities in this area?

     

    Blog post is here: https://powerapps.microsoft.com/en-us/blog/source-code-files-for-canvas-apps/

     

  • teylyn1 Profile Picture
    362 on at

    Power Apps is marketed at the "power user", not developers.  Visual Studio is not in my tool box and never will be. 

  • Mike2500 Profile Picture
    1,247 Super User 2024 Season 1 on at

    As a follow up, the tool I mentioned is challenging to use, even for developers. Or, perhaps "challenging" isn't the right word, but it lacks a good flow in that there are more steps involved than there should be for something that should be so simple. 

     

    So yes, 2.5 years later, the answer of manually still stands. For each power app I create, my docs consist of an overall explanation of the logic. I don't attempt to document every single custom element, but rather just try to provide an understanding so someone who is taking over the project can get a sense of what's going on and will know where to look for things.  

     

    This strategy makes it possible to keep the docs up to date, as I don't need to change the docs for each little thing, as I only add to the docs if the design or logic changes somehow. At the same time, anyone who reads the docs will know where the complicated bits are, and will know why it was designed the way it was. 

     

     

     

     

  • waszumKUCKUCK Profile Picture
    2 on at

    The lack of documentation possibilities is indeed a huge problem if you want to have a maintainable application. 

    We started therefor a communit project. It is a console based application, which extracts the code and the comments from the source files of the Power App and creates a documentation in markdown format.

    It is currently in an early stage, so consider it as as alpha. 

    https://github.com/sebastian-muthwill/powerapps-docstring

  • Paul_2099 Profile Picture
    38 on at

    And here we are, a further 2 years on and the functionality of properly documenting our apps is still nowhere in sight. Relying on 3rd party applications that have small dev teams (if any at all) and limited resources is not a viable long-term solution. the link @waszumKUCKUCK provided is already out of date and unsupported.
    Sigh

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Forum hierarchy changes are complete!

In our never-ending quest to improve we are simplifying the forum hierarchy…

Ajay Kumar Gannamaneni – Community Spotlight

We are honored to recognize Ajay Kumar Gannamaneni as our Community Spotlight for December…

Leaderboard > Power Apps

#1
WarrenBelz Profile Picture

WarrenBelz 796 Most Valuable Professional

#2
Michael E. Gernaey Profile Picture

Michael E. Gernaey 327 Super User 2025 Season 2

#3
Power Platform 1919 Profile Picture

Power Platform 1919 268

Last 30 days Overall leaderboard