artfabrique / kort

A NodeJS application for conducting a variety of UX research methods.

Kort

Table of Contents

About
Screenshots
Installation and Setup
After Install
Support
License

About

A web application supporting multiple user experience (UX) research methods.

• Card Sorting
• Tree Testing
• Product Reaction Cards
• System Usability Scale (SUS)
• Net Promoter Score (NPS)

See the website for more information.

Screenshots

Installation and Setup

1. Use Git to clone the code (git clone https://github.com/carlsonp/kort.git) or download a release.

2. Edit the secretHash value in app.js and provide your own unique value.

3. Optionally edit the adminUser and set your own username.

4. Edit the adminPassword value in app.js.

5. Optionally set allowUserRegistration in app.js to allow users to register. Otherwise users can only be created by accounts with 'admin' access.

6. Optionally setup Google authentication. See the wiki for details.

7. Continue installation via source or via Docker.

Via Source

1. Install Node.js

2. Install MongoDB (3.0 or higher) or provide a connection to an existing server by editing the app.js file and setting the mongoURL. To optionally secure your MongoDB with a username and password, create a user for the kort database by doing the following:

   Open a Mongo commandline shell:

   mongo --port 27017
   

   Select the database:

   use kort
   

   Create the new user:

   db.createUser(
      {
        user: "kort",
        pwd: "123",
       roles: [ { role: "readWrite", db: "kort" } ]
      }
   )
   

   Then edit /etc/mongodb.conf and enable auth=true. Restart the service. Make sure to set the mongoURL with the appropriate username and password.

3. Run npm install on the commandline. This will install the dependencies into the node_modules folder.

4. Run node app.js from the main directory. This will start the NodeJS server on the default port 3000.

Via Docker

1. Install Docker

2. Install docker-compose

3. Build the containers

   docker-compose build
   

4. Start the containers (use -d to run in detached mode)

   docker-compose up
   

5. Stop the containers (when using detached mode)

   docker-compose down
   

After Install

1. You can connect via http://localhost:3000

2. The adminUser and adminPassword that is set in app.js is the username and password for the account that will be created upon first launch. Use this to login.

Support

Open a Github issue.

License

Kort is licensed under the GPLv3.