Skip to content
@qlarr-surveys

Qlarr

Research, without friction

Qlarr

Discord 💬 | Demo 🖥️ | Docs 📄 | Deploy Locally in 30 Sec! 🚀

Qlarr is an open-source, self-hosted survey framework that takes a survey-as-code approach. Surveys are defined using JSON for structure and JavaScript for logic, making them platform-agnostic and executable across web, Android, and iOS from a single definition.

Built for researchers, organizations, and developers who need full control over their survey infrastructure, Qlarr runs entirely on your own servers — no third-party data processing, no vendor lock-in.

🌟 Key Features

  • 📄 Survey As Code - Write survey structure in JSON, and survey logic in JavaScript
  • 📴 Offline-First Design - Collect data anywhere without internet connectivity
  • ⍰ Conditional Logic & Skip Logic - Advanced branching based on user responses
  • ✅ Input Validation - Ensure data quality with built-in validation checks
  • 🎲 Randomization & Sampling - Randomize questions and options with weighted priorities
  • 🌐 Multilingual Surveys - Support for multiple languages
  • 🔗 Piping - Reference and display values from previous answers
  • ⬅️➡️ Flexible Navigation - All questions, page-by-page, or question-by-question
  • 🎨 Conditional Formatting - Dynamic styling based on responses
  • ⏱️ Time Limits & 📊 Scoring (WIP) - Perfect for quizzes and timed assessments

🚀 Quick Start

git clone https://github.com/qlarr-surveys/frontend.git && cd frontend/deploy
docker compose -f docker-compose.local.yml up -d

Then visit http://localhost:3000 (login: admin@admin.admin / admin).

🏗️ Repositories

Repository Description
Survey Engine (KMP) Core Kotlin Multiplatform engine — compiles survey definitions, manages execution state, and ensures consistent behavior across all platforms
Survey Engine Script JavaScript library that parses and validates survey logic expressions safely within a sandboxed AST
Backend Spring Boot REST API handling survey management, response storage, authentication, and offline sync
Frontend React-based WYSIWYG survey designer and respondent-facing survey renderer
Android App Native Android client powered by the KMP engine for true offline data collection

🤝 Contributing

We welcome contributors! Join our Discord to chat with us directly, open a Discussion for feature ideas, or raise an issue with clear reproduction steps for bugs.

📄 License

All repositories are licensed under AGPL-3.0.

Popular repositories Loading

  1. frontend frontend Public

    WYSIWYG editor and renderer for offline-first, programmable surveys

    JavaScript 9

  2. backend backend Public

    Spring Boot/Kotlin backend for Qlarr — survey execution, offline sync, and GraalVM-powered survey logic evaluation

    Kotlin 8 1

  3. android android Public

    Android app for Qlarr — offline-first survey data collection with skip logic, randomization, and background sync

    Kotlin 8

  4. survey-engine-kmp survey-engine-kmp Public

    Kotlin library that compiles survey definitions (JSON + JS) into a component graph and JavaScript state machine — the portable core of Qlarr, running on JVM, Android and iOS

    Kotlin 8

  5. survey-engine-script survey-engine-script Public

    AST-based validator for Qlarr survey logic expressions — whitelists safe JS constructs for use in conditional logic and skip rules

    JavaScript 2

  6. docs docs Public

    Docusaurus-powered documentation site for the Qlarr open-source survey platform

    TypeScript 2

Repositories

Showing 7 of 7 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…