We are about to meet on and I hope you are looking forward to it as much as I do 😃
These are preparation instructions that will help you out with preparation for the workshop. Please don’t delay this to the last minute, because if any problems occur, we’ll have more time to iron them out. If there’s anything that does not work, please contact me and I’m sure we’ll be able to solve it all.
Open your terminal or the command line and type these commands:
git clone https://github.com/filiphric/.git
If you have ever installed a project from GitHub, this should be easy. If not, I’m sure you’ll manage. But if any problems occur, check out the troubleshooting section of this article.
Once you cloned the repository and used
npm install to install the app, you should be able to run
npm start command. It’s best if you use a text editor for this. I will be using VS Code for the workshop, which you can download here.
Open the workshop repository folder and in the top bar click on "Terminal" and choose "New Terminal".
💡 TIP: You can drag and drop your folder into VS Code to open it
If you have gone through the initial steps (clone, install), you should be able to run the app with
npm start command. Make sure you are opening the terminal in the workshop folder (you can check that by typing "pwd" into your command line). You should see the following message and be able to see the application in your browser on url http://localhost:3000
You should see a running application that looks something like this:
Open a new terminal window in your editor and open Cypress using one of these commands:
If at least one of them works, great 👍 You should see a window like this:
If one or more checks don’t work, please reach out to me. We can make a call and solve it. It is necessary to solve all the problems before the workshop, otherwise it might be hard to get back on track. Here are couple of tips for most common issues:
git clonecommand does not work
If you see a message like this:
there’s a good chance you don’t have git installed. Installation instructions are here. If everything fails, there is an alternative way. Visit the repository site, click the arrow next to the green "code" button and pick the option "download zip". Unzip the project, open it in VS Code and continue with the
npm install step
npm installcommand does not work
You see the error:
In this case, it is possible you don’t have node.js installed. Please go to https://nodejs.org and install node.js according to the installation instructions. There’s a good chance you’ll need to restart VS Code after the installation
npm startthrows an error
There are two possible errors here:
Error: Cannot find module 'worker_threads'then it is possible you have an older version of Node.js installed. Try checking that by typing the
node -vcommand into your terminal. If it returns version older than v14, please go to https://nodejs.org and install latest version of Node.js
'vite' is not recognized as an internal or external commandit may be that the installation didn’t go properly for Trello app. Use your terminal to go to
trelloappfolder and trigger installation from that folder by using following commands:
npx cypress openthrows an error
You see something like:
Command timed out after 30000 milliseconds - in this case, try repeating the command or turn off your VPN (if you have one). Cypress does a verification check when opened for the first time. If this takes longer than 30 seconds it will time out.
You can also try to run the command like this:
CYPRESS_VERIFY_TIMEOUT=60000 npx cypress open and increase the timeout
If for any reason something is not working, feel free to contact me via email, or DM me through LinkedIn, Twitter or Discord
This application is a project to help drive my workshops. It is a simplified real-world app, through which you can explore different testing problems. I usually add this project as a submodule in my workshops, but you can take a look into it on GitHub. Trello app is written in Vue 3, TypeScript and uses a json-server as a backend.
From time to time I send some useful tips to your inbox and let you know about upcoming events. Sign up if you want to stay in loop.