Explore CRAN packages in an interactive R Shiny app. You can see the application in action on shinyapps.io: https://nz-stefan.shinyapps.io/cran-explorer/.
The goal of this project is to demonstrate the development of a complete data service entirely written in the statistical programming language R. Besides this web application, the project includes the creation of a data refresh process (also written in R) that runs inside an AWS Docker container on a daily schedule. Additionally, efforts were made to develop this project in a reproducible way by controlling the operating environmentand the used R version (through Docker containers), a complete list of all required R packages and their specific versions (through
packrat) with the intention to promote collaborative development and to reduce the friction of the setup process of R projects in heterogeneous development environments.
This web application is written using the R Shiny web framework. It demonstrates the use of custom HTML templates in Shiny apps to create a fancy user experience. The theme used in this app is made by Colorlib. The app was developed with best Shiny practices in mind, e.g. the use of Shiny modules. In total about 1,100 lines of code were written for this app in less than 80 hours. This time included app ideation and all required research of data sources, data preparation and its operationalisation, app development, design and how to best present the information.
Setup development environment
The development environment of this project is encapsulated in a Docker container.
- Install Docker. Follow the instructions on https://docs.docker.com/install/
- Make docker run without sudo
Log out and log back in so that your group membership is re-evaluated
sudo groupadd docker sudo usermod -aG docker $USER
- Clone the GIT repository
git clone https://github.com/nz-stefan/cran-explorer.git
- Setup development Docker container
You should see lots of container build messages
cd cran-explorer bin/setup-environment.sh
- Spin up the container
- Open http://localhost:8787 in your browser to start a new RStudio session
- Install R packages required for this app. Type the following instructions into the R session window of RStudio
The installation will take a few minutes. The package library will be installed into the
packrat/libdirectory of the project path.
- Open the file
app/global.Rand hit the "Run app" button in the toolbar of the script editor (or type
shiny::runApp("app")in the R session window). The Shiny app should open in a new window. You may need to instruct your browser to not block popup windows for this URL.
The data for this app is extracted from MetaCRAN which provides a database of all packages on CRAN and their publication history. The extraction processes transforms and summarises the data for efficient consumption in this app. The app's data is refreshed through a separate R process which runs daily in a Docker container on AWS. The data refresh is published in its own git repository (to be published soon).