Pantheon Systems Decoupled Kits
Prerequisites
To configure the monorepo for development, the following should be installed locally:
Nodejs version 18 LTS. We recomemnd using nvm
npm version 9.x.x
pnpm version 8.x.x
We recommend using npm. Run the following command to install:
npm install -g [email protected]
Getting Started
- Fork this repo.
- Clone your fork to your local machine.
- Install dependencies for all packages and starters using the following
command:
pnpm install - Install the
husky pre-commit hooks.
Run the following command:
pnpm husky install
Useful Scripts
There are several scripts you can use on your monorepo.
Test all projects in the monorepo that have a test script:
pnpm testBuild all packages in the monorepo:
pnpm build:pkgsBuild all starters in the monorepo:
pnpm build:startersBuild all projects in the monorepo:
pnpm build:allRun commands in a targeted project, folder, or workspace, using the
pnpmfilter flag.For example, to start the Gatsby starter from the root of the monorepo (filter by namespace):
pnpm --filter './starters/gatsby-wordpress-starter' developLint in the starters and filter by directory:
pnpm --filter './starters/**' lintRun documentation:
pnpm --filter './web' start
Versions and Releases
Generating a Changeset
To generate a new changeset, run pnpm changeset in the root of the repository.
The generated Markdown files in the .changeset directory should be committed
to the repository.
Creating and Publishing New Versions
Versions and releases are created as part of our CI process and typically should not be created manually.
Bug Reports and Feature Requests
Is the code in this repository not working as expected? Open a bug report here
Is there something you would like to see added to this project? Open a feature request here
Further Reading
For more information on contributing to this project, see CONTRIBUTING.md