Build and Install POS from scratch

1. Prepare

  • Install nodejs on your computer

  • POS unbuilt package

2. Build

You can use either Step by step or Automated script guide to build the Magestore POS

Step by step

  1. Extract the POS unbuild package on your computer, you will see the client and server folder


  2. Change to the client directory

    1 cd client


  3. Depending on the package you was purchased you will see how many client app under this directory
    In this case, there are 3 apps in the package


  4. Go to each directory and run build for the apps
    For example the pos app

    1 cd pos && npm install && npm run build && cd ../

    The output will be stored in the build directory. In this case is pos/build

    Then do the same way with other apps (if have)
    clickandcollect app

    1 cd clickandcollect && npm install && npm run build && cd ../

    mobile_pos app

    1 cd mobile_pos && npm install && npm run build && cd ../
  5. Copy all the built apps to Webpos module
    The mapping for a copy client apps will look like below
    client/<app_name>/build => server/app/code/Magestore/Webpos/build/apps/<app_name>

    1 2 3 4 5 6 cd ../ rm -rf server/app/code/Magestore/Webpos/build/apps mkdir -p server/app/code/Magestore/Webpos/build/apps cp client/pos/build server/app/code/Magestore/Webpos/build/apps/pos cp client/clickandcollect/build server/app/code/Magestore/Webpos/build/apps/clickandcollect cp client/mobile_pos/build server/app/code/Magestore/Webpos/build/apps/mobile_pos


Automated script

Copy below content and save the file named and place it in the same directory with the server and client directory


1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 #!/usr/bin/env bash set -euo pipefail rm -rf server/app/code/Magestore/Webpos/build/apps/ mkdir -p server/app/code/Magestore/Webpos/build/apps/ cd client for app_name in client/*; do echo "Building app '$app_name'" cd "$app_name" \ && npm install \ && npm run build \ && cp -R build "../../app/code/Magestore/build/apps/$app_name" \ && cd ../ done echo "Done"

Then run the below command to start the build automation

1 bash

3. Install the POS

After completing step 2, you will have the POS built package, you will need to create a compressed file and install it on your server

1. Create a compressed file

1 2 cd server tar -caf magestore-pos.tar.gz app/code/Magestore pub

2. Install Magestore POS on your server

Use one of the following guides to install the POS