> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowforma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FlowForma Collaborate Installation

> Install FlowForma Collaborate by uploading the CWM .sppkg file to your SharePoint tenant or site collection app catalog, deploying it, and adding it to a site.

Before using the CWM web parts, upload the .sppkg file to your tenant's app catalog so they're available to add to SharePoint pages.

You can download the latest version of the CWM package [here](https://cdn.flowforma.com/share/spfxv2/live/flowforma-cwm.sppkg) (direct download).

## Prerequisites

Before uploading, ensure the following:

* You have **SharePoint Administrator** or **Site Collection Administrator** privileges.
* The .sppkg file has been generated (e.g., via `gulp bundle --ship` and `gulp package-solution --ship`).
* The **App Catalog** is already created:
  * **Tenant App Catalog:** Managed centrally across all sites.
  * **Site Collection App Catalog:** Scoped to one site collection.

## Access the app catalog

**Tenant App Catalog**

1. Go to:<br />https\://\<your-tenant-name>.sharepoint.com/sites/appcatalog
2. If this site doesn't exist:
   * In the SharePoint Admin Center, navigate to<br />**More features -> Apps -> Open**.
   * Click **App Catalog** and follow the prompts to create one.

**Site Collection App Catalog**

1. Go to your specific site collection.
2. Append /\_layouts/15/appcatalog.aspx to the URL, e.g.:<br />https\://\<your-site>.sharepoint.com/sites/\<yoursite>/\_layouts/15/appcatalog.aspx

## Upload the .sppkg file

1. In the **App Catalog** site, select **Apps for SharePoint**.
2. Click **Upload**.
3. Browse and select your .sppkg file (usually from `sharepoint/solution` in your SPFx project).
4. Click **OK**.

## Trust the app

When prompted:

* Review the app details.
* Check the box for **"Make this solution available to all sites in the organization"** if you want it to be globally available (tenant catalog only).
* Click **Deploy**.

## Verify deployment

After deployment:

* The app should appear in the **Apps for SharePoint** list.
* Check the **Deployed** column -> it should show **Yes**.
* Optionally, check the **App Catalog -> Apps for SharePoint** for version info.

## Add the app to a site

If not globally deployed:

1. Go to your site.
2. Click the **Settings (⚙)** -> **Add an app**.
3. Select your uploaded app.
4. Wait until installation completes.
5. Your SPFx web parts/extensions will now be available in the site.