okra

NOTE: This project is in alpha stage and under ongoing development. It may be subject to fundamental changes anytime.

Okra is a mobile (Android/iOS) app which allows its users to participate in psycholinguistic experiments. It receives the experiment setup and stimuli from a server of the institution conducting the experiment, presents the stimuli to the participant, collects responses and behavioral data, and sends them back to the server.

Supported tasks

The app currently provides implementations of various types of tasks related to psycholinguistics and reading comprehension in particular:

• Cloze test
• Lexical decision task
• Multiple-choice question answering task
• n-back working memory task
• Picture naming task
• Reaction time test
• Simon game (working memory task)

Issues and pull requests about adding more tasks are welcome (as long as they make sense).

Supported languages

The app is currently available in these localizations:

• English
• German
• German (Switzerland)

Pull requests adding more languages are welcome.

💻 Source code

🖼️ Screenshots

Documentation

• Project goals
• System architecture and technical overview
• API specification
• Task specifications

Getting started

Conducting experiments

To create and conduct experiments, you need to:

1. Set up a server that serves an API according to the specs. There is an example implementation.
2. Create a participant ID and a registration key for each participant to authenticate them.
3. Generate QR codes from strings like this:
   <base-url>\n<participant-id>\n<registration-key>
4. Give the QR codes to your participants to scan.
5. Distribute experiments and tasks using the API according to your own logic.

Developing

Requirements:

• Flutter
• Android/iOS emulator, Google Chrome, or a real device for testing
• Flutter Intl (extension for VS Code or plugin for IntelliJ) for i18n code generation

While developing, you can use the dummy server under dev_server/ and connect to it from the app on your emulator (http://10.0.2.2:<port> on Android) or device.

Running tests:

• Unit: flutter test
• Integration: flutter test integration_test/app_test.dart

Code formatting / static analysis:

• flutter format lib/main.dart lib/src/ test/ integration_test/
• flutter analyze
• Keep translation files (lib/i10n/*.arb) sorted

This site is open source. Improve this page.