README.md

In teal.picks: Dataset and Variable Picker and Merge Module for 'teal' Applications

teal.picks

teal.picks is an R package used in the development of teal applications. It provides:

• a hierarchical choices / selected model for datasets, variables, and values in a Shiny session, with optional tidyselect support for dynamic choices,
• picks_ui and picks_srv modules to collect those selections interactively,
• merge_srv and tm_merge to merge teal data according to user picks,
• conversion helpers such as as.picks to align with teal.transform objects.

Installation

install.packages('teal.picks')

Alternatively, you might want to use the development version.

# install.packages("pak")
pak::pak("insightsengineering/teal.picks")

Usage

See the package reference for full documentation.

Below is a minimal illustration of defining a picks specification (datasets, then variables; optional values() when needed):

library(teal.picks)

my_picks <- picks(
  datasets(choices = c("iris", "mtcars")),
  variables(
    choices = tidyselect::everything(),
    selected = 1L,
    multiple = TRUE
  )
)

Wire my_picks into picks_ui / picks_srv with a reactive teal_data object, or use tm_merge inside a teal::init() application. Full patterns are documented on the package site.

Getting help

If you encounter a bug or have a feature request, please file an issue. For questions, discussions, and staying up to date, please use the teal channel in the pharmaverse slack workspace.

teal.picks documentation built on Oct. 9, 2026, 5:07 p.m.