Skip to content

Commit

Permalink
Migration guide for v4.14.0 (#1852)
Browse files Browse the repository at this point in the history
* Add migration guide to 4.14.0 to re-generate Strapi typings

* Add migration guide to 4.14.0 to re-generate Strapi typings

* Fix latest migration guide title

* Fix latest migration guide h1

* Remove unnecessary TODO
  • Loading branch information
pwizla authored Sep 28, 2023
1 parent 66ec5b4 commit 26037f0
Show file tree
Hide file tree
Showing 2 changed files with 79 additions and 0 deletions.
1 change: 1 addition & 0 deletions docusaurus/docs/dev-docs/migration-guides.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ If there is no specific migration guide between your current version and the lat
- [Migration guide from 4.5.1 to 4.6.1](/dev-docs/migration/v4/migration-guide-4.5.1-to-4.6.1)
- [Migration guide from 4.6.1 to 4.7.0](/dev-docs/migration/v4/migration-guide-4.6.1-to-4.7.0)
- [Migration guide from 4.7.0 to 4.11.4](/dev-docs/migration/v4/migration-guide-4.7.0-to-4.11.4)
- [Migration guide from 4.11.4 to 4.14.0](/dev-docs/migration/v4/migration-guide-4.11.4-to-4.14.0)

## v3 to v4 migration guides

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
---
title: Migrate from 4.11.4 to 4.14.0
displayed_sidebar: devDocsSidebar
description: Learn how you can migrate your Strapi application from 4.14.0 to 4.14.0.
---

import PluginsCaution from '/docs/snippets/migrate-plugins-extension-caution.md'
import BuildCommand from '/docs/snippets/build-npm-yarn.md'
import DevelopCommand from '/docs/snippets/develop-npm-yarn.md'
import InstallCommand from '/docs/snippets/install-npm-yarn.md'

# v4.11.4 to v4.14.0 migration guide

The Strapi v4.11.4 to v4.14.0 migration guide upgrades v4.11.4 to v4.14.0. Strapi v4.14.0 migrated the `strapi/strapi` package to TypeScript and introduced a new `@strapi/typings` package. This migration is required if you have used TypeScript in your project prior to 4.14.0. The migration guide consists of:

- Upgrading the application dependencies
- Generating your TypeScript typings
- Reinitializing the application

<PluginsCaution components={props.components} />


## Upgrading the application dependencies to 4.14.0

:::prerequisites
Stop the server before starting the upgrade.
:::

1. Upgrade all of the Strapi packages in `package.json` to `4.14.0`:

```json title="path: package.json"
{
// ...
"dependencies": {
"@strapi/strapi": "4.14.0",
"@strapi/plugin-users-permissions": "4.14.0",
"@strapi/plugin-i18n": "4.14.0"
// ...
}
}
```

2. Save the edited `package.json` file.

3. Run the install command:
<InstallCommand components={props.components} />

## Generate TypeScript typings

Generate your TypeScript typings by running the following command in the terminal:

<Tabs groupId="yarn-npm">

<TabItem value="yarn" label="yarn">

```bash
yarn strapi ts:generate-types
```

</TabItem>

<TabItem value="npm" label="npm">

```bash
npm run strapi ts:generate-types
```

</TabItem>

</Tabs>

## Rebuild the application

<BuildCommand components={props.components} />

## Restart the application

<DevelopCommand components={props.components} />

1 comment on commit 26037f0

@vercel
Copy link

@vercel vercel bot commented on 26037f0 Sep 28, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Successfully deployed to the following URLs:

documentation – ./

docs-vercel-v4.strapi.io
documentation-strapijs.vercel.app
documentation-git-main-strapijs.vercel.app

Please sign in to comment.