Clone this repo:
  1. d4adaad [chopsui] Rename oppressive references to infra/infra branch. by Dave Tu · 5 months ago main master
  2. 7a156ae Update package.json to use `npx`. by Andrew Chang · 5 months ago
  3. b43d614 ChopsUI: Update docs to include non-Web Component code as well. by Tiffany Zhang · 5 months ago
  4. e366980 remove copybara initialization artifacts by Weiwei Lin · 11 months ago
  5. 7144f8c Copybara Service Migration Initialization. by Weiwei Lin · 11 months ago

chopsui

This directory contains Web Components and JavaScript libraries shared across Chrome Operations' application frontends.

Using chopsui components

Find the name of the specific component and install it within the @chopsui package scope. For example, to install chops-header, run npm install @chopsui/chops-header.

Contributing

To set up project development:

  1. Clone this repo with git clone.
  2. Install dependencies with npm run bootstrap.
  3. Run tests with npm test.
  4. Run demos with npm start. The demos will be at http://localhost:8080/.

Publishing packages

ChopsUI packages are published publicly on npm under the @chopsui organization.

Each component is published under a separate npm package. Packages are managed using Lerna. All packages are published together using a single version number kept in the lerna.json file under the version key.

To set up:

  1. Send your npm username to zhangtiff@ to be added to @chopsui.
  2. Authenticate in npm with npm adduser.

To publish a new version:

  1. Sync a clean branch with upstream set to origin/main.
  2. Create a new version with npx lerna version --no-git-tag-version. Lerna will prompt you to select a new version number, detect which packages have changed since the last version, and locally update the json files.
  3. Commit the changes, upload them for code review, and land them.
  4. Sync to the newly landed commit.
  5. Publish to npm with npx lerna publish from-package.