troubleshooting

.nvmrc

@@ -0,0 +1 @@
+v16.13.0

README.md

@@ -1,13 +1,13 @@
 [![RealWorld Frontend](https://img.shields.io/badge/realworld-frontend-%23783578.svg)](http://realworld.io)
 [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
 
-----
+---
+
 ##New Maintainers wanted##
 Anyone up for the challenge of maintaining this repo?
 Reach out on twitter @vilsbole
-----
-
 
+---
 
 # ![RealWorld Example App](./static/rwv-logo.png)
 
@@ -38,7 +38,7 @@ Before contributing please read the following:
 
 The stack is built using [vue-cli webpack](https://github.com/vuejs-templates/webpack) so to get started all you have to do is:
 
-``` bash
+```bash
 # install dependencies
 > yarn install
 # serve with hot reload at localhost:8080
@@ -47,7 +47,7 @@ The stack is built using [vue-cli webpack](https://github.com/vuejs-templates/we
 
 Other commands available are:
 
-``` bash
+```bash
 # build for production with minification
 yarn run build
 
@@ -70,22 +70,56 @@ These can be changed when the contributors reach a consensus.
 <p><details>
   <summary><b>Where can I find the service worker file?</b></summary>
 
-  The service worker file is generated automatically. The implementation can be found under [`src/registerServiceWorker.js`](https://github.com/gothinkster/vue-realworld-example-app/blob/eeaeb34fa440d00cd400545301ea203bd2a59284/src/registerServiceWorker.js). You can find the dependencies implementation in this repo: [yyx990803/register-service-worker](https://github.com/yyx990803/register-service-worker#readme).
+The service worker file is generated automatically. The implementation can be found under [`src/registerServiceWorker.js`](https://github.com/gothinkster/vue-realworld-example-app/blob/eeaeb34fa440d00cd400545301ea203bd2a59284/src/registerServiceWorker.js). You can find the dependencies implementation in this repo: [yyx990803/register-service-worker](https://github.com/yyx990803/register-service-worker#readme).
+
+Also, Google provided a good documentation on how to register a service worker: https://developers.google.com/web/fundamentals/primers/service-workers/registration
 
-  Also, Google provided a good documentation on how to register a service worker: https://developers.google.com/web/fundamentals/primers/service-workers/registration
 </details></p>
 
 <p><details>
   <summary><b>Vue.js Function API / Migration to Vue.js 3</b></summary>
 
-  Related resources:
+Related resources:
 
-  - [Vue.js Function API RFC](https://github.com/vuejs/rfcs/blob/function-apis/active-rfcs/0000-function-api.md)
-  - [`vue-function-api` plugin](https://github.com/vuejs/vue-function-api)
+- [Vue.js Function API RFC](https://github.com/vuejs/rfcs/blob/function-apis/active-rfcs/0000-function-api.md)
+- [`vue-function-api` plugin](https://github.com/vuejs/vue-function-api)
+
+Vue.js 3 will likely introduce breaking changes on how Vue.js applications will look like. For example, the Vue.js Function API might be introduced. This would cause a lot of our components to change in the overall structure. The changes would be minimal though. With the `vue-function-api` plugin, these changes could be applied already. The problem is that multiple integrations are not working with the plugin. There are intentions to make this work, but for the time being, we should rather focus on different areas. If you still want to be experimental with it, we are happy to get a Pull Request with some experimental feature implementations.
 
-  Vue.js 3 will likely introduce breaking changes on how Vue.js applications will look like. For example, the Vue.js Function API might be introduced. This would cause a lot of our components to change in the overall structure. The changes would be minimal though. With the `vue-function-api` plugin, these changes could be applied already. The problem is that multiple integrations are not working with the plugin. There are intentions to make this work, but for the time being, we should rather focus on different areas. If you still want to be experimental with it, we are happy to get a Pull Request with some experimental feature implementations.
 </details></p>
 
+## Troubleshooting
+
+- Error ERR_OSSL_EVP_UNSUPPORTED
+  If you get this error you shoul try to downgrade your node version to 16.13.0 using nvm like
+
+```
+> nvm install 16.13.0
+> nvm use 16.13.0
+```
+
+- Make sure you node-gyp installed globally
+```
+npm install -g node-gyp
+```
+
+- Make sure you have python installed on your machine
+MAC: 
+```
+brew install python
+export PYTHON=$(which python3)
+source ~/.zshrc # or ~/.bashrc depending on your shell
+```
+Windows: https://docs.python.org/3/install/windows.html
+Linux:
+```
+sudo apt update
+sudo apt install python3
+nano ~/.bashrc
+export PYTHON=$(which python3)
+source ~/.bashrc
+```
+
 ## Connect
 
-Join us on [Discord](https://discord.gg/NE2jNmg)
+Join us on [Discord](https://discord.gg/NE2jNmg)

package.json

@@ -25,7 +25,7 @@
     "babel-jest": "^24.9.0",
     "cross-env": "^6.0.3",
     "lint-staged": "^8.2.1",
-    "node-sass": "^4.12.0",
+    "node-sass": "^9.0.0",
     "nyc": "^14.1.1",
     "sass-loader": "^7.1.0",
     "vue-template-compiler": "^2.6.10"
@@ -50,5 +50,8 @@
     "serve": "cross-env BABEL_ENV=dev vue-cli-service serve",
     "test": "cross-env BABEL_ENV=test jest --coverage"
   },
-  "version": "0.1.0"
+  "version": "0.1.0",
+  "optionalDependencies": {
+    "fsevents": "^2.3.3"
+  }
 }