Storefront Compatibility Package Installation

The Storefront Compatibility Package contains changes to the Adobe Commerce codebase that enable drop-in component functionality. On Adobe Commerce as a Cloud Service, it is installed and updated automatically.

PaaS only

Installation

Cloud infrastructure
On premises

Use this method to install the Storefront Compatibility Package using the Cloud infrastructure.

On your local workstation, change to the project directory for your Adobe Commerce on cloud infrastructure project.
Check out the environment branch to update using the Adobe Commerce Cloud CLI.
```
1
magento-cloud environment:checkout <environment-id>
```
Add the Storefront Compatibility module.

Use the appropriate package version based on your Adobe Commerce version:

For Adobe Commerce 2.4.7, run:
```
1
composer require adobe-commerce/storefront-compatibility:4.7.10
```
For Adobe Commerce 2.4.8, run:
```
1
composer require adobe-commerce/storefront-compatibility:4.8.7
```
To check the latest version of the Storefront Compatibility Package, go to the changelog.

Update package dependencies.

1
composer update "adobe-commerce/storefront-compatibility"

Commit and push code changes for the composer.json and composer.lock files.
Add, commit, and push the code changes for the composer.json and composer.lock files to the cloud environment
```
1
git add -A
2
git commit -m "Add module"
3
git push origin <branch-name>
```
Pushing the updates to the cloud environment initiates the Commerce cloud deployment process to apply the changes. Check the deployment status from the deploy log.

Use this method to install the Storefront Compatibility Package for an on-premises instance.

Use Composer to add the package module to your project:

Use the appropriate package version based on your Adobe Commerce version:

For Adobe Commerce 2.4.7, run:
```
1
composer require adobe-commerce/storefront-compatibility:4.7.10
```
For Adobe Commerce 2.4.8, run:
```
1
composer require adobe-commerce/storefront-compatibility:4.8.7
```
To check the latest version of the Storefront Compatibility Package, go to the changelog.
Upgrade Adobe Commerce:
```
1
bin/magento setup:upgrade
```

Update the package

Use the following procedure to update patch versions of the Storefront Compatibility Package.

Run the following command to update the package:

1
composer update adobe-commerce/storefront-compatibility

Run the following commands to upgrade Adobe Commerce and clear the cache.
```
1
bin/magento setup:upgrade && bin/magento cache:clean
```