Part 3: Getting Accustomed to the Code
To get a glimpse of the actual code that runs Empirica, open Visual Studio Code to the
You can either do this manually, by going to
File > Open Folderand selecting the
deliberation-empiricafolder, or by typing in your terminal
code .within the
The template experiment includes three subdirectories:
.empiricastores data and config files that we need to run the experiment.
clientis where the code that runs on your experiment participant's browser lives.
serveris where all the code that runs on the server lives.
Collapsed File Tree
serverdirectories are each structured as a node package, and contain some boilerplate code that we can ignore:
node_modules/is a folder containing dependencies, and is managed for us (we never need to touch it)
dist/is a folder for the compiled version of our code, which gets built automatically
package-lock.jsoncontain references to other packages that our experiment depends on
server/jsconfig.jsare all configuration files we can leave as they are
In this tutorial, we will make changes in the following places:
client/src/is a folder containing the views the participant sees, built up as React components.
server/src/callbacks.jsis a file for server-side code that is called when specific actions happen in the game.
.empirica/local/tajriba.jsonis where our experiment data is stored. It is often helpful to delete this file when you restart the server, to start with a clean slate.
Have a quick browse through the files in
client/src/examplesto see how the jelly bean and minesweeper examples are implemented.