surveydown: An Open-Source, Markdown-Based Platform for Programmable and Reproducible Surveys

Haiku Summary

Hu, Pingfan, **Bunea, B., & Helveston, J.P. (2025) “surveydown: An Open-Source, Markdown-Based Platform for Programmable and Reproducible Surveys” PLOS One. 20(8). DOI: 10.1371/journal.pone.0331002

View PDF Code & Data RG Scholar

Generate surveys • with Quarto, shiny, and plain • markdown text and code

Key Figure

Abstract:

This paper introduces the surveydown survey platform. With surveydown, researchers can create surveys that are programmable and reproducible using markdown and R code, leveraging the Quarto publication system and R Shiny web framework. While most survey platforms rely on graphical interfaces or spreadsheets to define survey content, surveydown uses plain text, enabling version control and collaboration via tools like GitHub. The package renders surveys as interactive Shiny web applications, allowing for complex features like conditional skip logic, dynamic question display, and complex randomization. The package supports a diverse set of question types and formatting options and users can leverage Shiny’s powerful reactive programming model to create a wide variety of interactive features. As an open-source platform, surveydown provides researchers full control over their survey implementation, including the survey application as well as where and how the resulting response data are stored. Workflows are entirely reproducible and integrate seamlessly with existing workflows for data collection and analysis in R.

Bibtex:

@Article{,
  title = {surveydown: An open-source, markdown-based platform for programmable and reproducible surveys},
  author = {Pingfan Hu and Bogdan Bunea and John Paul Helveston},
  journal = {PLOS One},
  year = {2025},
  volume = {20},
  number = {8},
  doi = {10.1371/journal.pone.0331002}
}