An open API service indexing awesome lists of open source software.

https://github.com/dfe-analytical-services/shinyGovstyle

Apply GOV.UK styled components and formats in R Shiny
https://github.com/dfe-analytical-services/shinyGovstyle

Last synced: 2 months ago
JSON representation

Apply GOV.UK styled components and formats in R Shiny

Awesome Lists containing this project

README

          

# shinyGovstyle

[![CRAN status](https://www.r-pkg.org/badges/version/shinyGovstyle)](https://cran.r-project.org/package=shinyGovstyle)
[![R-CMD-check](https://github.com/moj-analytical-services/shinyGovstyle/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/moj-analytical-services/shinyGovstyle/actions/workflows/R-CMD-check.yaml)
[![](https://cranlogs.r-pkg.org/badges/shinyGovstyle)](https://cran.r-project.org/package=shinyGovstyle)
[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)

> Apply Gov styled components and formats in shiny

## Overview

This package provides custom widgets to style R Shiny apps using the GOV.UK design system. The components can be previewed in our [example showcase app](https://department-for-education.shinyapps.io/shinygovstyle-example-app/).

![example app demonstration](man/figures/example_app.gif)

To view details and advice on how to use the GOV.UK components please visit https://design-system.service.gov.uk/components/, most components should be available to use through this package.

### Installation

You can install the latest stable version from CRAN
```r
install.packages("shinyGovstyle")
```

If you want to make use of the development version then install directly from GitHub.
```r
remotes::install_github("dfe-analytical-services/shinyGovstyle")
```

This has previously also been available on conda though is no longer actively maintained, if you are using the package in this way, please let us know!
```
conda install r-shinygovstyle
```

To use error and word count elements you will need to load useShinyjs from shinyjs in your ui.R file
```r
shinyjs::useShinyjs()
```

### Contributing

Ideas, bug reports, and requests for new components should be [raised as GitHub issue](https://github.com/moj-analytical-services/shinyGovstyle/issues/new). It's often worth checking the existing [issues log](https://github.com/moj-analytical-services/shinyGovstyle/issues) incase there is already an existing discussion you can conrtibute to.

More details on contributing can be found in the [CONTRIBUTING.md](.github/CONTRIBUTING.md) file.

This package is also released with a [Contributor Code of Conduct](.github/CODE_OF_CONDUCT.md). By contributing to this project, you agree to abide by its terms.

### Available components

Details of all available components and how to use them can be found in the [package documentation](https://dfe-analytical-services.github.io/shinyGovstyle/reference/index.html).

The package contains an [example showcase app](https://department-for-education.shinyapps.io/shinygovstyle-example-app/) you can view or run yourself, showcasing available components. The code for the example app is in the `inst/example_app/` folder. You can easily run the app from the console using:

```r
shinyGovstyle::run_example()
```