a genomics visualization tool for exploring a cohort's genotype and phenotype data
git clone git@github.com:stjude/proteinpaint.gitIf working on the server code: Install the
[system depedencies](https://docs.google.com/document/d/1tkEHG_vYtT-OifPV-tlPeWQUMsEd3aWAKf5ExOT8G34/edit#heading=h.jy5sdrb1zkut)
as listed in the [installation instructions](https://docs.google.com/document/d/1tkEHG_vYtT-OifPV-tlPeWQUMsEd3aWAKf5ExOT8G34/edit#heading=h.6nxua6c3ik9l).
```bash
cd proteinpaint
npm run sethooks
nvm use 20
npm install
# follow the instructions at https://docs.google.com/document/d/1tkEHG_vYtT-OifPV-tlPeWQUMsEd3aWAKf5ExOT8G34/editRequires Docker Desktop on your host machine.
cd proteinpaint
npm run sethooks
cd container/dev
./run.sh "/path/to/proteinpaint/"These scripts require npm v10.2+ and are tested with Node v20+.
# develop BOTH server and client code using 2 terminal windows/tabs
npm run dev # rebundles frontend code
npm start # in separate terminal runs the ProteinPaint server, requires a serverconfig.json at the project root
# --- OR ---
# to display both server/client bundling logs,
# plus server process logs in one terminal window/tab
npm run dev1
# --- OR ---
# see build/dev/README.md to use a Docker container for developmentWhen running your dev server, you can see marked up README's in the browser.
Changes made to the code in the host machine will be reflected in the container and re-bundled automatically. The command npm run dev1 will be run in the container when starting the docker image using /container/dev/run.sh script.
To use VSCode with the Docker container, you can use the Dev Containers extension.
- Install the Remote - Containers extension.
- Open the proteinpaint directory in VSCode.
- Click on the "Reopen project in Dev Container" button that appears in the bottom right corner of the window.
- Open the terminal from VS code and run the following commands to start the server and bundling process:
npm install
npm run build
cp container/dev/serverconfig.json .
npm run dev1npm testws # tests all workspacesYou can also set your serverconfig.debugmode: true, and open http://localhost:3000/testrun.html to see available client-side unit and integration tests.
The build and release steps can be triggered via Github Actions using the Create Release workflow.
See container/README.md.
Use Github Actions to coordinate the release of related package updates.
The package versioning, build, and deployment uses the standard npm tooling under the hood
(version, pack, and publish, respectively).
You may dry-run a version change by running the following:
cd ~/proteinpaint
# see the comments in the script for arguments
./build/jump.sh patch
# to undo changes if the `-w` option was used
git restore .To auto-generate documentation to public/docs,
npm run docTODOs:
- Organize the leftbar links by API topics, by using typescript namespaces or coding a custom plugin
- Display test code that are specific to a documented type or interface