Skip to content

Latest commit

 

History

History
57 lines (29 loc) · 2.01 KB

CONTRIBUTING.md

File metadata and controls

57 lines (29 loc) · 2.01 KB

Contributing

We appreciate any and all contributions. Before contributing, please read our code of conduct.

Chat

If you are here, you are likely part of the Kernel and you should join the #kernel-building-kernel Slack channel.

Submitting an issue

Feel free to submit an issue through the issue tracker.

Submitting a pull request

For non-trivial changes, please first seek a conversation to avoid any unnecessary work.

Developing

Node: Check that Node is installed with version >= 16.8.0. You can check this with node -v.

Yarn: Make sure that Yarn 1 is installed with version >= 1.22.0.

Setup

Fork the repo to your GitHub account, check it out locally and run

yarn install

Branch organization

All changes should be submitted against the main branch. The goal is to maintain a healthy tip of the branch with all tests passing and no breaking changes. Potentially breaking changes or experimental features should be behind a feature flag.

Code organization

This is a monorepo using yarn workspaces with each workspace in the customary packages folder.

Creating a new app

Look at packages/admin and copy the necessary config files. Consider contributing by adding a custom template to make this process easier.

Running the server locally

The storage service currently needs to connect to a Google Cloud Storage bucket. Consider contributing by adding a version with a storage service backed by a local file system instead.

Running an app

This repo uses workspaces to manage local dependencies. From the root of the repo, this is how you start the admin app:

yarn workspace @kernel/admin start

Running tests

TBD