# Getting Started

`dtsmartr` is a high-performance, interactive virtualized grid viewer designed to make exploring data in R easy, fast, and reproducible.

## Installation

You can install the development version of `dtsmartr` from GitHub:

    # install.packages("devtools")
    devtools::install_github("wagh-nikhil/dtsmartr")

## Basic Usage

The primary function of the package is `dtsmartr()`. Simply pass any `data.frame` to launch the explorer:

    library(dtsmartr)

    # Explore the classic mtcars dataset
    dtsmartr(mtcars)

## Custom Layout Densities (v0.4.0)

You can programmatically configure the default header and row density modes using `dtsmartr_options()`:

    # Launch in compact/minimal layout view
    dtsmartr(
      data = mtcars,
      options = dtsmartr_options(
        header_density = "minimal",
        row_density    = "compact"
      )
    )

## Lightweight Mode

If you need a clean, lightweight, metadata-free grid viewer for high performance, you can use the newly added `dtsmart_lite()` or its alias `dtsmartr_lite()`:

    # Forces a compact, clean grid view of a dataset
    dtsmart_lite(mtcars, title = "Mtcars Lite")

The lightweight mode automatically configures the grid with: * `advanced_filter = FALSE` (Hides Advanced logical condition rules panel) * `allow_export = FALSE` (Hides the ‘Query Code’ button entirely) * `header_summary = FALSE` (Collapses headers to compact mode, hiding micro-histograms and completeness bars)