To run this repo locally, run yarn
to install and link dependencies.
For dev testing, run yarn dev
. By default, this only runs the packages.
To run examples, you'll want to run run a yarn dev
in the example folder of your choice or modify the dev
script in the top level package.json.
Examples:
- To run all examples
- include
--scope 'demo-*'
in the dev script - Run
npx lerna run dev --scope 'demo-*'
locally after runningyarn dev
- include
- To only run
vanilla-ts-esm
demo- include
--scope '*-esm'
in the dev script - Run
npx lerna run dev --scope '*-esm'
locally after runningyarn dev
- include
It's helpful to point at Media Chrome canaries for developing PRs and having all the live examples work; however, we should not merge any PRs that point at a Media Chrome Canary release.
In the future, we'll use a bash script to automate this process.
Each package needs to be individually released. The following steps should be followed for each package.
- Update the changelog to include the new version.
- Stage the changes and commit them.
- Run
yarn build
in the either the top level or the package directory. - Tag the commit with the new version,
git tag 1.0.0
- Push the changes and tags,
git push && git push origin 1.0.0
- Run
npm pack
to generate a tarball of the package, check log output to see that all dist files are included. - Add the tarball to the release on GitHub.
- Run
npm publish
to publish the package to npm. - Update the version in any dependent packages, e.g.
@imgix/ix-player-react
depends on@imgix/ix-player
. - Repeat steps 1-8 for each package that needs to be released with the new version.
- Update the player on across *.imgix.com sites.