UI widgets we use.
We try to avoid breaking changes and the associated major version bumps in this package. The reason for that is to avoid the following scenario:
| x 4.6.0: Adding RadioButton widget | x 5.0.0: Breaking change in the TextArea widget | x 5.0.1: Styling fix in the Checkbox widget |
Suppose you just released version
5.0.1, a small styling fix in the checkbox widget, for a story you're working on. If the project you're working in currently pulls in
noredink-ui at version
4.x, then getting to your styling fix means pulling in a new major version of
noredink-ui. This breaks all
TextArea widgets across the project, so those will need to be fixed before you can do anything else, potentially a big effort.
To prevent these big Yaks from suddenly showing up in seemingly trivial tasks we prefer to avoid breaking changes in the package. Instead when we need to make a breaking change in a widget, we create a new module for it
lib/MyWidget/VX.js and define a custom element
We should change this process if we feel it's not working for us!
If you are moving in a widget from the monolith:
Nri.SomeModuleand its tests to
Nri.DEPRECATEDSomeModulein the monolith and start using
Nri.Ui.SomeModule.V1where you need it
Our goal is to gradually move to the newest version of each widget, and remove the old versions when they are no longer used.
noredink-uiis used by the monolith, CCS and tutorials
This repo contains an app showcasing all of these UI widgets.
To see them locally:
If you'd like to test your widget in the monolith before publishing, run
script/test-elm-package.py ../path_to_this_repo from the monolith's directory.
Run tests with
Travis will run
make ci to verify everything looks good.
You can run this locally to catch errors before you push!
Once your PR is merged, you can publish
master as a new version:
Run the following to bump && publish the version in
Commit and push your changes in a PR. Once it's approved and merged, then:
git tag -a 5.10.0 -m "release version 5.10.0" git push origin 5.10.0 elm publish
You can also add a tag in https://github.com/NoRedInk/noredink-ui/releases/new if you want to add more detail.
Once you've published, you should see the latest version at https://package.elm-lang.org/packages/NoRedInk/noredink-ui/.
You can develop this package without installing anything globally by using Nix. To get started, install nix from nixos.org/nix.
After that's set up in your shell (just follow the instructions at the end of the installation script) you can run
nix-shell to get a development environment with everything you need.
If you find that inconvenient, try using
Once that's set up,
echo use nix > .envrc and then
Anytime you enter the project your shell will automatically pick up the right dependencies.
If you find that
direnv loads too slow, there are faster loading strategies than the default in their wiki.
niv to manage Nix dependencies.
It is automatically loaded in the Nix environment.
Here are some things you might need to do:
| Task | Command |
| Add a non-npm, non-Elm dependency packaged with Nix | Look if it's in nixpkgs, or
niv add github.com/user/repo |
| Update Nixpkgs |
niv update nixpkgs |
| See all our dependencies | Look in
| See all our sources |
niv show |