create-empirica-app

create-empirica-app

The easy way to create an Empirica app.

Quick Start

You’ll need to have Node.js >= 8 on your local development machine. See Usage bellow if you don't have it installed.

npx create-empirica-app my-experiment
cd my-experiment
meteor

Then open http://localhost:3000/ to see your experiment.

Usage

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/.

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
│   │   ├── Round.jsx
│   │   ├── PlayerProfile.jsx
│   │   ├── SocialExposure.jsx
│   │   ├── Task.jsx
│   │   ├── TaskResponse.jsx
│   │   ├── TaskStimulus.jsx
│   │   └── Timer.jsx
│   ├── intro
│   │   ├── Consent.jsx
│   │   ├── InstructionStepOne.jsx
│   │   ├── InstructionStepTwo.jsx
│   │   └── Quiz.jsx
│   └── outro
│       ├── ExitSurvey.jsx
│       └── Thanks.jsx
└── 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:

cd my-experiment

Inside the newly created project, you can run the standard meteor command to start you app locally:

meteor

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.