49d343941e
* ci: test docs-publish * Specify to use prod * Babel should transpile with env set by webpack * in-progress * in-progress * Polyfill for ie11 and edge features * Ditch polyfills w/ babel - we'll use a service for now * Bump tools version; shift vtk.js up a layer * Specify we shouldn't target older than IE 11 * ditch babel plugins that should be covered by preset-env * Add a top level build demo command * Let our babel config determine settings * Same babel fixes as PWA * Rebuild deps that don't satisfy our target * Mini helper script for excluding all node_modules, except... * Shift vtk.js dep up a layer * Kill core-js * Export in a node happy way * Updated yarn lock * Set NODE_ENV when launching anything w/ WebPack * docs: updated FAQ * docs: on browser support * Add support for redux browser extension * misc. small clean-up * docs: Remove roadmap page; add browser-support to sidebar * Formatting * Remove roadmap links * Formatting * ci: Remove config syntax error * Simplified bug report template * update community request template * Update question's template * simplify build scripts * specify new script names * fix: for measurement api being pruned by minimizer in prod builds * Use named exports * Simplify config * Let's not do so much heavy lifting for a dev-server build * fix dev build * Add hotkeys to demo * fix: jest babel config and env specific configs * Remove call to non-existant command * Shift experimental proposal plugin up a layer * Use `https` * Try with reduced number of package exceptions * Try to resolve cypress issue * Try to fix cypress issue in CI * Skip https
116 lines
3.6 KiB
Markdown
116 lines
3.6 KiB
Markdown
# Getting Started
|
|
|
|
## Setup
|
|
|
|
### Fork & Clone
|
|
|
|
If you intend to contribute back changes, or if you would like to pull updates
|
|
we make to the OHIF Viewer, then follow these steps:
|
|
|
|
- [Fork][fork-a-repo] the [OHIF/Viewers][ohif-viewers-repo] repository
|
|
- [Create a local clone][clone-a-repo] of your fork
|
|
- `git clone https://github.com/YOUR-USERNAME/Viewers`
|
|
- Add OHIF/Viewers as a [remote repository][add-remote-repo] labled `upstream`
|
|
- Navigate to the cloned project's directory
|
|
- `git remote add upstream https://github.com/OHIF/Viewers.git`
|
|
|
|
With this setup, you can now [sync your fork][sync-changes] to keep it
|
|
up-to-date with the upstream (original) repository. This is called a "Triangular
|
|
Workflow" and is common for Open Source projects. The GitHub blog has a [good
|
|
graphic that illustrates this setup][triangular-workflow].
|
|
|
|
### Private
|
|
|
|
Alternatively, if you intend to use the OHIF Viewer as a starting point, and you
|
|
aren't as concerned with syncing updates, then follow these steps:
|
|
|
|
1. Navigate to the [OHIF/Viewers/tree/react][ohif-viewers-react-repo] repository
|
|
and branch
|
|
2. Click `Clone or download`, and then `Download ZIP`
|
|
3. Use the contents of the `.zip` file as a starting point for your viewer
|
|
|
|
> NOTE: It is still possible to sync changes using this approach. However,
|
|
> submitting pull requests for fixes and features are best done with the
|
|
> separate, forked repository setup described in "Fork & Clone"
|
|
|
|
## Developing
|
|
|
|
### Requirements
|
|
|
|
- [Node.js & NPM](https://nodejs.org/en/)
|
|
- [Yarn](https://yarnpkg.com/en/)
|
|
|
|
### Kick the tires
|
|
|
|
Navigate to the root of the project's directory in your terminal and run the
|
|
following commands:
|
|
|
|
```bash
|
|
# Restore dependencies
|
|
yarn install
|
|
|
|
# Start local development server
|
|
yarn start
|
|
```
|
|
|
|
You should see the following output:
|
|
|
|
```bash
|
|
Compiled successfully!
|
|
|
|
You can now view ohif-viewer in the browser.
|
|
|
|
Local: http://localhost:3000/
|
|
On Your Network: http://10.74.20.83:3000/
|
|
|
|
Note that the development build is not optimized.
|
|
To create a production build, use yarn build.
|
|
```
|
|
|
|
### 🎉 Celebrate 🎉
|
|
|
|
<center>
|
|
<img alt="development server hosted app" src="/assets/img/loading-study.gif" />
|
|
<i>Our app, hosted by the development server</i>
|
|
</center>
|
|
|
|
### Building for Production
|
|
|
|
> More comprehensive guides for building and publishing can be found in our
|
|
> [deployment docs](./../deployment/index.md)
|
|
|
|
```bash
|
|
# Build static assets to host a PWA
|
|
yarn run build:web
|
|
|
|
# Build packaged output
|
|
yarn run build:package
|
|
```
|
|
|
|
## Next Steps
|
|
|
|
...
|
|
|
|
## Troubleshooting
|
|
|
|
- If you receive a _"No Studies Found"_ message and do not see your studies, try
|
|
changing the Study Date filters to a wider range.
|
|
- If you see a 'Loading' message which never resolves, check your browser
|
|
JavaScript console inside the Developer Tools to identify any errors.
|
|
- If you see any errors in your server console, check the
|
|
[Troubleshooting](./troubleshooting.md) page for more in depth advice.
|
|
|
|
<!--
|
|
Links
|
|
-->
|
|
|
|
<!-- prettier-ignore-start -->
|
|
[fork-a-repo]: https://help.github.com/en/articles/fork-a-repo
|
|
[clone-a-repo]: https://help.github.com/en/articles/fork-a-repo#step-2-create-a-local-clone-of-your-fork
|
|
[add-remote-repo]: https://help.github.com/en/articles/fork-a-repo#step-3-configure-git-to-sync-your-fork-with-the-original-spoon-knife-repository
|
|
[sync-changes]: https://help.github.com/en/articles/syncing-a-fork
|
|
[triangular-workflow]: https://github.blog/2015-07-29-git-2-5-including-multiple-worktrees-and-triangular-workflows/#improved-support-for-triangular-workflows
|
|
[ohif-viewers-repo]: https://github.com/OHIF/Viewers
|
|
[ohif-viewers-react-repo]: https://github.com/OHIF/Viewers/tree/react
|
|
<!-- prettier-ignore-end -->
|