From 8b1f15b43668ea00be4f669c3fbfef68f8f88c45 Mon Sep 17 00:00:00 2001 From: Carolina Menezes <60782333+carolinamenezes@users.noreply.github.com> Date: Fri, 8 Apr 2022 12:04:27 -0300 Subject: [PATCH] Add doc Troubleshooting problems in Faststore (#1219) * Add doc Troubleshooting problems in Faststore * Update docs/docs/how-to-guides/local-development/troubleshooting-problems-in-faststore.md --- .../troubleshooting-problems-in-faststore.md | 40 +++++++++++++++++++ ...etting up your development environment.mdx | 2 +- docs/sidebars.js | 12 ++++++ docs/static/data/doc-update.json | 13 ++++++ 4 files changed, 66 insertions(+), 1 deletion(-) create mode 100644 docs/docs/how-to-guides/local-development/troubleshooting-problems-in-faststore.md diff --git a/docs/docs/how-to-guides/local-development/troubleshooting-problems-in-faststore.md b/docs/docs/how-to-guides/local-development/troubleshooting-problems-in-faststore.md new file mode 100644 index 0000000000..1502727b2f --- /dev/null +++ b/docs/docs/how-to-guides/local-development/troubleshooting-problems-in-faststore.md @@ -0,0 +1,40 @@ +--- +tags: + - performance + - troubleshooting +--- + +# Troubleshooting problems in FastStore + +While developing with FastStore, you may run into errors. Some of these may require fixes in FastStore libraries, while others may require adjusting your code. + +Hence, before proceeding with any advanced troubleshooting, we recommend that you first check if you are facing a bug from FastStore/WebOps or a mistake on your side. + +## Step by step + +1. Open the terminal and clone the [`base.store`](https://github.com/vtex-sites/base.store) repository. + ``` + npx degit vtex-sites/base.store + ``` +2. Change to the cloned repository and run `yarn`. + ``` + cd base.store && yarn + ``` +3. Open the `store.config.js` file and update the value of the `storeId` field with the account name of your store. + ```diff + module.exports = { + platform: 'vtex', + + api: { + + storeId: {account} + environment: 'vtexcommercestable' + } + } + ``` +4. Start a local server. + ``` + yarn develop + ``` +5. Access [http://localhost:8000/](http://localhost:8000/) and test the features you are having trouble with. + +If the problem persists with the `base.store` starter, we recommend [opening an issue](https://github.com/vtex/faststore/issues/new/choose) and reporting the problem. However, if the error only occurs in your own project, please refer to recommended resources (*Comming Soon*) to dive deeper into your code and try to find the origin of the error. \ No newline at end of file diff --git a/docs/docs/tutorials/gatsby/02 - Setting up your development environment.mdx b/docs/docs/tutorials/gatsby/02 - Setting up your development environment.mdx index b47e893117..7a9c6c3675 100644 --- a/docs/docs/tutorials/gatsby/02 - Setting up your development environment.mdx +++ b/docs/docs/tutorials/gatsby/02 - Setting up your development environment.mdx @@ -26,7 +26,7 @@ To complete this tutorial, you will need to have the following tools installed o Node.js - an open-source runtime environment that executes JavaScript code directly in a computer process instead of in a browser. -To run your FastStore project, you must have Node.js version 12.13 or later installed on your computer. +To run your FastStore project, you must have Node.js version 14.19 or later installed on your computer.