Skip to content

Latest commit

 

History

History
63 lines (39 loc) · 2.24 KB

DEVELOPING.md

File metadata and controls

63 lines (39 loc) · 2.24 KB
Raw

Developing

Pre-requisites

  1. We use the active NodeJS LTS. If you need to work with multiple versions of Node, you might consider using nvm.
  2. This repository uses yarn to manage node dependencies. Please install yarn globally using npm install --global yarn.
  3. Tests are executed on the latest NodeJS as well as all active and maintained NodeJS LTS versions.

Structure

Packages

The packages directory contains the different npm packages.

Typical workflow

You would only do this once after you cloned the repository.

  1. Clone this repository from git.
  2. cd into sfdx-dev-packages.
  3. We develop using feature brances off main and release from the main branch. At this point, it should be set to main by default. If not, run git checkout -t origin/main.
  4. yarn to bring in all the top-level dependencies and bootstrap.
  5. Open the project in your editor of choice.

When you are ready to commit

  1. We enforce commit message format. We recommend using commitizen by installing it with yarn global add commitizen then commit using git cz which will prompt you questions to format the commit message.
  2. Before commit and push, husky will run several hooks to ensure the message and that everything lints and compiles properly.

List of Useful commands

These commands assume that they are executed from the top-level directory. Internally, they delegate to lerna to call them on each npm module in the packages directory.

yarn bootstrap

This bootstraps the packages by issuing a yarn install on each package and also symlinking any package that are part of the packages folder.

You would want do this as the first step after you have made changes in the modules.

If you change the dependencies in your package.json, you will also need to run this command.

yarn compile

This runs yarn compile on each of the package in packages.

yarn clean

This run yarn clean on each of the package in packages. Running yarn cleal-all will also clean up the node_module directories.

yarn test

This runs yarn test on each of the packages.

yarn lint

This runs yarn lint on each of the packages.