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