Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/FelixHenninger/lab.js

Online research made easy
https://github.com/FelixHenninger/lab.js

economics javascript psychology psychology-experiments research science

Last synced: 4 months ago
JSON representation

Online research made easy

Lists

README 

        


  

  
lab.js







  

    Get started ·

    Open the builder ·

    Learn more ·

    Contribute

  




**`lab.js` makes it easy to build, run and share studies that help understand the mind.** It allows everyone to construct and construct experiments and surveys within the browser; the graphical builder makes it easy to get started without writing code.



[![Slack Status](https://img.shields.io/badge/support-online-brightgreen.svg)](https://lab.js.org/resources/support/)

[![Build Status](https://github.com/FelixHenninger/lab.js/workflows/Build/badge.svg)](https://github.com/FelixHenninger/lab.js/actions?query=workflow%3ABuild)

[![Documentation Status](https://readthedocs.org/projects/labjs/badge/?version=latest)](https://lab.js.org/docs/en/latest/)

[![Version on NPM](https://img.shields.io/npm/v/lab.js.svg)](https://www.npmjs.com/package/lab.js)

[![DOI](https://zenodo.org/badge/doi/10.5281/zenodo.597045.svg)](https://doi.org/10.5281/zenodo.597045)

[![Code is Science](https://img.shields.io/badge/Code%20is%20Science-%E2%9C%93-brightgreen.svg)](https://codeisscience.github.io/manifesto/)

![Made with all the love](https://img.shields.io/badge/made_with-❤️💛💚💙💜💖-e6e6e6.svg)





  




----



### Get started 🚀



The [**graphical builder interface**](https://lab.js.org/builder) is the

easiest way to create studies, and the best place to start. The tutorial

will walk you through [building your first study, step by

step](https://labjs.readthedocs.io/en/latest/learn/builder/).



If you prefer working directly with code, you can build studies using the

[**JavaScript library**](https://lab.js.org/docs/en/latest/reference/).

Everything you need is bundled in the *starter kit*, which is [provided with

every release](https://github.com/FelixHenninger/lab.js/releases/latest).

There is also a tutorial to [help you get started](https://lab.js.org/docs/en/latest/learn/code/).



If you get stuck or things don't make sense, please don't hesitate to reach out!



### Find help ☎️



The easiest and quickest way to find help is to [join our **Support

channel**](https://lab.js.org/resources/support/), where there's someone

around to discuss things and help out most of the time. You're welcome to just

join and say hello, we'd love to have you around!



### Keep up-to-date 📮



If you'd like to keep in the loop regarding the development, please [subscribe

to our **newsletter**](http://eepurl.com/co0K9r) to receive very occasional

updates and release notifications.



### Help improve `lab.js`! ✨☀️



**We would love to have you as part of this project!** There are lots of

different [**ways to contribute**](https://lab.js.org/docs/en/latest/meta/contribute/ways.html),

and we recognize and very warmly welcome all kinds of involvement:



* **Feedback, ideas and suggestions** are always appreciated. If we can make `lab.js` more useful, we'd love to!

* If you've found something that didn't work, felt harder than it should, or figured out a trick, it's likely that others will benefit from your experience. Please [**file an issue**](https://github.com/FelixHenninger/lab.js/issues/new) that describes what's going on, or **contribute a brief recipe** to the documentation.

* We wholeheartedly invite fellow scientists and students to **share your studies**: Chances are that others are trying something very similar — by sharing yours, you'll be giving other researchers a head start. We'll happily help you polish your study if you'd like.

* Of course, **code contributions** are hugely welcome! If you're missing something, we'd love to work with you to extend the project. If you're looking for an area to contribute, [let us know](#find-help), or [check out the issues](https://github.com/FelixHenninger/lab.js/issues) for some ideas — we'd love to support you and help you get started, regardless of your skill level: **We are all learners**.



**Please also let us know if you'd like to join in but are unsure how**, we'd be

thrilled to help you find something that suits your interests and resources.

The [**contributor's guide**](contributing.md) provides further information

about our process; we have some pointers regarding how to [build the project](https://lab.js.org/docs/en/latest/meta/contribute/build.html)

in the documentation.



----



### Contributors ❤️



(in alphabetical order)



#### Code / documentation 🔬



[Felix Henninger](http://felixhenninger.com) ·

[Pascal J. Kieslich](https://pascalkieslich.github.io/) ·

[Ulf K. Mertens](http://www.psychologie.uni-heidelberg.de/ae/meth/team/mertens/) ·

[Yury Shevchenko](http://yuryshevchenko.com/) ·

[Vanessa Sochat](https://vsoch.github.io/)



#### Tasks and templates 🎁️



[Michael Kriechbaumer](https://www.cognition.uni-landau.de/people/michael-kriechbaumer-msc/) ·

[Felix Ludwig](https://www.cognition.uni-landau.de/people/felix-ludwig-msc/) ·

[Folco Panizza](https://sites.google.com/view/panizzafolco) ·

[Merle M. Schuckart](https://github.com/MMarieSchuckart)



#### Ideas and feedback 💡



Dilek Akkus ·

[Angelo Belardi](https://psychologie.unibas.ch/de/personen/589/) ·

[Ursa Bernardic](https://www.unige.ch/gsem/en/research/institutes/iom/team/phd-students/ursa-bernardic/) ·

[Erin Buchanan](http://www.aggieerin.com/) ·

[Emily Elliott](https://lsu.edu/hss/psychology/faculty/cognitive/elliott.php) ·

[Jeffrey Fisher](https://github.com/jeffslofish) ·

[Kerstin Fröber](http://orcid.org/0000-0001-6060-2837) ·

[Robert Gaschler](https://www.fernuni-hagen.de/psychologie/psychologisches_institut/about_institute/departments/app_lme/staff/rgaschler/) ·

[Benjamin E. Hilbig](https://cognition.uni-landau.de/hilbig) ·

[Lea Hildebrandt](https://lea.netlify.app/) ·

[Alex Irvine](https://github.com/u01ai11) ·

[Dave Kleinschmidt](https://www.davekleinschmidt.com/) ·

[Kristian Lange](https://github.com/kristian-lange) ·

[Dano Morrison](https://github.com/jdpigeon) ·

[Karthikeya Pammi](https://github.com/pvskarthikeya) ·

Shivangi Patel ·

[Kwame Porter Robinson](https://robinsonkwame.github.io/) ·

Nick Robinson ·

[Sophie Scharf](http://cognition.uni-mannheim.de/mitarbeiter/m_sc_sophie_scharf/) ·

[Nikoletta Symeonidou](https://www.sowi.uni-mannheim.de/en/erdfelder/team/academic-staff-members/symeonidou-nikoletta/) ·

[Hendrik Singmann](http://singmann.org) ·

Dawid Strzelczyk ·

[Kevin Tiede](https://www.spds.uni-konstanz.de/kevin-tiede) ·

[Anne Voormann](https://www.psychologie.uni-freiburg.de/abteilungen/Members/voormann) ·

[Andreas Voss](https://www.psychologie.uni-heidelberg.de/ae/meth/) ·

[Andrew White](https://github.com/shiroandy) ·

[Malte Zimdahl](http://psycho3.uni-mannheim.de/Personen/Malte%20Zimdahl,%20M.Sc./)



The students and teaching assistants in the graduate course *Research Methods

in Cognitive Psychology* at the University of Koblenz-Landau inspire the

continued development of this software, have provided countless valuable

insights, and sparked many of the ideas embodied in this project through

questions and discussions.



#### Sponsors and supporters 🎩



We are wholeheartedly grateful to our generous sponsors for making possible the

development of this tool:



[FernUniversität in Hagen](https://www.fernuni-hagen.de/psychologie/psychologisches_institut/about_institute/departments/app_lme/) ·

[GESS, University of Mannheim](http://gess.uni-mannheim.de/) ·

[Meta Reality Labs](https://research.facebook.com/) ·

[Mozilla Science Lab](https://science.mozilla.org) ·

[Rational Altruists Mannheim](http://www.ram-ev.de/) ·

[Stifterverband](https://www.stifterverband.org/english/) ·

[University of Koblenz-Landau](https://www.cognition.uni-landau.de/) ·

[Volkswagen Foundation](https://www.volkswagenstiftung.de/en/foundation/) ·

[Wikimedia Germany](https://meta.wikimedia.org/wiki/Wikimedia_Deutschland)





  

    

  





If you would like to support development as a scientific institution, the

easiest way is to **host a workshop**. We'll gladly show you and your

colleagues how to build experiments using this software, and build your

favorite paradigm together! We are also open to **consulting** if you are

looking for a particular feature — please don't hesitate to get in touch so

that we can discuss things in more detail.



----



### Citation 📓



We [kindly request](https://www.youtube.com/watch?v=kVwl-Va7cNM) that you cite

``lab.js`` if you use it in your research. Here's how:



> Henninger, F., Shevchenko, Y., Mertens, U. K., Kieslich, P. J., & Hilbig, B. E. (2022). lab.js: A free, open, online study builder. Behavior Research Methods, 54(2), 556–573. [https://doi.org/10.3758/s13428-019-01283-5](https://doi.org/10.3758/s13428-019-01283-5)



(There are also [version-specific dois](https://doi.org/10.5281/zenodo.597045) if you prefer those)



----



### License 👩‍⚖️



All parts of this project are openly available, subject to different licenses:



* The `lab.js` **core library** that is included in your studies is made

  available under the terms of the [Apache License](/packages/library/license).

* The **builder**, the graphical interface used to build experiments,

  is provided under the terms of the [GNU Affero General Public

  License](/packages/builder/license).



The studies you build based on the library, and those you create using the

builder, are always your own, and you are free to distribute them as you see

fit. When studies include the core library files, these files alone are governed

by the aforementioned license.