launch_studio: Launch the SurveyStudio interface

In surveyframe: Survey Instrument Workflows

Launch the SurveyStudio interface

Description

Opens the SurveyStudio Shiny application, a visual interface for the complete surveyframe workflow. The studio includes screens to build a survey draft, open an existing instrument, preview the survey, upload responses, review data quality, inspect reliability, plan analyses, and export outputs.

Usage

launch_studio(
  instrument = NULL,
  responses = NULL,
  respondent_id = NULL,
  submitted_at = NULL,
  meta_cols = NULL,
  strict = TRUE,
  screen = c("auto", "build", "preview", "data", "quality", "analysis", "dashboard"),
  port = NULL,
  host = "127.0.0.1",
  launch.browser = interactive()
)

Arguments

instrument	An sframe object or NULL.
responses	A data.frame, tibble, CSV file path, or NULL.
respondent_id	Character or NULL. Response ID column when responses is a CSV path.
submitted_at	Character or NULL. Submission time column when responses is a CSV path.
meta_cols	Character vector or NULL. Metadata columns when responses is a CSV path.
strict	Logical. Passed to read_responses() when responses is a CSV path.
screen	Initial studio screen. One of "auto", "build", "preview", "data", "quality", "analysis", or "dashboard".
port	TCP port for the Shiny server.
host	Host address passed to shiny::runApp().
launch.browser	Whether to open the browser automatically.

Value

Called for its side effect.

See Also

launch_builder(), launch_dashboard(), read_sframe(), read_responses()

Examples

## Not run: 
launch_studio()

demo <- sframe_demo_data()
launch_studio(instrument = demo$instrument, launch.browser = FALSE)

launch_studio(
  instrument    = demo$instrument,
  responses     = demo$responses,
  respondent_id = "respondent_id",
  submitted_at  = "submitted_at"
)

## End(Not run)

surveyframe documentation built on July 25, 2026, 1:07 a.m.