๐Ÿ“ฆ ionic-team / ionic-docs

๐Ÿ“„ 5-0.md ยท 38 lines
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38---
title: Updating to v5
---

# Updating from Ionic 4 to 5

Migrating an app from Ionic 4 to 5 requires a few updates to the API properties, CSS utilities, and the installed package dependencies.

:::note
This guide assumes that you have already updated your app to the latest version of Ionic 4. Make sure you have followed the [Updating to Ionic 4 Guide](./4-0) before starting this guide.
:::

:::info Breaking Changes
For a **complete list of breaking changes** from Ionic 4 to Ionic 5, please refer to [the breaking changes document](https://github.com/ionic-team/ionic-framework/blob/main/BREAKING_ARCHIVE/v5.md) in the Ionic Framework repository.
:::

### Packages and Dependencies

For Angular based projects, you can simply run:

```shell
npm install @ionic/angular@v5-lts @ionic/angular-toolkit@4.0.0 --save
```

For React projects, you can run:

```shell
npm install @ionic/react@v5-lts @ionic/react-router@v5-lts ionicons@5.5.3
```

For Stencil / vanilla JS projects, you can run:

```shell
npm i @ionic/core@v5-lts --save
```

If you would like a fresh project starter, a new project base can be created from the CLI and an existing app can be migrated over manually.