Skip to content

Commit

Permalink
added note for styling
Browse files Browse the repository at this point in the history
  • Loading branch information
ColinFay committed Feb 1, 2022
1 parent 0ceb94e commit 5c52713
Show file tree
Hide file tree
Showing 3 changed files with 76 additions and 27 deletions.
14 changes: 14 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,3 +56,17 @@ You're welcome to fix the bug or implement the feature, but __please don't PR in
7. In your PR message, please add the reference of the issue, and the content to be used in NEWS.md. Changes can be : `## New Functions`, `## New features`, `## Breaking changes`, `## Bug fix`, `## Bug fix`, `## Internal changes`

See https://github.com/ThinkR-open/golem/pull/149 for an example

### Styling

Please style the files according to `grkstyle::grk_style_transformer()`

```{r}
# If you work in RStudio
options(styler.addins_style_transformer = "grkstyle::grk_style_transformer()")
# If you work in VSCode
options(languageserver.formatting_style = function(options) {
grkstyle::grk_style_transformer()
})
```
15 changes: 15 additions & 0 deletions README.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -134,3 +134,18 @@ Read [Deploying Apps with {golem}](https://thinkr-open.github.io/golem/articles/
## CoC

Please note that this project is released with a [Contributor Code of Conduct](https://www.contributor-covenant.org/version/1/0/0/code-of-conduct.html). By participating in this project you agree to abide by its terms.


## Note for the contributors

Please style the files according to `grkstyle::grk_style_transformer()`

```{r}
# If you work in RStudio
options(styler.addins_style_transformer = "grkstyle::grk_style_transformer()")
# If you work in VSCode
options(languageserver.formatting_style = function(options) {
grkstyle::grk_style_transformer()
})
```
74 changes: 47 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@

<!-- README.md is generated from README.Rmd. Please edit that file -->

<!-- badges: start -->

[![Lifecycle:
Expand All @@ -21,95 +22,100 @@ shiny applications.

This package is part of a series of tools for Shiny, which includes:

- `{golem}` - <https://github.com/ThinkR-open/golem>
- `{shinipsum}` - <https://github.com/ThinkR-open/shinipsum>
- `{fakir}` - <https://github.com/ThinkR-open/fakir>
- `{shinysnippets}` - <https://github.com/ThinkR-open/shinysnippets>
- `{golem}` - <https://github.com/ThinkR-open/golem>
- `{shinipsum}` - <https://github.com/ThinkR-open/shinipsum>
- `{fakir}` - <https://github.com/ThinkR-open/fakir>
- `{shinysnippets}` - <https://github.com/ThinkR-open/shinysnippets>

## Resources

### The Book :

- <https://engineering-shiny.org/>
- [paper version of the book “Engineering Production-Grade Shiny
- <https://engineering-shiny.org/>
- [paper version of the book “Engineering Production-Grade Shiny
Apps”](https://www.routledge.com/Engineering-Production-Grade-Shiny-Apps/Fay-Rochette-Guyader-Girard/p/book/9780367466022)

### Blog posts :

*Building Big Shiny Apps*

- Part 1:
- Part 1:
<https://rtask.thinkr.fr/building-big-shiny-apps-a-workflow-1/>
- Part 2:
- Part 2:
<https://rtask.thinkr.fr/building-big-shiny-apps-a-workflow-2/>

[*Make a Fitness App from
scratch*](https://towardsdatascience.com/production-grade-r-shiny-with-golem-prototyping-51b03f37c2a9)

### Slide decks

- useR! 2019 : [A Framework for Building Robust & Production Ready
- useR\! 2019 : [A Framework for Building Robust & Production Ready
Shiny
Apps](https://github.com/VincentGuyader/user2019/raw/master/golem_Vincent_Guyader_USER!2019.pdf)
- ThinkR x RStudio Roadshow,Paris : [Production-grade Shiny Apps with
- ThinkR x RStudio Roadshow,Paris : [Production-grade Shiny Apps with
{golem}](https://speakerdeck.com/colinfay/production-grade-shiny-apps-with-golem)
- rstudio::conf(2020) : [Production-grade Shiny Apps with
- rstudio::conf(2020) : [Production-grade Shiny Apps with
golem](https://speakerdeck.com/colinfay/rstudio-conf-2020-production-grade-shiny-apps-with-golem)
- barcelonar (2019-12-03) : [Engineering Production-Grade Shiny Apps
- barcelonar (2019-12-03) : [Engineering Production-Grade Shiny Apps
with
{golem}](https://www.barcelonar.org/presentations/BarcelonaR_Building_Production_Grade_Shiny_Apps_with_golem.pdf)

### Video

- [{golem} and Effective Shiny Development
- [{golem} and Effective Shiny Development
Methods](https://www.youtube.com/watch?v=OU1-CkSVdTI)
- [Hands-on demonstration of
- [Hands-on demonstration of
{golem}](https://shinydevseries.com/post/golem-demo/)
- useR! 2019 : [A Framework for Building Robust & Production Ready
- useR\! 2019 : [A Framework for Building Robust & Production Ready
Shiny Apps](https://youtu.be/tCAan6smrjs)
- 🇫🇷 [Introduction to {golem}](https://youtu.be/6qI4NzxlAFU)
- rstudio::conf(2020) : [Production-grade Shiny Apps with
- 🇫🇷 [Introduction to {golem}](https://youtu.be/6qI4NzxlAFU)
- rstudio::conf(2020) : [Production-grade Shiny Apps with
golem](https://www.rstudio.com/resources/rstudioconf-2020/production-grade-shiny-apps-with-golem/)

### Cheatsheet

- [{golem} cheatsheet](https://thinkr.fr/golem_cheatsheet_v0.1.pdf)
- [{golem} cheatsheet](https://thinkr.fr/golem_cheatsheet_v0.1.pdf)

### Examples apps

These are examples from the community. Please note that they may not
necessarily be written in a canonical fashion and may have been written
with different versions of `{golem}` or `{shiny}`.

- <https://github.com/seanhardison1/vcrshiny>
- <https://github.com/CDU-data-science-team/healthcareSPC>
- <https://github.com/marton-balazs-kovacs/tenzing>
- <https://github.com/shahreyar-abeer/cranstars>
- <https://github.com/seanhardison1/vcrshiny>
- <https://github.com/CDU-data-science-team/healthcareSPC>
- <https://github.com/marton-balazs-kovacs/tenzing>
- <https://github.com/shahreyar-abeer/cranstars>

You can also find apps at:

- <https://connect.thinkr.fr/connect/>
- <https://github.com/ColinFay/golemexamples>
- <https://connect.thinkr.fr/connect/>
- <https://github.com/ColinFay/golemexamples>

## Installation

- You can install the stable version from CRAN with:
- You can install the stable version from CRAN with:

<!-- end list -->

``` r
install.packages("golem")
```

- You can install the development version from
- You can install the development version from
[GitHub](https://github.com/Thinkr-open/golem) with:

<!-- end list -->

``` r
# install.packages("remotes")
remotes::install_github("Thinkr-open/golem")
```

## Launch the project

Create a new package with the project template:
Create a new package with the project
template:

<img src="https://raw.githubusercontent.com/ThinkR-open/golem/master/inst/img/golemtemplate.png" width="80%" style="display: block; margin: auto;" />

Expand Down Expand Up @@ -150,3 +156,17 @@ Vignette for a detailed walkthrough.
Please note that this project is released with a [Contributor Code of
Conduct](https://www.contributor-covenant.org/version/1/0/0/code-of-conduct.html).
By participating in this project you agree to abide by its terms.

## Note for the contributors

Please style the files according to `grkstyle::grk_style_transformer()`

``` r
# If you work in RStudio
options(styler.addins_style_transformer = "grkstyle::grk_style_transformer()")

# If you work in VSCode
options(languageserver.formatting_style = function(options) {
grkstyle::grk_style_transformer()
})
```

0 comments on commit 5c52713

Please sign in to comment.