Windows Quickstart Integration Troubleshooting

:sparkles::sparkles:Hi everyone!


We know that some of our users use Windows computers, so we decided it would be a good idea to release an official troubleshooting guide for our Quickstart guides on these machines.

Taking the example of our Quickstart Integration recipe, follow each of the steps until you get to step 4. Instead of copy-pasting the given command in your command line prompt:

Download the project from our GitHub library following these steps:

  1. Download the Quickstart code from this GitHub repo.
  2. Navigate to the directory where you downloaded the code
  3. Install the dependencies with npm install
  4. Run the development environment with npm run start

Following these steps, you may run into the following error messages:
  1. Kill-port is not recognized: 'kill-port' is not recognized as an internal or external command, operable program or batch file.

If you run into this error message, this means that the kill-port command isn’t available on your machine. To correct this, simply install the kill-port ability with the following command and you should be good to go: npm install --save kill-port. Learn more in this community post.

  1. Nodemon is not recognized: 'nodemon' is not recognized as an internal or external command, operable program or batch file.

If you run into this error message, this means that, like the kill-port command, the nodemon command hasn’t been installed on your machine yet. You can correct this by running the following command, which should install nodemon globally on your machine: npm install -g nodemon.

  1. If you see an error message along the lines of:

    Node Sass does not yet support your current environment: Windows 64-bit with Unsupported runtime (88)

    you may just need to update your node version by first installing NVM, then run nvm install 10.16.3 to install this version of Node. Lastly, run nvm use 10.16.3 before running the npx command. Learn more in this community post.

After resolving these errors, run the same command `npm run start` to start your server. Paste the outputted URL in the URL box from step 4 here:

I hope this helps! Feel free to let us know if you run into any other errors when installing.

-Helen

1 Like