From b2f2a4b71bdfbdab35a46ad84af8033eb6369be3 Mon Sep 17 00:00:00 2001
From: Sean Perkins <sean@ionic.io>
Date: Fri, 12 Nov 2021 14:31:18 -0500
Subject: [PATCH 1/5] docs(): docs reference main instead of master (#24216)

---
 .github/COMPONENT-GUIDE.md    | 20 +++++------
 .github/CONTRIBUTING.md       |  8 ++---
 .github/PROCESS.md            | 62 +++++++++++++++++------------------
 .scripts/release.js           |  2 +-
 README.md                     |  4 +--
 angular/BREAKING.md           |  6 ++--
 angular/README.md             |  4 +--
 core/stencil.config.ts        |  2 +-
 docs/README.md                |  2 +-
 packages/react/README.md      |  2 +-
 packages/vue-router/README.md |  2 +-
 packages/vue/CHANGELOG.md     |  2 +-
 packages/vue/README.md        |  2 +-
 13 files changed, 59 insertions(+), 59 deletions(-)

diff --git a/.github/COMPONENT-GUIDE.md b/.github/COMPONENT-GUIDE.md
index 6874dc1d2c..656aed4fb7 100644
--- a/.github/COMPONENT-GUIDE.md
+++ b/.github/COMPONENT-GUIDE.md
@@ -356,9 +356,9 @@ ion-ripple-effect {
 
 ### Example Components
 
-- [ion-button](https://github.com/ionic-team/ionic/tree/master/core/src/components/button)
-- [ion-back-button](https://github.com/ionic-team/ionic/tree/master/core/src/components/back-button)
-- [ion-menu-button](https://github.com/ionic-team/ionic/tree/master/core/src/components/menu-button)
+- [ion-button](https://github.com/ionic-team/ionic/tree/main/core/src/components/button)
+- [ion-back-button](https://github.com/ionic-team/ionic/tree/main/core/src/components/back-button)
+- [ion-menu-button](https://github.com/ionic-team/ionic/tree/main/core/src/components/menu-button)
 
 ### References
 
@@ -372,7 +372,7 @@ ion-ripple-effect {
 
 #### Example Components
 
-- [ion-checkbox](https://github.com/ionic-team/ionic/tree/master/core/src/components/checkbox)
+- [ion-checkbox](https://github.com/ionic-team/ionic/tree/main/core/src/components/checkbox)
 
 #### VoiceOver
 
@@ -498,7 +498,7 @@ This is a compromise we have to make in order for it to work with the other scre
 
 #### Example Components
 
-- [ion-toggle](https://github.com/ionic-team/ionic/tree/master/core/src/components/toggle)
+- [ion-toggle](https://github.com/ionic-team/ionic/tree/main/core/src/components/toggle)
 
 #### Voiceover
 
@@ -631,11 +631,11 @@ Certain components can render an `<a>` or a `<button>` depending on the presence
 
 ### Example Components
 
-- [ion-button](https://github.com/ionic-team/ionic/tree/master/core/src/components/button)
-- [ion-card](https://github.com/ionic-team/ionic/tree/master/core/src/components/card)
-- [ion-fab-button](https://github.com/ionic-team/ionic/tree/master/core/src/components/fab-button)
-- [ion-item-option](https://github.com/ionic-team/ionic/tree/master/core/src/components/item-option)
-- [ion-item](https://github.com/ionic-team/ionic/tree/master/core/src/components/item)
+- [ion-button](https://github.com/ionic-team/ionic/tree/main/core/src/components/button)
+- [ion-card](https://github.com/ionic-team/ionic/tree/main/core/src/components/card)
+- [ion-fab-button](https://github.com/ionic-team/ionic/tree/main/core/src/components/fab-button)
+- [ion-item-option](https://github.com/ionic-team/ionic/tree/main/core/src/components/item-option)
+- [ion-item](https://github.com/ionic-team/ionic/tree/main/core/src/components/item)
 
 ### Component Structure
 
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index c17dcf6128..c93dc56ffb 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -36,7 +36,7 @@ Thanks for your interest in contributing to the Ionic Framework! :tada:
 
 ## Contributing Etiquette
 
-Please see our [Contributor Code of Conduct](https://github.com/ionic-team/ionic/blob/master/CODE_OF_CONDUCT.md) for information on our rules of conduct.
+Please see our [Contributor Code of Conduct](https://github.com/ionic-team/ionic/blob/main/CODE_OF_CONDUCT.md) for information on our rules of conduct.
 
 
 ## Creating an Issue
@@ -93,7 +93,7 @@ Without a reliable code reproduction, it is unlikely we will be able to resolve
 1. [Download the installer](https://nodejs.org/) for the LTS version of Node.js. This is the best way to also [install npm](https://blog.npmjs.org/post/85484771375/how-to-install-npm#_=_).
 2. Fork this repository.
 3. Clone your fork.
-4. Create a new branch from master for your change.
+4. Create a new branch from main for your change.
 5. Navigate into the directory of the package you wish to modify (core, angular, etc.).
 6. Run `npm install` to install dependencies for this package.
 7. Follow the steps for the specific package below.
@@ -219,14 +219,14 @@ Without a reliable code reproduction, it is unlikely we will be able to resolve
 
 ### Submit Pull Request
 
-1. [Create a new pull request](https://github.com/ionic-team/ionic/compare) with the `master` branch as the `base`. You may need to click on `compare across forks` to find your changes.
+1. [Create a new pull request](https://github.com/ionic-team/ionic/compare) with the `main` branch as the `base`. You may need to click on `compare across forks` to find your changes.
 2. See the [Creating a pull request from a fork](https://help.github.com/articles/creating-a-pull-request-from-a-fork/) GitHub help article for more information.
 3. Please fill out the provided Pull Request template to the best of your ability and include any issues that are related.
 
 
 ## Commit Message Guidelines
 
-We have very precise rules over how our git commit messages should be formatted. This leads to readable messages that are easy to follow when looking through the project history. We also use the git commit messages to generate our [changelog](https://github.com/ionic-team/ionic/blob/master/CHANGELOG.md). Our format closely resembles Angular's [commit message guidelines](https://github.com/angular/angular/blob/master/CONTRIBUTING.md#commit).
+We have very precise rules over how our git commit messages should be formatted. This leads to readable messages that are easy to follow when looking through the project history. We also use the git commit messages to generate our [changelog](https://github.com/ionic-team/ionic/blob/main/CHANGELOG.md). Our format closely resembles Angular's [commit message guidelines](https://github.com/angular/angular/blob/main/CONTRIBUTING.md#commit).
 
 ### Commit Message Format
 
diff --git a/.github/PROCESS.md b/.github/PROCESS.md
index 2a9f61df2e..aa3d93448c 100644
--- a/.github/PROCESS.md
+++ b/.github/PROCESS.md
@@ -95,81 +95,81 @@ Issues with this label are not automatically closed and locked, so we manually c
 
 We have two long-living branches:
 
-- `master`: completed features, bug fixes, refactors, chores
+- `main`: completed features, bug fixes, refactors, chores
 - `stable`: the latest release
 
 The overall flow:
 
-1. Feature, refactor, and bug fix branches are created from `master`
-1. When a feature, refactor, or fix is complete it is merged into `master`
-1. A release branch is created from `master`
-1. When the release branch is done it is merged into `master` and `stable`
+1. Feature, refactor, and bug fix branches are created from `main`
+1. When a feature, refactor, or fix is complete it is merged into `main`
+1. A release branch is created from `main`
+1. When the release branch is done it is merged into `main` and `stable`
 1. If an issue in `stable` is detected a hotfix branch is created from `stable`
-1. Once the hotfix is complete it is merged to both `master` and `stable`
-1. All branches should follow the syntax of `{type}-{details}` where `{type}` is the type of branch (`hotfix`, `release`, or one of the [commit types](https://github.com/ionic-team/ionic/blob/master/.github/CONTRIBUTING.md#commit-message-format)) and `{details}` is a few hyphen separated words explaining the branch
+1. Once the hotfix is complete it is merged to both `main` and `stable`
+1. All branches should follow the syntax of `{type}-{details}` where `{type}` is the type of branch (`hotfix`, `release`, or one of the [commit types](https://github.com/ionic-team/ionic/blob/main/.github/CONTRIBUTING.md#commit-message-format)) and `{details}` is a few hyphen separated words explaining the branch
 
-### Stable and Master Branches
+### Stable and Main Branches
 
 #### Stable Branch
 
 Branches created from `stable`:
 
-The following branch should be merged back to **both** `master` and `stable`:
+The following branch should be merged back to **both** `main` and `stable`:
 
 - A `hotfix` branch (e.g. `hotfix-missing-export`): a bug fix that is fixing a regression or issue with a published release
 
 A `hotfix` branch should be the **only** branch that is created from stable.
 
-#### Master Branch
+#### Main Branch
 
-Branches created from `master`:
+Branches created from `main`:
 
-The following branches should be merged back to `master` via a pull request:
+The following branches should be merged back to `main` via a pull request:
 
 1. A feature branch (e.g. `feat-desktop-support`): an addition to the API that is not a bug fix or regression fix
 1. A bug fix branch (e.g. `fix-tab-color`): a bug fix that is not fixing a regression or issue with a published release
-1. All other types listed in the [commit message types](https://github.com/ionic-team/ionic/blob/master/.github/CONTRIBUTING.md#commit-message-format): `docs`, `style`, `refactor`, `perf`, `test`, `chore`
+1. All other types listed in the [commit message types](https://github.com/ionic-team/ionic/blob/main/.github/CONTRIBUTING.md#commit-message-format): `docs`, `style`, `refactor`, `perf`, `test`, `chore`
 
-The following branch should be merged back to **both** `master` and `stable`:
+The following branch should be merged back to **both** `main` and `stable`:
 
 1. A `release` branch (e.g. `release-4.1.x`): contains all fixes and (optionally) features that are tested and should go into the release
 
 
 ### Feature Branches
 
-Each new feature should reside in its own branch, based on the `master` branch. When a feature is complete, it should go into a pull request that gets merged back into `master`. A pull request adding a feature should be approved by two team members. Features should never interact directly with `stable`.
+Each new feature should reside in its own branch, based on the `main` branch. When a feature is complete, it should go into a pull request that gets merged back into `main`. A pull request adding a feature should be approved by two team members. Features should never interact directly with `stable`.
 
 
 ### Release Branches
 
-Once `master` has acquired enough features for a release (or a predetermined release date is approaching), fork a release branch off of `master`. Creating this branch starts the next release cycle, so no new features can be added after this point - only bug fixes, documentation generation, and other release-oriented tasks should go in this branch.
+Once `main` has acquired enough features for a release (or a predetermined release date is approaching), fork a release branch off of `main`. Creating this branch starts the next release cycle, so no new features can be added after this point - only bug fixes, documentation generation, and other release-oriented tasks should go in this branch.
 
-Once the release is ready to ship, it will get merged into `stable` and `master`, then the release branch will be deleted. It’s important to merge back into `master` because critical updates may have been added to the release branch and they need to be accessible to new features. This should be done in a pull request after review.
+Once the release is ready to ship, it will get merged into `stable` and `main`, then the release branch will be deleted. It’s important to merge back into `main` because critical updates may have been added to the release branch and they need to be accessible to new features. This should be done in a pull request after review.
 
 See the [steps for releasing](#releasing) below for detailed information on how to publish a release.
 
 ### Version Branches
 
-Once a release has shipped and the release branch has been merged into `stable` and `master` it should also be merged into its corresponding version branch. These version branches allow us to ship updates for specific versions of the framework (i.e. Lets us ship a bug fix that only affects 4.2.x).
+Once a release has shipped and the release branch has been merged into `stable` and `main` it should also be merged into its corresponding version branch. These version branches allow us to ship updates for specific versions of the framework (i.e. Lets us ship a bug fix that only affects 4.2.x).
 
 Patch releases should be merged into their corresponding version branches. For example, a `release-4.1.1` branch should be merged into the `4.1.x` version branch and a `release-5.0.1` branch should be merged into the `5.0.x` version branch.
 
-When releasing a major version such as `5.0.0 ` or a minor version such as `4.1.0` , the version branch will not exist. The version branch should be created once the release branch has been merged into `stable` and `master`. For example, when releasing `4.1.0`, the `release-4.1.0` release branch should be merged into `stable` and `master` and then the `4.1.x` version branch should be created off the latest `stable`.
+When releasing a major version such as `5.0.0 ` or a minor version such as `4.1.0` , the version branch will not exist. The version branch should be created once the release branch has been merged into `stable` and `main`. For example, when releasing `4.1.0`, the `release-4.1.0` release branch should be merged into `stable` and `main` and then the `4.1.x` version branch should be created off the latest `stable`.
 
 
 ### Hotfix Branches
 
-Maintenance or “hotfix” branches are used to quickly patch production releases. This is the only branch that should fork directly off of `stable`. As soon as the fix is complete, it should be merged into both `stable` and `master` (or the current release branch).
+Maintenance or “hotfix” branches are used to quickly patch production releases. This is the only branch that should fork directly off of `stable`. As soon as the fix is complete, it should be merged into both `stable` and `main` (or the current release branch).
 
 
 ### Examples
 
 #### Making a Change
 
-1. Create a branch from `master`.
+1. Create a branch from `main`.
 1. Make changes. Limit your changes to a "unit of work", meaning don't include irrelevant changes that may confuse and delay the change.
 1. Push changes.
-1. Create a PR with the base of `master`.
+1. Create a PR with the base of `main`.
 1. Have someone approve your change (optional right now--at your discretion).
 
     <img width="236" alt="image" src="https://user-images.githubusercontent.com/236501/47031893-913e0480-d136-11e8-9d9a-4b6297a4d7ba.png">
@@ -182,13 +182,13 @@ Maintenance or “hotfix” branches are used to quickly patch production releas
 
     <img width="192" alt="Squash and merge button" src="https://user-images.githubusercontent.com/236501/47031620-da418900-d135-11e8-91ff-e84f2478b2b3.png">
 
-1. During confirmation, rewrite the commit message using our [Commit Message Format guidelines](https://github.com/ionic-team/ionic/blob/master/.github/CONTRIBUTING.md#commit-message-format). Keep the `(#1234)` at the end; it will create a link to the PR in the commit history and `CHANGELOG.md`. This is where commits on `master` become permanent.
+1. During confirmation, rewrite the commit message using our [Commit Message Format guidelines](https://github.com/ionic-team/ionic/blob/main/.github/CONTRIBUTING.md#commit-message-format). Keep the `(#1234)` at the end; it will create a link to the PR in the commit history and `CHANGELOG.md`. This is where commits on `main` become permanent.
 
     <img width="672" alt="Squash and merge confirmation" src="https://user-images.githubusercontent.com/236501/47031753-31dff480-d136-11e8-9116-03934961bdc2.png">
 
-1. Confirm squash and merge into `master`.
+1. Confirm squash and merge into `main`.
 
-#### Updating from `master`
+#### Updating from `main`
 
 1. Pull the latest changes locally.
 1. Merge the changes, fixing any conflicts.
@@ -204,7 +204,7 @@ OR
 
 #### Hotfixes
 
-Hotfixes bypass `master` and should only be used for urgent fixes that can't wait for the next release to be ready.
+Hotfixes bypass `main` and should only be used for urgent fixes that can't wait for the next release to be ready.
 
 1. Create a branch from `stable`.
 1. Make changes.
@@ -215,13 +215,13 @@ Hotfixes bypass `master` and should only be used for urgent fixes that can't wai
 
     <img width="192" alt="Squash and merge button" src="https://user-images.githubusercontent.com/236501/47031620-da418900-d135-11e8-91ff-e84f2478b2b3.png">
 
-1. During confirmation, rewrite the commit message using our [Commit Message Format guidelines](https://github.com/ionic-team/ionic/blob/master/.github/CONTRIBUTING.md#commit-message-format). Keep the `(#1234)` at the end; it will create a link to the PR in the commit history and `CHANGELOG.md`. This is where commits on `master` become permanent.
+1. During confirmation, rewrite the commit message using our [Commit Message Format guidelines](https://github.com/ionic-team/ionic/blob/main/.github/CONTRIBUTING.md#commit-message-format). Keep the `(#1234)` at the end; it will create a link to the PR in the commit history and `CHANGELOG.md`. This is where commits on `main` become permanent.
 
     <img width="672" alt="Squash and merge confirmation" src="https://user-images.githubusercontent.com/236501/47031753-31dff480-d136-11e8-9116-03934961bdc2.png">
 
 1. Confirm squash and merge into `stable`.
 1. CI builds `stable`, performing the release.
-1. Create a PR to merge `stable` into `master`.
+1. Create a PR to merge `stable` into `main`.
 1. Click **Merge pull request**. Use the dropdown to select this option if necessary.
 
     <img width="191" alt="Merge pull request button" src="https://user-images.githubusercontent.com/236501/47032669-8be1b980-d138-11e8-9a90-d1518c223184.png">
@@ -229,7 +229,7 @@ Hotfixes bypass `master` and should only be used for urgent fixes that can't wai
 
 ## Releasing
 
-1. Create the release branch from `master`, for example: `release-4.5.0`.
+1. Create the release branch from `main`, for example: `release-4.5.0`.
 
 1. For major or minor releases, create a version branch based off the latest version branch. For example, if releasing 4.5.0, create a branch called `4.5.x` based off `4.4.x`.
 
@@ -244,7 +244,7 @@ Hotfixes bypass `master` and should only be used for urgent fixes that can't wai
 1. Run `npm run release.prepare`
     - Select the version based on the type of commits and the [Ionic Versioning](https://ionicframework.com/docs/intro/versioning)
     - After the process completes, verify the version number in all packages (`core`, `docs`, `angular`)
-    - Verify the changelog commits are accurate and follow the [proper format]((https://github.com/ionic-team/ionic/blob/master/.github/CONTRIBUTING.md#commit-message-format))
+    - Verify the changelog commits are accurate and follow the [proper format]((https://github.com/ionic-team/ionic/blob/main/.github/CONTRIBUTING.md#commit-message-format))
     - For major or minor releases, ensure that the version number has an associated title (for example: `4.5.0 Boron`)
     - Commit these changes with the version number as the message, e.g. `git commit -m "4.5.0"`
 
@@ -258,4 +258,4 @@ Hotfixes bypass `master` and should only be used for urgent fixes that can't wai
 
 1. Rewrite the commit message to `merge release-[VERSION]` with the proper release branch. For example, if this release is for `4.5.0`, the message would be `merge release-4.5.0`.
 
-1. Submit a pull request from the release branch into `master`. Merge this pull request using the same commit format in the last step, to ensure any changes made on the release branch get added to future releases.
+1. Submit a pull request from the release branch into `main`. Merge this pull request using the same commit format in the last step, to ensure any changes made on the release branch get added to future releases.
diff --git a/.scripts/release.js b/.scripts/release.js
index ff13bfe655..fea7512d37 100644
--- a/.scripts/release.js
+++ b/.scripts/release.js
@@ -127,7 +127,7 @@ async function publishGithub(version, gitTag, changelog, npmTag) {
   let branch = await execa.stdout('git', ['symbolic-ref', '--short', 'HEAD']);
 
   if (!branch) {
-    branch = 'master';
+    branch = 'main';
   }
 
   await octokit.repos.createRelease({
diff --git a/README.md b/README.md
index 9ba2b16b0c..d24b6ffb98 100644
--- a/README.md
+++ b/README.md
@@ -30,11 +30,11 @@ an [issue](https://github.com/ionic-team/ionic/issues/new) on this repository.
 ### Contributing
 
 Thanks for your interest in contributing! Read up on our guidelines for
-[contributing](https://github.com/ionic-team/ionic/blob/master/.github/CONTRIBUTING.md)
+[contributing](https://github.com/ionic-team/ionic/blob/main/.github/CONTRIBUTING.md)
 and then look through our issues with a [help wanted](https://github.com/ionic-team/ionic/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)
 label.
 
-Please note that this project is released with a [Contributor Code of Conduct](https://github.com/ionic-team/ionic/blob/master/CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
+Please note that this project is released with a [Contributor Code of Conduct](https://github.com/ionic-team/ionic/blob/main/CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
 
 
 ### Examples
diff --git a/angular/BREAKING.md b/angular/BREAKING.md
index b231ec2160..7a791bc096 100644
--- a/angular/BREAKING.md
+++ b/angular/BREAKING.md
@@ -137,7 +137,7 @@ The back button is no longer added by default to a navigation bar. It should be
 </ion-toolbar>
 ```
 
-See the [back button documentation](https://github.com/ionic-team/ionic/blob/master/core/src/components/back-button) for more usage examples.
+See the [back button documentation](https://github.com/ionic-team/ionic/blob/main/core/src/components/back-button) for more usage examples.
 
 ## Button
 
@@ -507,7 +507,7 @@ _In the following examples, `{breakpoint}` refers to the optional screen breakpo
 - `push-{breakpoint}-{value}` attributes have been renamed to `push-{breakpoint}=“{value}”`
 - `pull-{breakpoint}-{value}` attributes have been renamed to `pull-{breakpoint}=“{value}”`
 
-Customizing the padding and width of a grid should now be done with CSS variables. For more information, see [Grid Layout](https://github.com/ionic-team/ionic-docs/blob/master/src/pages/layout/grid.md).
+Customizing the padding and width of a grid should now be done with CSS variables. For more information, see [Grid Layout](https://github.com/ionic-team/ionic-docs/blob/main/src/pages/layout/grid.md).
 
 ## Icon
 
@@ -1689,7 +1689,7 @@ The tab attribute defines the route to be shown upon clicking on this tab.
 </ion-tabs>
 ```
 
-See more usage examples in the [Tabs](https://github.com/ionic-team/ionic/blob/master/core/src/components/tabs) documentation.
+See more usage examples in the [Tabs](https://github.com/ionic-team/ionic/blob/main/core/src/components/tabs) documentation.
 
 
 ## Text / Typography
diff --git a/angular/README.md b/angular/README.md
index f3369a3ba7..b97d890e89 100644
--- a/angular/README.md
+++ b/angular/README.md
@@ -16,11 +16,11 @@ Ionic Angular specific building blocks on top of [@ionic/core](https://www.npmjs
 
 ## License
 
-* [MIT](https://raw.githubusercontent.com/ionic-team/ionic/master/LICENSE)
+* [MIT](https://raw.githubusercontent.com/ionic-team/ionic/main/LICENSE)
 
 ## Testing ng-add in ionic
 
-1. Pull the latest from master
+1. Pull the latest from `main`
 2. Build ionic/angular: `npm run build`
 3. Run `npm link` from `ionic/angular/dist` directory
 4. Create a blank angular project
diff --git a/core/stencil.config.ts b/core/stencil.config.ts
index c44e94a3b9..a29403bc62 100644
--- a/core/stencil.config.ts
+++ b/core/stencil.config.ts
@@ -107,7 +107,7 @@ export const config: Config = {
     {
       type: 'docs-vscode',
       file: 'dist/html.html-data.json',
-      sourceCodeBaseUrl: 'https://github.com/ionic-team/ionic/tree/master/core/',
+      sourceCodeBaseUrl: 'https://github.com/ionic-team/ionic/tree/main/core/',
     },
     {
       type: 'dist',
diff --git a/docs/README.md b/docs/README.md
index 439ad1bfa7..a6fdf0642d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -4,4 +4,4 @@ This package publishes the JSON data used to build the [Ionic API documentation]
 
 ## License
 
-* [MIT](https://raw.githubusercontent.com/ionic-team/ionic/master/LICENSE)
\ No newline at end of file
+* [MIT](https://raw.githubusercontent.com/ionic-team/ionic/main/LICENSE)
\ No newline at end of file
diff --git a/packages/react/README.md b/packages/react/README.md
index 9ec88af101..9f77b26e94 100644
--- a/packages/react/README.md
+++ b/packages/react/README.md
@@ -54,4 +54,4 @@ ionic capacitor open <android|ios>
 
 ## License
 
-- [MIT](https://raw.githubusercontent.com/ionic-team/ionic/master/LICENSE)
+- [MIT](https://raw.githubusercontent.com/ionic-team/ionic/main/LICENSE)
diff --git a/packages/vue-router/README.md b/packages/vue-router/README.md
index a9d76312b3..83cc23717b 100644
--- a/packages/vue-router/README.md
+++ b/packages/vue-router/README.md
@@ -24,7 +24,7 @@ npm run build
 
 ## Contributing
 
-See our [Contributing Guide](https://github.com/ionic-team/ionic-framework/blob/master/.github/CONTRIBUTING.md).
+See our [Contributing Guide](https://github.com/ionic-team/ionic-framework/blob/main/.github/CONTRIBUTING.md).
 
 ## Need Help?
 
diff --git a/packages/vue/CHANGELOG.md b/packages/vue/CHANGELOG.md
index f82d11e972..3537806f14 100644
--- a/packages/vue/CHANGELOG.md
+++ b/packages/vue/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Ionic Vue
 
-> This file contains the changelog for the Ionic Vue beta. For the latest changes, see our [main changelog file](https://github.com/ionic-team/ionic-framework/blob/master/CHANGELOG.md).
+> This file contains the changelog for the Ionic Vue beta. For the latest changes, see our [main changelog file](https://github.com/ionic-team/ionic-framework/blob/main/CHANGELOG.md).
 
 ## 0.5.2
 
diff --git a/packages/vue/README.md b/packages/vue/README.md
index 3b1ea4f2c7..dcfbba9873 100644
--- a/packages/vue/README.md
+++ b/packages/vue/README.md
@@ -38,7 +38,7 @@ npm run build
 
 ## Contributing
 
-See our [Contributing Guide](https://github.com/ionic-team/ionic-framework/blob/master/.github/CONTRIBUTING.md).
+See our [Contributing Guide](https://github.com/ionic-team/ionic-framework/blob/main/.github/CONTRIBUTING.md).
 
 ## Need Help?
 

From 0566ec0da3b8a66a1a1ebb1b235e7297ec483c79 Mon Sep 17 00:00:00 2001
From: Sean Perkins <sean@ionic.io>
Date: Fri, 12 Nov 2021 15:13:37 -0500
Subject: [PATCH 2/5] fix(input): date type in ion-input now aligns correctly
 on iOS 15 (#24217)

---
 core/src/css/core.scss | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/core/src/css/core.scss b/core/src/css/core.scss
index 16c0a57658..d1289b7b52 100644
--- a/core/src/css/core.scss
+++ b/core/src/css/core.scss
@@ -201,3 +201,10 @@ ion-card-header.ion-color .ion-inherit-color {
 .md .menu-content-push {
   box-shadow: $menu-md-box-shadow;
 }
+
+// Safari/iOS 15 changes the appearance of input[type="date"].
+// For backwards compatibility from Ionic 5/Safari 14 designs,
+// we override the appearance only when using within an ion-input.
+ion-input input::-webkit-date-and-time-value {
+  text-align: start;
+}
\ No newline at end of file

From bd8c3e881f3fc5c92df56ef7acf6f809994b0ed6 Mon Sep 17 00:00:00 2001
From: Liam DeBeasi <liamdebeasi@icloud.com>
Date: Wed, 17 Nov 2021 09:27:51 -0500
Subject: [PATCH 3/5] 5.9.0

---
 CHANGELOG.md                              | 16 ++++++++++++++++
 angular/package-lock.json                 | 18 +++++++++---------
 angular/package.json                      |  4 ++--
 core/package-lock.json                    |  4 ++--
 core/package.json                         |  2 +-
 docs/package.json                         |  2 +-
 packages/angular-server/package-lock.json | 18 +++++++++---------
 packages/angular-server/package.json      |  4 ++--
 packages/react-router/package.json        |  4 ++--
 packages/react/package.json               |  4 ++--
 packages/vue-router/package-lock.json     |  4 ++--
 packages/vue-router/package.json          |  2 +-
 packages/vue/package-lock.json            | 18 +++++++++---------
 packages/vue/package.json                 |  4 ++--
 14 files changed, 60 insertions(+), 44 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2b340ef820..323ab38047 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,19 @@
+# [5.9.0](https://github.com/ionic-team/ionic/compare/v5.8.5...v5.9.0) (2021-11-17)
+
+
+### Bug Fixes
+
+* **action-sheet:** safe area is now accounted for in MD mode ([#24176](https://github.com/ionic-team/ionic/issues/24176)) ([642255e](https://github.com/ionic-team/ionic/commit/642255e514fd67238d9bd8ea90781111687c6d03)), closes [#24175](https://github.com/ionic-team/ionic/issues/24175)
+* **input:** date type in ion-input now aligns correctly on iOS 15 ([#24217](https://github.com/ionic-team/ionic/issues/24217)) ([0566ec0](https://github.com/ionic-team/ionic/commit/0566ec0da3b8a66a1a1ebb1b235e7297ec483c79))
+* **vue:** canGoBack method now works correctly ([#24188](https://github.com/ionic-team/ionic/issues/24188)) ([7c43589](https://github.com/ionic-team/ionic/commit/7c43589b0a486f71ee2ae5a4cdcd73071fcd31b9)), closes [#24109](https://github.com/ionic-team/ionic/issues/24109)
+
+
+### Features
+
+* **slides:** add support for Swiper 7 ([#24190](https://github.com/ionic-team/ionic/issues/24190)) ([d0b6130](https://github.com/ionic-team/ionic/commit/d0b61307c6b7ff1589646c43f989260b59db1473))
+
+
+
 ## [5.8.5](https://github.com/ionic-team/ionic/compare/v5.8.4...v5.8.5) (2021-10-27)
 
 
diff --git a/angular/package-lock.json b/angular/package-lock.json
index b2f84e6082..8a7e44f77b 100644
--- a/angular/package-lock.json
+++ b/angular/package-lock.json
@@ -1,15 +1,15 @@
 {
   "name": "@ionic/angular",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@ionic/angular",
-      "version": "5.8.5",
+      "version": "5.9.0",
       "license": "MIT",
       "dependencies": {
-        "@ionic/core": "5.8.4",
+        "@ionic/core": "5.8.5",
         "tslib": "^1.9.3"
       },
       "devDependencies": {
@@ -204,9 +204,9 @@
       }
     },
     "node_modules/@ionic/core": {
-      "version": "5.8.4",
-      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.4.tgz",
-      "integrity": "sha512-ioaH7wXAtexcpk23III0KArjSXStkpPrpZ5BCNkyter3EbOmDVd8XIXRcT86zRG68rbGI7Pd9GrugxeaDyMk/g==",
+      "version": "5.8.5",
+      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.5.tgz",
+      "integrity": "sha512-KUT3kKcON606FBJBZcAZn2c62OfPhVR/LQO260FH3znUmpZbqD2/Zm1LOTCxluiG9H6UIe8TVo9n8BgsKxCygA==",
       "dependencies": {
         "@stencil/core": "^2.4.0",
         "ionicons": "^5.5.3",
@@ -5156,9 +5156,9 @@
       }
     },
     "@ionic/core": {
-      "version": "5.8.4",
-      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.4.tgz",
-      "integrity": "sha512-ioaH7wXAtexcpk23III0KArjSXStkpPrpZ5BCNkyter3EbOmDVd8XIXRcT86zRG68rbGI7Pd9GrugxeaDyMk/g==",
+      "version": "5.8.5",
+      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.5.tgz",
+      "integrity": "sha512-KUT3kKcON606FBJBZcAZn2c62OfPhVR/LQO260FH3znUmpZbqD2/Zm1LOTCxluiG9H6UIe8TVo9n8BgsKxCygA==",
       "requires": {
         "@stencil/core": "^2.4.0",
         "ionicons": "^5.5.3",
diff --git a/angular/package.json b/angular/package.json
index 0a7d514b7a..6a918422aa 100644
--- a/angular/package.json
+++ b/angular/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ionic/angular",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "description": "Angular specific wrappers for @ionic/core",
   "keywords": [
     "ionic",
@@ -42,7 +42,7 @@
     "validate": "npm i && npm run lint && npm run test && npm run build"
   },
   "dependencies": {
-    "@ionic/core": "5.8.5",
+    "@ionic/core": "5.9.0",
     "tslib": "^1.9.3"
   },
   "peerDependencies": {
diff --git a/core/package-lock.json b/core/package-lock.json
index f1166e9dbb..a7269441ee 100644
--- a/core/package-lock.json
+++ b/core/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@ionic/core",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@ionic/core",
-      "version": "5.8.5",
+      "version": "5.9.0",
       "license": "MIT",
       "dependencies": {
         "@stencil/core": "^2.4.0",
diff --git a/core/package.json b/core/package.json
index 4b313bc22d..d0bb193065 100644
--- a/core/package.json
+++ b/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ionic/core",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "description": "Base components for Ionic",
   "keywords": [
     "ionic",
diff --git a/docs/package.json b/docs/package.json
index cf96a91942..950d8da330 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ionic/docs",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "description": "Pre-packaged API documentation for the Ionic docs.",
   "main": "core.json",
   "types": "core.d.ts",
diff --git a/packages/angular-server/package-lock.json b/packages/angular-server/package-lock.json
index 8791ea8c88..ec24d2e04a 100644
--- a/packages/angular-server/package-lock.json
+++ b/packages/angular-server/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@ionic/angular-server",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@ionic/angular-server",
-      "version": "5.8.5",
+      "version": "5.9.0",
       "license": "MIT",
       "devDependencies": {
         "@angular/animations": "8.2.13",
@@ -16,7 +16,7 @@
         "@angular/core": "8.2.13",
         "@angular/platform-browser": "8.2.13",
         "@angular/platform-server": "8.2.13",
-        "@ionic/core": "5.8.4",
+        "@ionic/core": "5.8.5",
         "ng-packagr": "5.7.1",
         "tslint": "^5.12.1",
         "tslint-ionic-rules": "0.0.21",
@@ -137,9 +137,9 @@
       }
     },
     "node_modules/@ionic/core": {
-      "version": "5.8.4",
-      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.4.tgz",
-      "integrity": "sha512-ioaH7wXAtexcpk23III0KArjSXStkpPrpZ5BCNkyter3EbOmDVd8XIXRcT86zRG68rbGI7Pd9GrugxeaDyMk/g==",
+      "version": "5.8.5",
+      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.5.tgz",
+      "integrity": "sha512-KUT3kKcON606FBJBZcAZn2c62OfPhVR/LQO260FH3znUmpZbqD2/Zm1LOTCxluiG9H6UIe8TVo9n8BgsKxCygA==",
       "dev": true,
       "dependencies": {
         "@stencil/core": "^2.4.0",
@@ -5424,9 +5424,9 @@
       }
     },
     "@ionic/core": {
-      "version": "5.8.4",
-      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.4.tgz",
-      "integrity": "sha512-ioaH7wXAtexcpk23III0KArjSXStkpPrpZ5BCNkyter3EbOmDVd8XIXRcT86zRG68rbGI7Pd9GrugxeaDyMk/g==",
+      "version": "5.8.5",
+      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.5.tgz",
+      "integrity": "sha512-KUT3kKcON606FBJBZcAZn2c62OfPhVR/LQO260FH3znUmpZbqD2/Zm1LOTCxluiG9H6UIe8TVo9n8BgsKxCygA==",
       "dev": true,
       "requires": {
         "@stencil/core": "^2.4.0",
diff --git a/packages/angular-server/package.json b/packages/angular-server/package.json
index fa7a520f09..340f3c08b7 100644
--- a/packages/angular-server/package.json
+++ b/packages/angular-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ionic/angular-server",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "description": "Angular SSR Module for Ionic",
   "keywords": [
     "ionic",
@@ -49,7 +49,7 @@
     "@angular/core": "8.2.13",
     "@angular/platform-browser": "8.2.13",
     "@angular/platform-server": "8.2.13",
-    "@ionic/core": "5.8.5",
+    "@ionic/core": "5.9.0",
     "ng-packagr": "5.7.1",
     "tslint": "^5.12.1",
     "tslint-ionic-rules": "0.0.21",
diff --git a/packages/react-router/package.json b/packages/react-router/package.json
index bfacbc80db..5642721dd9 100644
--- a/packages/react-router/package.json
+++ b/packages/react-router/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ionic/react-router",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "description": "React Router wrapper for @ionic/react",
   "keywords": [
     "ionic",
@@ -47,7 +47,7 @@
     "react-router-dom": "^5.0.1"
   },
   "devDependencies": {
-    "@ionic/core": "5.8.5",
+    "@ionic/core": "5.9.0",
     "@ionic/react": "5.8.5",
     "@rollup/plugin-node-resolve": "^8.1.0",
     "@testing-library/jest-dom": "^5.11.6",
diff --git a/packages/react/package.json b/packages/react/package.json
index c59ac911ad..981d12e3c8 100644
--- a/packages/react/package.json
+++ b/packages/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ionic/react",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "description": "React specific wrapper for @ionic/core",
   "keywords": [
     "ionic",
@@ -40,7 +40,7 @@
     "css/"
   ],
   "dependencies": {
-    "@ionic/core": "5.8.5",
+    "@ionic/core": "5.9.0",
     "ionicons": "^5.1.2",
     "tslib": "*"
   },
diff --git a/packages/vue-router/package-lock.json b/packages/vue-router/package-lock.json
index 218bd7ad22..8633e68eb8 100644
--- a/packages/vue-router/package-lock.json
+++ b/packages/vue-router/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@ionic/vue-router",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@ionic/vue-router",
-      "version": "5.8.5",
+      "version": "5.9.0",
       "license": "MIT",
       "devDependencies": {
         "@ionic/vue": "5.4.1",
diff --git a/packages/vue-router/package.json b/packages/vue-router/package.json
index 162b13e824..758e6c68af 100644
--- a/packages/vue-router/package.json
+++ b/packages/vue-router/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ionic/vue-router",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "description": "Vue Router integration for @ionic/vue",
   "scripts": {
     "test.spec": "jest",
diff --git a/packages/vue/package-lock.json b/packages/vue/package-lock.json
index ae2cd41f96..ec4dd4c864 100644
--- a/packages/vue/package-lock.json
+++ b/packages/vue/package-lock.json
@@ -1,15 +1,15 @@
 {
   "name": "@ionic/vue",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@ionic/vue",
-      "version": "5.8.5",
+      "version": "5.9.0",
       "license": "MIT",
       "dependencies": {
-        "@ionic/core": "5.8.4",
+        "@ionic/core": "5.8.5",
         "ionicons": "^5.1.2"
       },
       "devDependencies": {
@@ -53,9 +53,9 @@
       }
     },
     "node_modules/@ionic/core": {
-      "version": "5.8.4",
-      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.4.tgz",
-      "integrity": "sha512-ioaH7wXAtexcpk23III0KArjSXStkpPrpZ5BCNkyter3EbOmDVd8XIXRcT86zRG68rbGI7Pd9GrugxeaDyMk/g==",
+      "version": "5.8.5",
+      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.5.tgz",
+      "integrity": "sha512-KUT3kKcON606FBJBZcAZn2c62OfPhVR/LQO260FH3znUmpZbqD2/Zm1LOTCxluiG9H6UIe8TVo9n8BgsKxCygA==",
       "dependencies": {
         "@stencil/core": "^2.4.0",
         "ionicons": "^5.5.3",
@@ -633,9 +633,9 @@
       }
     },
     "@ionic/core": {
-      "version": "5.8.4",
-      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.4.tgz",
-      "integrity": "sha512-ioaH7wXAtexcpk23III0KArjSXStkpPrpZ5BCNkyter3EbOmDVd8XIXRcT86zRG68rbGI7Pd9GrugxeaDyMk/g==",
+      "version": "5.8.5",
+      "resolved": "https://registry.npmjs.org/@ionic/core/-/core-5.8.5.tgz",
+      "integrity": "sha512-KUT3kKcON606FBJBZcAZn2c62OfPhVR/LQO260FH3znUmpZbqD2/Zm1LOTCxluiG9H6UIe8TVo9n8BgsKxCygA==",
       "requires": {
         "@stencil/core": "^2.4.0",
         "ionicons": "^5.5.3",
diff --git a/packages/vue/package.json b/packages/vue/package.json
index 63f39b2880..9367535bf9 100644
--- a/packages/vue/package.json
+++ b/packages/vue/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ionic/vue",
-  "version": "5.8.5",
+  "version": "5.9.0",
   "description": "Vue specific wrapper for @ionic/core",
   "scripts": {
     "lint": "echo add linter",
@@ -59,7 +59,7 @@
     "vue-router": "^4.0.0-rc.4"
   },
   "dependencies": {
-    "@ionic/core": "5.8.5",
+    "@ionic/core": "5.9.0",
     "ionicons": "^5.1.2"
   },
   "vetur": {

From 2d704276083e3957f52fa7b7aaa5132d2f88c899 Mon Sep 17 00:00:00 2001
From: Liam DeBeasi <liamdebeasi@users.noreply.github.com>
Date: Wed, 17 Nov 2021 09:47:24 -0500
Subject: [PATCH 4/5] build(): publish to prod but not dev builds (#24232)

---
 .scripts/common.js | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/.scripts/common.js b/.scripts/common.js
index e8ddfad4b4..036574f2d7 100644
--- a/.scripts/common.js
+++ b/.scripts/common.js
@@ -318,7 +318,7 @@ function copyPackageToDist(tasks, packages) {
   });
 }
 
-function publishPackages(tasks, packages, version, npmTag = 'latest') {
+function verifyPackages(tasks, packages, version, npmTag = 'latest') {
   // verify version
   packages.forEach(package => {
     if (package === 'core') {
@@ -338,6 +338,26 @@ function publishPackages(tasks, packages, version, npmTag = 'latest') {
   });
 }
 
+function publishPackages(tasks, packages, version, npmTag = 'latest') {
+  verifyPackages(tasks, packages, version, npmTag);
+
+  // Publish
+  packages.forEach(package => {
+    let projectRoot = projectPath(package);
+
+    if (package === 'packages/angular-server' || package === 'angular') {
+      projectRoot = path.join(projectRoot, 'dist')
+    }
+
+    tasks.push({
+      title: `${package}: publish to ${npmTag} tag`,
+      task: async () => {
+        await execa('npm', ['publish', '--tag', npmTag], { cwd: projectRoot });
+      }
+    });
+  });
+}
+
 function updateDependency(pkg, dependency, version) {
   if (pkg.dependencies && pkg.dependencies[dependency]) {
     pkg.dependencies[dependency] = version;
@@ -379,6 +399,7 @@ module.exports = {
   preparePackage,
   projectPath,
   publishPackages,
+  verifyPackages,
   readPkg,
   rootDir,
   updateDependency,

From 11425fbb35330e0e0f483d902d8cca56694d7ecf Mon Sep 17 00:00:00 2001
From: Liam DeBeasi <liamdebeasi@icloud.com>
Date: Wed, 17 Nov 2021 15:16:22 +0000
Subject: [PATCH 5/5] build(): ensure react router gets latest version of core

---
 .../actions/build-react-router/action.yml      | 18 +++++++++---------
 packages/react-router/package.json             |  1 -
 2 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/actions/build-react-router/action.yml b/.github/workflows/actions/build-react-router/action.yml
index 7fe4b6c8f6..062fda3a5c 100644
--- a/.github/workflows/actions/build-react-router/action.yml
+++ b/.github/workflows/actions/build-react-router/action.yml
@@ -14,20 +14,20 @@ runs:
       with:
         path: ./core/node_modules
         key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('./core/package-lock.json') }}-v1
-    - name: Install Dependencies
-      run: npm install --legacy-peer-deps
-      shell: bash
-      working-directory: ./packages/react-router
-    - uses: ./.github/workflows/actions/download-archive
-      with:
-        name: ionic-react
-        path: ./packages/react
-        filename: ReactBuild.zip
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
         path: ./core
         filename: CoreBuild.zip
+    - uses: ./.github/workflows/actions/download-archive
+      with:
+        name: ionic-react
+        path: ./packages/react
+        filename: ReactBuild.zip
+    - name: Install Dependencies
+      run: npm install --legacy-peer-deps
+      shell: bash
+      working-directory: ./packages/react-router
     - name: Sync
       run: npm run sync
       shell: bash
diff --git a/packages/react-router/package.json b/packages/react-router/package.json
index 5642721dd9..19e7f4a5eb 100644
--- a/packages/react-router/package.json
+++ b/packages/react-router/package.json
@@ -47,7 +47,6 @@
     "react-router-dom": "^5.0.1"
   },
   "devDependencies": {
-    "@ionic/core": "5.9.0",
     "@ionic/react": "5.8.5",
     "@rollup/plugin-node-resolve": "^8.1.0",
     "@testing-library/jest-dom": "^5.11.6",