How to install a ScandiPWA Theme as ZIP

<aside> ℹ️ This type of installation enables you to modify package source, but prevents further upgrades.

</aside>

  1. Create (or make sure it exists) packages folder inside of your ScandiPWA root

  2. Download the package from My Account / My Downloadable Products section of the marketplace

  3. Unzip package into newly created folder

  4. Make sure the package.json file is found in packages/<UNZIPPED FOLDER>, for example, packages/my-theme/package.json

  5. Copy the name field from themes package.json file

  6. Edit the ScandiPWA root package.json to include the package name as dependency, in versions place specify relative path to the theme’s root prefixed with file:

    <aside> 🔎 e.g.: file:./packages/my-theme. In the end dependencies field in the package.json must include similar entry: "@scandiweb/my-theme": "file:./packages/my-theme"

    </aside>

  7. Make sure the ScandiPWA root package.json includes "postinstall": "scandipwa-scripts link", and "postupdate": "scandipwa-scripts link" entries in the scripts field

  8. Change the scandipwa.parentTheme field in ScandiPWA root package.json to be equal to theme’s package name, for example, @scandiweb/my-theme

  9. Install dependencies, use one of the commands:

    1. You can use Yarn: yarn
    2. Or use NPM: npm i

  10. Run your theme as usual, it should start and have a new desired appearance of your new theme

<aside> ➡️ To install a ScandiPWA theme via NPM, follow this tutorial: How to install a theme from Marketplace?

</aside>