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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

pFad - (p)hone/(F)rame/(a)nonymizer/(d)eclutterfier! Saves Data!