Shared tools and libraries for building UW applications.
A set of React components for building UW branded UIs, built in collaboration with the UX design team.
Please have a look at the documentation for how to get started using these components.
A set of React Native components for building UW branded UIs, built in collaboration with the UX design team.
Please have a look at the documentation for how to get started using these components.
Sets of colour scales for web and mobile, including light and dark mode for native mobile applications, as well as colours common to both colour modes. These colour scales are autogenerated from the Figma source.
Please have a look at the documentation for how to get started using these colours.
A UW standard config for Prettier code formatting.
Please have a look at the package README for how to get started using these colours.
We will be using the web-ui-v1.x
branch to manage the upcoming Web UI v1
release. Any hotfix releases for Web UI v0.x
will happen on the main
branch
until v1
is released, at which point a web-ui-v0.x
branch will be created to
support any v0.x
bug fixes.
Please read our contribution guide.
Please feel free to open issues here, however we are using linear for issue tracking, so it may be moved there after being evaluated.
All changes are published through Github Actions on the
main
branch. All development should take place on branches from main
then
submit a PR to merge back to main
.
Changesets
will be added as changes are contributed. When changes are merged to main
the
release workflow will run which will open, and keep updated, a Version Pull
Request containing all changes. When this is merged to main
all packages will
be versioned, published to npm and changelogs will be generated based on the
changesets.
You can use storybook to develop UW Web UI components locally. To get started, clone this repo and run the following command in the root directory.
npm run setup
This will get pnpm
set up. If necessary, refer to the corepack documentation
if there are issues with the corepack installation.
You can then install all the necessary dependencies, build the packages, and run the Storybook app and the Web UI library in watch mode. As before, run these commands in the root directory.
pnpm install
pnpm build
pnpm dev