ScandiPWA
Create Magento AppCreate ScandiPWA AppUser ManualGitHub
  • Why Scandi
  • 🚀Quick-start Guide
  • 🗺️Roadmap
  • Introduction to the Stack
    • CMA, CSA, and ScandiPWA
    • Challenges
  • Setting up Scandi
    • Storefront Mode Setup
      • Proxying requests to server
    • Magento Mode Setup
    • Existing Magento 2 setup
    • Magento Commerce Cloud setup
    • Updating to new releases
      • Storefront mode upgrade
      • Magento mode upgrade
      • CMA upgrade
      • CSA upgrade
      • Custom ScandiPWA composer dependency update
      • Local ScandiPWA Composer Package Setup
    • Docker Setup [deprecated]
      • Legacy Docker setup
      • Migrating to CMA & CSA
  • Developing with Scandi
    • Override Mechanism
      • Overriding JavaScript
        • Overriding classes
        • Overriding non-classes
      • Overriding Styles
      • Overriding the HTML / PHP
      • Parent Themes
    • Extensions
      • Creating an extension
      • Installing an extension
      • Migrating from 3.x to 4.x
      • Publishing an extension
      • Extension Terminology
    • Working With Magento
      • Magento troubleshooting
      • Working with Magento modules
      • Working with GraphQL
      • GraphQL Security
      • Working with "granular cache"
    • Developer Tools
      • Debugging in VSCode
      • ScandiPWA CLI
      • Configuring ESLint
      • CSA Commands
    • Deploying Your App
      • Build & Deploy Android app
      • Build & Deploy iOS app
  • Structure
    • Directory Structure
    • Building Blocks
      • Components
        • Styling Components
      • Routes
      • Redux Stores
      • GraphQL Queries
      • Global Styles
      • The Util Directory
      • Type Checking
    • Application assets
    • Code Style
      • JavaScript Code Style
      • SCSS Code Style
  • Tutorials
    • Customizing Your Theme
      • Styling
        • Customizing the Global Styles
        • Adding a New Font
        • Overriding a Components Styles
        • Extending a Component's Styles
      • Customizing JavaScript
        • Customizing the Footer Copyright
        • Adding a New Page
        • Adding a Section in My Account
        • Adding a Tab on the Product Page
        • Creating a New Redux Store
    • Payment Method Integration
      • Setting Up for Development
      • Redirecting to the Payment Provider
      • Handling the Customer's Return
    • Creating a Custom Widget
      • Scandi CMS System Overview
      • Creating a Magento Widget
      • Implementing the Rendering
    • Video Tutorials
      • #1 Setting up and talking theory
      • #2 Templating in React
      • #3 Overriding a file
      • #4 Styling the application
      • #5 Patterns of ScandiPWA
    • Dark Mode Extension
    • Deploying Native Apps
    • Product 3D Model Extension
      • Part 1: Magento 3D Model Uploads
      • Part 2: GraphQL API
      • Part 3: Scandi Frontend
    • Social Share, Full Extension Development
      • STEP-1 and 2 Creating Magento 2 Module
      • STEP-3 Backend Configurations Settings
      • STEP-4 Simple GraphQl and Resolver
      • STEP-5 Creating Extension, Base Redux Store
      • STEP-6 Extension plugins
      • STEP-7 GraphQL types, Helpers
      • STEP-8 Query Field and FieldList
      • STEP-9 render Plugins and MSTP Plugin, Component creation
      • STEP-10 SocialShare Component Development
      • STEP-11 SocialShare for CategoryPage
      • TASK-1 Changing LinkedIn to Twitter
      • STEP-12 Comments for Admin Users
      • STEP-13 Final, bugfixes
    • Accessing Magento 2 Controllers
      • STEP-1 Creating Magento 2 Module
      • STEP-2 - Create Magento 2 Frontend Route and Basic Controller
      • STEP-3 Accessing Magento 2 Controller, Bypassing ScandiPWA frontend
      • STEP-4 Creating ScandiPWA Extension with additional dependencies
      • STEP-5 Creating Plugin and Axios request
  • About
    • Support
    • Release notes
    • Technical Information
    • Data Analytics
    • Contributing
      • Installation from Fork
      • Repository structure
      • Code contribution process
      • Submitting an Issue
      • Publishing ScandiPWA
Powered by GitBook
On this page
  • 1. Create a new Create Magento App
  • Install dependencies
  • Quick Start
  • Creating a Magento App
  • Output
  • 2. Create a new Create Scandipwa App
  • 3. Link Magento App with ScandiPWA App
  • 4. Run ScandiPWA App in Magento mode
  • 5. Change Magento theme to ScandiPWA
  • What's next?

Was this helpful?

  1. Setting up Scandi

Magento Mode Setup

Build Scandi as a Magento theme

PreviousProxying requests to serverNextExisting Magento 2 setup

Last updated 4 years ago

Was this helpful?

This guide requires 5 steps to be completed in sequence:

1. Create a new Create Magento App

Install dependencies

Before setting up, make sure you have installed the libraries required to build the PHP. The list of these libraries can be found here: for and .

Also, make sure to install Docker and PHPBrew in your system.

Quick Start

# make sure dependencies are installed !!!
npx create-magento-app my-app
cd my-app
npm start

This command will start Docker services, start PHP and open your favorite browser with Magento 2 store.

Creating a Magento App

Make sure your Node version is up to date!

To create a new app, you may choose one of the following methods:

npx create-magento-app my-app
npm init magento-app my-app
yarn create magento-app my-app

Output

2. Create a new Create Scandipwa App

The ScandiPWA App creation very similar to Storefront mode, however, the Magento 2 server configuration is not required as we will install our ScandiPWA as composer dependency for our newly created Magento 2 server, later in this guide.

3. Link Magento App with ScandiPWA App

The Create Magento App (CMA) comes with a built-in mechanism for ScandiPWA theme linking. In order to link a ScandiPWA theme with CMA project, execute the following command from CMA project root:

npm run link -- ./path/to/your/scandipwa-app
yarn run link ./path/to/your/scandipwa-app

4. Run ScandiPWA App in Magento mode

Run the command below from your ScandiPWA App directory:

BUILD_MODE=magento npm run start
set BUILD_MODE=magento && npm run start & set BUILD_MODE=

This command will now watch the files and put their compiled versions into the magento/Magento_Theme folder.

5. Change Magento theme to ScandiPWA

Go to your Magento Admin panel (by default it can be accessed on /admin), Content > Configuration, choose a website that you want to apply theme on, click Edit and select your theme, click Save!

Open your store URL and the ScandiPWA theme should be online.

What's next?

Learn what features and why we added on-top-of React + Redux stack:

Create Magento App choose an available port for Magento 2 so it can vary. By default, it will use port 80 so the URL for the store will be .

You’ll need to have Node >= 12 on your local development machine (but it’s not required on the server). You can use (macOS, Linux) or to switch Node versions between different projects.

Running any of these commands will create a directory called my-app inside the current folder. Inside that directory, it will generate the initial project structure and install the transitive dependencies. Learn more in .

In case of issues - please refer to

This command will link your ScandiPWA theme from your selected path as a symbolic link and will .

http://localhost:80/
n
nvm-windows
the folder structure guide
Create Magento App FAQ.
Storefront Mode Setup
disable the "Full Page" cache
Introduction to the Stack
Linux
macOS
Create a new Create Magento App
Create a new Create Scandipwa App
Link Magento App with ScandiPWA App
Run ScandiPWA App in Magento mode
Change Magento theme to ScandiPWA