Welcome!

Pushkin provides a customizable, scalable ecosystem for massive online psychological experiments

🏡 We've moved!

Please refer to the new Pushkin documentation at https://pushkin-consortium.github.io/pushkin!

---

Welcome!

“Getting Started” will get a very simple demo site up and running. The remaining pages explain how to customize your website. Instructions are geared towards someone who ideally has at least some familiarity with JavaScript and React. Sections intended for more experienced programmers who need to understand the guts of Pushkin are labeled under Developers. See the full Table of contents here.

To get the latest news and updates on Pushkin, sign up for our newsletter here

---

🚨 Important Note

Due to an update in AWS resources, the CLI-based AWS deploy does not currently work and is being updated. In the meantime, you can still manually deploy to AWS.

---

Table of contents

• Getting Started

  • Installing Pushkin and dependencies

    • macOS

    • Windows 10

      • Windows Subsystem for Linux (preferred)

      • AWS EC2 Instance

    • Ubuntu Linux

  • Quickstart

  • Deploying to AWS

    • Install required software.

    • Configure the AWS and ECS CLIs.

    • Register a domain.

    • Set up DockerHub.

    • Initialize AWS Deploy.

  • Tutorial: Simple Experiment

• FAQ

  • FAQ

• Advanced

  • Pushkin CLI

    • config

    • install site

    • install experiment

    • updateDB

    • prep

    • start

    • stop

    • kill

    • armageddon

    • help

  • Using Experiment Templates

    • Lexical decision template

    • Grammaticality judgment template

    • Self-paced reading template

  • Experiment Structure

    • Config File

    • Experiment Web Page Component

    • Recommended Structure

    • Customizing the client

    • Worker

    • Migrations

    • Seeds

  • Pushkin Client

    • connect

    • loadScript

    • loadScripts

    • prepExperimentRun

    • getAllStimuli

    • setSaveAfterEachStimulus

    • saveStimulusResponse

    • insertMetaResponse

    • endExperiment

    • customApiCall

  • pushkin-api

    • Controller Builder

    • Core API

  • Users & Authentication

    • Generating UserIDs

    • Using UserIDs

  • Modifying Site Template

    • React Bootstrap

    • Header and Footer

    • Home Page

    • Findings Page

    • About Page

    • Feedback Page

  • Deployment

    • Deleting AWS

• Developers

  • Developing with Pushkin

  • Getting Started on Development

    • Understanding the Front End

    • Understanding Docker

    • Testing Pushkin Modules Locally

    • Pushkin jsPsych

  • Testing Pushkin with Jest

  • Working with Templates