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.
Terminal window
```
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:
Terminal window
```
composer require adobe-commerce/storefront-compatibility:4.7.6
```
For Adobe Commerce 2.4.8, run:
Terminal window
```
composer require adobe-commerce/storefront-compatibility:4.8.4
```
To check the latest version of the Storefront Compatibility Package, go to the changelog.

Update package dependencies.

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
Terminal window
```
git add -A
git commit -m "Add module"
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:
Terminal window
```
composer require adobe-commerce/storefront-compatibility:4.7.6
```
For Adobe Commerce 2.4.8, run:
Terminal window
```
composer require adobe-commerce/storefront-compatibility:4.8.4
```
To check the latest version of the Storefront Compatibility Package, go to the changelog.
Upgrade Adobe Commerce:
Terminal window
```
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:
Terminal window
```
composer update adobe-commerce/storefront-compatibility
```
Run the following commands to upgrade Adobe Commerce and clear the cache.
Terminal window
```
bin/magento setup:upgrade && bin/magento cache:clean
```