% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/tinytheme.R
\name{tinytheme_register}
\alias{tinytheme_register}
\alias{tinytheme_list}
\alias{tinytheme_unregister}
\title{Register, List, and Unregister Custom Themes}
\usage{
tinytheme_register(name, theme = "default", ...)

tinytheme_list()

tinytheme_unregister(name)
}
\arguments{
\item{name}{Character string. The name for your custom theme. Cannot clash
with or overwrite a built-in theme name (\code{"default"}, \code{"clean"}, etc.)}

\item{theme}{Character string or list. The base theme to inherit from. If a
string, it must reference a built-in or previously-registered theme. If a
list, it is used directly as the base definition. Default is \code{"default"}.}

\item{...}{Named arguments to override specific theme settings. These are
the same parameters accepted by \code{tpar()}.}
}
\value{
\code{tinytheme_register()} returns the theme definition list (invisibly).
\code{tinytheme_list()} returns a named list with character vectors \code{builtin}
and \code{registered}. \code{tinytheme_unregister()} returns \code{NULL} (invisibly).
}
\description{
\code{tinytheme_register()} registers a custom theme so it can be used by name
with \code{tinytheme()} or \code{tinyplot(..., theme = )}. Custom themes inherit from
a base theme and apply user-specified overrides. Registered themes are
session-scoped: they persist across plots but not across R sessions. To make
a custom theme permanently available, register it in your \code{.Rprofile}.

\code{tinytheme_list()} returns the names of all available themes (built-in and
registered).

\code{tinytheme_unregister()} removes a previously registered theme from the
registry. Does not reset an active theme.
}
\examples{
# Register a custom theme based on "float" but with a grid
tinytheme_register("float2", theme = "float", grid = TRUE)

# Use it
tinyplot(1:5, theme = "float2")

# List all themes
tinytheme_list()

# Unregister
tinytheme_unregister("float2")

}
\seealso{
\code{\link[=tinytheme]{tinytheme()}}
}
