% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/gtregression_app.R
\name{gtregression_app}
\alias{gtregression_app}
\title{Launch the gtregression app}
\usage{
gtregression_app(..., launch.browser = NULL)
}
\arguments{
\item{...}{Additional arguments passed to \code{shiny::runApp()}.}

\item{launch.browser}{Logical; passed to \code{shiny::runApp()}. The default
uses the RStudio Viewer when available, otherwise opens a browser only in
interactive sessions.}
}
\value{
Invisibly returns the result of \code{shiny::runApp()}.
}
\description{
Open a menu-driven Shiny app for common \pkg{gtregression} workflows:
data import, descriptive tables, regression tables, survival analysis,
diagnostics, causal mediation, plots, and exports.
}
\details{
The app is intentionally kept out of the core package startup path. Shiny and
other interface packages are suggested dependencies and are loaded only when
\code{gtregression_app()} is called.

The Advanced tab includes a guided candidate-model builder. Users can name
two to six models, choose model-specific exposures and adjustment variables,
optionally add an interaction, and track a primary exposure. The app fits
compatible \code{multi_reg()}, \code{cox_reg()}, or \code{surv_reg()} objects
before passing them to \code{compare_models()}. Generated code records every
fitting call and the final comparison for reproducible use outside the app.
}
\examples{
if (interactive()) {
  gtregression_app()
}

}
\seealso{
\code{compare_models()}, \code{multi_reg()}, \code{cox_reg()},
  \code{surv_reg()}
}
