Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
87 lines (57 loc) · 1.54 KB

CONTRIBUTING.md

File metadata and controls

87 lines (57 loc) · 1.54 KB

Contribution guidelines

Prerequisites

Install dependencies

  1. Install npm dependencies for all workspaces :
npm i
  1. Pull images at first and then once in a while :
docker compose pull
  1. Then run the containers :
npm run dev-deps

Stop the containers with this command :

npm run stop-dev-deps
  1. Generates the types based on schemas :
npm run build-types

Building and running the Docker images

docker build --progress=plain --target=main -t data-fair/openapi-viewer:dev .

All-in-one development

You can run all services at once thanks to Zellij.

First time instructions
  1. Install Rust's Cargo
curl https://sh.rustup.rs -sSf | sh
# choose 1 when prompted
  1. Install Zellij
cargo install --locked zellij
  1. Install NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
nvm install

Run the Zellij command :

npm run dev-zellij

Access the running services at http://localhost:5600/openapi-viewer

Tips :

  • Use Ctrl + Q to quit Zellij.
  • Click on a panel, then use Ctrl + C then Esc to stop a terminal and regain access of the panel.