Bowtie Designer is designed for use on SharePoint® Online only, at present. Here are the steps to install it as a Single Part App Page (available from version 1.1):

Get it here (click one of the flags)

Alternatively, see this video showing installation steps for web part page:

Make app available to users (admin)

This section is the same whether you are using Bowtie Designer as a regular web part or as a Single Part App Page.

1. Use your copy of the software (single file of type .sppkg)
2. Open your SharePoint® App Catalog page. This can be reached through the Admin pages, and you need to be an administrator to use it. If your SharePoint(r) Online domain is https://fabrikam.sharepoint.com, then the App Catalog will be at https://fabrikam.sharepoint.com/sites/appCatalog
3. Click the Upload button and select the file
4. Choose “Only enable app”. DO NOT select “Enable this app and addd it to all sites”, or the install will fail!

5. Then Enable

Add app to a specific site (site owner)

This section is the same whether you are using Bowtie Designer as a regular web part or as a Single Part App Page.

1. Follow the standard Microsoft® process for adding an app to your site, as explained here
2. When you first add Bowtie Designer to a site, it will create a List that you can use for your first diagram (you can make additional lists for more diagrams)

Create Single Part App Page with PowerShell

1. Precondition: you must have registered PowerShell in Entra (the online ActiveDirectory). There are lots of instructions, here is one example.
2. Open Powershell
3. Adapt this basic script for your purposes (insert your own site url the client ID from Entra and your preferred page name), and run it:

$SiteURL = "https://YOURTENANT.sharepoint.com"
$ClientID = "12340610-98ab-4567-cdef-96ef1d88fe00"
Connect-PnPOnline -Url $SiteURL -Interactive -ClientId $ClientID
## complete the logon screen to access your tenant ##
$Page = "My-Single-Page-App"
Add-PnPPage -Name $Page
Set-PnPPage -Identity $Page -LayoutType SingleWebPartAppPage
Add-PnPPageWebPart -Page $Page -Component "Bowtie Designer"

Your page is now created, the remainder of this process is the same as if you had a normal web part page

1. In your browser open the page then “Edit”
2. Using the web app controls, open the app properties pane

6. Choose the automatically-created list as your data source and close the property panel

7. Republish the page
8. The web app will immediately open a ‘starter’ diagram for you, and you may begin editing.

Add Licence Key

If you want to unlock the additional features, then you can purchase a licence key. The key is added directly to property pane of the app, by the site owner, on any pages which host the web part.

The licence key is locked to your SharePoint Online domain (e.g. fabrikam.sharepoint.com), so it is no use to other sites. Make sure you get your host name exactly right when you purchase your licence!