Welcome to the R4DS Mastering Shiny Book Club!
We are working together to read Mastering Shiny by Hadley Wickham.
Join the #book_club-mastering_shiny channel on the R4DS Slack to participate.
As we read, we are producing notes about the book.
You can catch up on Book Club recordings on the Mastering Shiny YouTube Playlist.
If you would like to present, please add your name next to a chapter using the GitHub Web Editor!
Cohort 1: (ended 2021-08-10)
Cohort 2: (started 2021-07-21) - Wednesdays, 6pm CST/CDT
- Part 0 (Getting up and running with
git
)- 2021-07-21: Git basics: Collin Berke
- Part 1 (Getting started)
- 2021-07-28: Chapter 1: Your First Shiny App: Collin Berke
- 2021-08-04: Chapter 2: Basic UI: Ola Giwa
- 2021-08-11: Chapter 3: Basic Reactivity: Collin Berke
- 2021-08-18: Chapter 4: Case Study: ER injuries: Ryan S
- Part 2 (Shiny in action)
- 2021-08-25: Chapter 5: Workflow: Collin Berke
- 2021-08-01: Chapter 5: Reprexes: Kevin Gilds
- 2021-09-08: Chapter 6: Layout, themes, HTML: Ryan Metcalf
- 2021-09-15: Wrap-up of Chapter 6: Layout, themes, HTML& Chapter 7: Graphics: Ryan Metcalf & Ryan Spjut
- 2021-09-22: Chapter 8: User Feedback: Kevin Gilds
- 2021-09-29: Chapter 9: Uploads and Downloads: Collin Berke
- 2021-10-06: Chapter 10: Dynamic UI: Ryan Metcalf
- 2021-10-13: Chapter 10: Dynamic UI: Ryan Metcalf & Collin Berke
- 2021-10-20: Chapter 10: Dynamic UI: Collin Berke & Chapter 11: Bookmarking: Conor Tompkins
- 2021-10-27: Chapter 12: Tidy evaluation: Presenter TBA
- Part 3 (Mastering reactivity)
- 2021-11-03: Chapter 13: Why reactivity?: Presenter TBA
- 2021-11-10: Chapter 14: The reactive graph: Presenter TBA
- 2021-11-17: Chapter 15: Reactive building blocks: Presenter TBA
- 2021-11-24: Chapter 16: Escaping the graph: Presenter TBA
- Part 4 (Best practices)
- 2021-12-01: Chapter 17: General guidelines: Presenter TBA
- 2021-12-08: Chapter 18: Functions: Presenter TBA
- 2021-12-15: Chapter 19: Shiny modules: Presenter TBA
- 2022-12-22: Chapter 20: Packages: Presenter TBA
- 2022-12-29: Chapter 21: Testing: Presenter TBA
- 2022-01-05: Chapter 22: Security: Presenter TBA
- 2022-01-12: Chapter 23: Performance: Presenter TBA
- 2022-01-19: Roundup
This repository is structured as a {bookdown} site. To present, follow these instructions:
- Setup Github Locally
- Fork this repository.
- Create a New Project in RStudio using your fork.
- Create a New Branch in your fork for your work.
- Edit the appropriate chapter file. Use
##
to indicate new slides (new sections). - If you use any packages that are not already in the
DESCRIPTION
, add them. You can useusethis::use_package("myCoolPackage")
to add them quickly! - Commit your changes.
- Push your changes to your branch.
- Open a Pull Request (PR) to let us know that your slides are ready.
When your PR is checked into the main branch, the bookdown site will rebuild, adding your slides to this site.
If you create any shiny apps to illustrate the concepts in a chapter, you are
welcome to include them with your chapter notes. The apps should be placed in
the ./examples/
directory of the repository.
Create a subdirectory named
./examples/<chapter-number>_<chapter-name>_<app-description>
for each of the
apps you create and place your app.R
file in there.
For example, if while working on chapter 3 ("Basic Reactivity"), you create an
app to illustrate controlling the timing of evaluation, you might add your app
as ./examples/03-basic_reactivity-timing_evaluation/app.R
.
If any static image files are used in the .Rmd for a chapter, please add them into the directory
./images/<chapter_number>-<title_stub>/
. For example, to include images for the "01-your_first_shiny_app" chapter, please place them in ./images/01-your_first_shiny_app/
.