This document covers some ideas I have on the workflow a typical Arduino project might have, and how to both make more flexible to add more detail to the UI, mostly to provide more hinting to new users and make common tasks much more visible.
I’ve drawn some very rough UI mockups as part of the description of the workflow, to give more context to how it might be interacted with. Please forgive my terrible drawings!
An example workflow
Starting the IDE should give you an option right out of the box to either work on an existing project, or create a new one. A project is a collection of source code provided by the user, a selected board, and selected libraries. By collecting them together we can ensure the user has a clearer idea what they are operating on. An example start screen could be: