create-empirica-app requires Node.js >= 8. If you don't already have Node.js 8+ setup, we recommend you use the official installer: https://nodejs.org/en/download/.
You will also need Meteor, for which you can follow the instructions at https://www.meteor.com/install.
Then you can simply run the following command, where
my-experiment is the name of the experiment you wish to create:
npx create-empirica-app my-experiment
It will create a directory called
my-experiment inside the current folder.
Inside that directory, it will generate the initial project structure and install the transitive dependencies:
my-experiment├── .meteor├── README.md├── node_modules├── package.json├── package-lock.json├── .gitignore├── public├── client│ ├── main.html│ ├── main.js│ ├── main.css│ ├── game│ │ └── ...│ ├── intro│ │ └── ...│ └── exit│ └── ...└── server├── main.js├── callbacks.js└── bots.js
No configuration or complicated folder structures, just the files you need to build your app. Once the installation is done, you can open your project folder:
Inside the newly created project, you can run the standard
meteor command to start you app locally:
meteor runs the app in development mode.
Open http://localhost:3000 to view it in the browser.
The page will automatically reload if you make changes to the code. You will see the build errors in the console.
If you are unsure as to which version of Empirica you have, you can run this line in your app to show you all the elements in the app, including Empirica Core:
As new versions of Empirica become available, you might want to update the version you are using in your app. To do so, simply run:
meteor update empirica:core