At the moment Amasty PWA add-ons are installed via yarn. The add-ons could be downloaded from the Products tab in the customer account after the purchase.
Before starting the installation process, make sure that the Magento instance meets the following requirements:
Magento on version 2.3.6 and higher. This requirement is associated with the native Magento GraphQL support, which was implemented since 2.3 generation.
Corresponding Amasty extension installed. The add-ons can’t work on a vanilla Magento. Without the extension, the add-on could not retrieve the required info to operate properly.
Corresponding GraphQL system package installed. GraphQL endpoints are required for the communication of the storefront with the Magento backend. The GraphQL package can be installed with command
composer require amasty/[graphql-package-name]. The name of the GraphQL package is provided upon installation of the main extension:
It can also be found in the suggest section in the composer.json file of the main extension:
Venia theme installed. We guarantee that Amasty add-ons will work inside the Venia Theme environment. What concerns other PWA themes built on React, improvements might be required here. An exception will be ScandiPWA - it's also built on React but with a different architecture and tools, so we can't guarantee that our add-ons will be compatible with it.
Tools installed. The required tools need to be installed: NodeJS >=10.14.1 LTS; Yarn >=1.13.0; Python 2.7 and build tools, see the Installation instructions on node-gyp for your platform.
PWA Studio Installation
New project creation
To create a new project, please run the following command:
yarn create @magento/pwa. After that, an interactive installation process will be started. You'll have to enter the following information:
- the directory name;
- project name;
- author name;
- Magento backend URL (you don't have one, you'll be offered to install a new Magento instance and token).
To go to the project’s directory, run the following command:
$ cd myproject/
Project domain creation
You need to create a unique, safe, configurable domain for your new project. To do that, please run the following command:
yarn run buildpack create-custom-origin
Please, note that, for the successful command execution, you need to run the command by a user with the administrator's permissions. For this step, the admin password is required. This is why you can be asked to enter the admin password in the command line.
To run the project in the developer mode, please execute
yarn watch. The project will be started and will be available via address, given to you in the console window. For example, see the screenshot below:
PWA Module Installation
To install the PWA modules to your instance, you need to follow the next steps:
Step 1. Proceed to the required folder using the following command:
Step 2. Create a new folder with
Step 3. Copy module folder and paste it to
Step 4. Run one of the commands below depending on the mode:
yarn add link:src/@amasty/%module_name% - for development mode;
yarn add file:src/@amasty/%module_name%B - for production mode.
Both commands should be run from the directory (your_project folder).
Step 5. If the extension has the Ovverrides folder, copy folder overrides from
src/ and install VeniaUiOverrideResolver for PWA Studio with the command:
yarn add @fooman/venia-ui-override-resolver
Step 6. Restart your project using the
yarn watch command.
Please, note that adding a new file requires restarting the watch process for the file to get recognised. Replacing a component can be dangerous. It is not a compound change, so if two extensions are intended to replace the same file, it can lead to errors.