> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# AngularJS libraries removed

> Breaking change notice that all AngularJS libraries have been removed from Itential Core in Platform 6, with guidance on refactoring custom applications and manual tasks.

Beginning with Platform 6, all AngularJS libraries have been removed from Itential Core. These removals will break any customizations that rely on AngularJS. Custom applications that depend on AngularJS for front-end components will need to be updated for each AngularJS library they use. Custom manual tasks will need to be refactored and self-hosted to remain functional.

The following UI libraries in `/lib/angular` are no longer available:

```
ui/lib/angular-animate
ui/lib/angular-app
ui/lib/angular-aria
ui/lib/angular-color-picker
ui/lib/angular-material-data-table
ui/lib/angular-material
ui/lib/angular-sanitize
ui/lib/angular
```

### What should I do?

For any custom applications or manual tasks that rely on AngularJS, Itential recommends refactoring from AngularJS to React so that your application remains functional within Itential Platform.

## Refactor your customization

There are two major aspects when refactoring to remove dependencies on the Itential Core AngularJS libraries. Your use case may fall into one of three scenarios: using AngularJS for a custom application, using AngularJS for a custom manual task, or both.

For custom applications, you have two options:

* **Migrate to React** (recommended) — Migrate entirely from AngularJS to React or a React-based UI library. This is recommended for greater security hardening.
* **Self-host AngularJS** — Continue using AngularJS and update your customization to self-host the utilized libraries.

For custom manual tasks, you must convert the task from AngularJS to React to remain functional in Platform 6.

### Self-host AngularJS

If you wish to continue using AngularJS, follow these steps:

#### Update package.json

Verify if the custom application depends on the following packages. If so, add the corresponding lines to the `package.json` file:

```json
{
    "dependencies": {
        "angular": "1.5.11",
        "angular-animate": "1.5.11",
        "angular-aria": "1.5.11",
        "angular-color-picker": "1.0.10",
        "angular-material": "1.0.7",
        "angular-material-data-table": "0.10.3",
        "angular-sanitize": "1.5.11"
    }
}
```

#### Install dependencies

```bash
npm install
```

#### Create a lib directory

Create a new directory at the application root to serve the AngularJS files:

```bash
mkdir lib
```

#### Create symbolic links

Run the following command for each AngularJS package your application depends on. This creates a symbolic link pointing to the AngularJS files in the new directory:

```bash
ln -s ../node_modules/<package-name> lib/<package-name>
```

For example: `ln -s ../node_modules/angular lib/angular`

#### Register the directory

In the `pronghorn.json` file of the application, add the new directory as a `uiDirectory`:

```json
"uiDirectories": ["lib"]
```

#### Update script references

Update any references to the old Itential Platform provided AngularJS instance to the new location:

```bash
script(src="/lib/angular/angular.min.js") → script(src="./lib/angular/angular.min.js")
```

### Convert custom manual tasks to React

Custom manual tasks that rely on AngularJS are no longer supported in Platform 6 and must be converted to React or a React-based UI library. All tasks must be converted entirely to React.

If you encounter any issues while refactoring or would like to request a template, contact the [Product Support Team](https://itential.atlassian.net/servicedesk/customer/portals).

## Related reading

* [Breaking change (2023.2): AngularJS not supported in manual tasks](/itential-platform/release-notes/breaking-changes/angularjs-libraries-removed)
* [Deprecation (2023.2): AngularJS removed](/itential-platform/2023-2/release-notes/deprecations/angularjs-deprecated)