index.Rmd

---
title: "NEFSC R Shiny Book"
author: "R shiny group"
date: "`r format(Sys.Date(), '%e %B %Y')`"
site: bookdown::bookdown_site
knit: "bookdown::render_book"
output: gitbook
always_allow_html: true
documentclass: book
#bibliography: ["bibliography/xxx.bib","packages.bib"]
biblio-style: apalike
link-citations: true
github-repo: kimberly-bastille/READ-shiny-book
description: "This book documents nothing yet"
---

# Introduction

This book was compiled by the NEFSC R [shiny group](#group) to showcase how we have used [R shiny](https://shiny.rstudio.com/) apps to enhance our work. Each chapter describes a different shiny app developed at the Northeast Fisheries Center. Many of the apps shared here are under ongoing development and the purpose of this book is to share our work and the lessons we've learned through developing these apps. 

## Welcome

Welcome to the shiny group. If you are here then there is agood chance you are either interested in finding out what apps the group are working on or you are considering collaborating on or creating an app yourself. Information on this page should help get you started.

## Getting Started

All apps developed by the shiny group are located on the **internal** server `shiny1`. Anyone who is inside of the NEFSC firewall (either physically or via VPN) should be able to run any of the apps developed by the shiny group. (Login [credentials](#creds) are required to contribute an app or to collaborate with others on the development of an app.) 

Each app developed by a particular user will reside in a unique folder under their account name. The following url format is used to run any app `http://shiny1.nefsc.noaa.gov:3838/username/appname`. The app is physically located at `\\net.nefsc.noaa.gov\shiny1\username\appname` 

## Required Credentials {#creds}

Credentials are required to access the source code of any app.

* An account/permissions to access the `shiny1` server
* If working remotely then a VPN account is also required.

The VPN account is needed (only if working remotely) to run the app and to update/develop an app on the server

Please contact ITD for help in setting up accounts and providing access.

## Saving the app

A shiny app can be developed:

* locally (and then copied to the server) or
* directly on the server. 

Rstudio is installed on the shiny (`shiny1`) server to help with live testing of an app. To launch Rstudio in a browser use the following url: `http://shiny1.nefsc.noaa.gov` then log in with credentials.

Save apps to `\\net.nefsc.noaa.gov\shiny1\username\appname`








```{r setup, echo=FALSE}
image.dir <- here::here("images")
```