Install the Commerce metapackage

This metapackage is only required for PWA projects that target Adobe Commerce as the backend.

Prerequisite

GraphQL metapackage in all projects using PWA Studio 12.1.0 and higher.

Installation as a git-based composer package

To setup and develop your PWA extension modules locally, use the following instructions.

Clone the magento2-pwa-commerce repository into your Magento Commerce vendor directory name:

git clone git@github.com:magento/magento2-pwa-commerce.git ext/<vendor-directory-name>/magento2-pwa-commerce

Update the magento2/composer.json settings to create a better development workflow for your extension modules:
- Update the minimum-stability for packages to dev. This allows for the installation of development modules:
```
composer config minimum-stability dev
```
- To work with stable packages, ensure that the prefer-stable property is true. This property should already be included in the composer.json file, right above the minimum-stability setting.
- Configure composer to find new extension modules. The following command configures composer to treat any extension code inside the ext directory as a package and creates a symlink to the vendor directory:
```
composer config repositories.ext path "./ext/*/*/*"
```
Install the pwa-commerce metapackage:
```
composer require magento/pwa-commerce
```

At this point, you should see symlinks for all the pwa-commerce modules inside the vendor directory. These symlinks allow you to:

Run a Magento installation with additional modules.
Develop locally using the standard git workflow.

Make sure that all of the required modules are enabled when you run bin/magento module:status. See, Enable or disable a component in the PHP Developer Guide for instructions. The following modules should now be enabled:

Magento_BannerGraphQlAux
Magento_EavGraphQlAux
Magento_CatalogGraphQlAux
Magento_SalesGraphQlAux
Magento_WeeeGraphQlAux
Magento_ContactGraphQlPwa
Magento_NewsletterGraphQlPwa
Magento_PageBuilderPwa
Magento_ReCaptchaGraphQlPwa
Magento_ReCaptchaPwa
Magento_UrlRewriteGraphQlPwa

Setting up the Git workflow

To improve the developer experience even further, you can add these configurations as well:

Exclude all the ext directories in the project's .git configuration:
```
echo ext >> ./.git/info/exclude
```

Skip your project's root directory composer.\* files to avoid committing them by mistake:

git update-index --skip-worktree composer.json && git update-index --skip-worktree composer.lock

NOTE: You can reverse this operation anytime as needed:

git update-index --no-skip-worktree composer.json && git update-index --no-skip-worktree composer.lock

Cloud deployment extension installation

Add https://repo.magento.com as a composer repository by adding the following to the composer.json file of your cloud instances.
```
"repositories": {
    "repo": {
        "type": "composer",
        "url": "https://repo.magento.com"
    }
},
```
Require in magento/magento2-pwa-commerce extension by adding the following to the composer.json file of your cloud instances.
```
"require": {
    "magento/magento2-pwa-commerce": "0.0.1"
},
```
Ensure your auth.json file has valid credentials for repo.magento.com.
Run composer update to update your composer.lock file.
Push the changes and deploy your cloud instance.