Requirements: Node.js 24 (LTS), pnpm 12 (Corepack works: corepack enable).
corepack enable
pnpm install
Common commands (see package.json):
| Command | What it does |
|---|---|
pnpm build |
Build all workspace packages |
pnpm test:unit |
Run unit tests for all packages |
pnpm lint |
Lint sources (with fixes) |
pnpm format |
Lint + prettier |
pnpm clean |
Remove dist/, .coverage/, tmp/ |
pnpm publish:beta |
Build + pnpm publish tagged beta (per package) |
Tests needing Postgres:
# start a local postgres:17 matching CI env vars
cd packages/nameservice-api && pnpm run test:integration
cd packages/nameservice-transactions && pnpm run test:functional
Versioning: bump all workspace packages with pnpm version:patch (or
pnpm version:beta for prereleases) and tag the release manually — the
beta workflow publishes on GitHub release creation.
This work is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License
This work is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License, under the following terms:
You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
You may not use the material for commercial purposes. For commercial purposes please reach out to info@protokol.com.
If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.
Read the rest of the obligatory license legal code.
Copyright (c) Protokol.com 2020