Use the specified version of Node for this project:
nvm use
If you get an error that the version of node is not installed, run:
nvm install $(cat .nvmrc)
Watch packages for updates to code and documentation, triggering builds of both on change.
Install dependencies for each package.
Build each package.
Prepare each package for distribution.
Generate documentation for each package.
Run tests for all packages.
See CONTRIBUTING.md.
The generation of our documentation website is a three part process:
jsiimust be run within each package (this is done by runningnpm run buildfrom the project base dir). This produces a.jsiiin the root of each package.scripts/docgen.jsshould be run to gather each package's.jsiifile and to export markdown documentation for each package into thesite/docsdirectory.- Jekyll should be run to generate HTML from the markdown documentation.
This process can be made easier by running two processes in separate terminals:
npm startwhich concurrently runs two operations:- trigger
jsiibuilds on changes to packages'README.mdorlib/*.tsfiles. - trigger
scripts/docgen.jsto run on changes to packages'.jsiifiles.
- trigger
npm run websitewhich starts the Jekyll server. It is assumed that Jekyll has been previously installed on the system. See Jekyll's documentation for more information.