Skip to content

Latest commit

 

History

History
34 lines (22 loc) · 1.71 KB

CONTRIBUTING.md

File metadata and controls

34 lines (22 loc) · 1.71 KB
Raw

Hello! Thank you for reading this file, we're eager for contributions.

PNPM

We use pnpm as our package manager. You need to use it, eg pnpm install instead of npm install.

Code style

If you want to format the whole codebase, you can do pnpm -r format at the root.

Other than that, we avoid runtime dependencies unless they're strictly needed. For example, our only dependency is hash-wasm, and it's only in the browser context and when uploaded files are > 10MB.

Pull requests

Keep your changes scoped to the subject of the PR!

It's not a hard requirement, but please consider using an icon from Gitmoji as a prefix to your PR title.

Tests

If you want to run only specific tests, you can do pnpm test -- -t "test name"

Adding a package

  • Add the package name in pnpm-workspace.yaml
  • Add a package.json inspired from the other packages (packages/hub/package.json / packages/agents/package.json) in packages/<package name>/package.json
  • Run pnpm install at the root
  • Edit packages/doc-internal/package.json and add the command in the scripts section:
    • doc-<package name> (don't forget to edit the start command too)
  • Add the <package-name>-publish.yml file in the .github/workflows folder, inspired from the other packages
  • Add the package in the main README.md
  • Add a tsup.config.ts file in the package folder, inspired from the other packages, or just use tsup src/index.ts --format cjs,esm --clean && tsc --emitDeclarationOnly --declaration as the build command
  • Copy .prettierignore from another package
  • Add a tsconfig.json