This monorepo contains the core TypeScript libraries and tools for AlgoKit, making it easier to build, test, deploy, and index applications on the Algorand blockchain.
| Package | Directory | Description | Docs |
|---|---|---|---|
@algorandfoundation/algokit-utils |
algokit-utils-ts/ |
Core Algorand utilities providing a high-level, intuitive interface over algosdk. |
Docs · README |
@algorandfoundation/algokit-client-generator |
algokit-client-generator-ts/ |
Generates type-safe TypeScript clients for ARC-56 and ARC-32 smart contracts. | Usage · README |
@algorandfoundation/algokit-subscriber |
algokit-subscriber-ts/ |
Configurable transaction subscription and indexing library for Algorand. | Docs · README |
Shared build, lint, test, and documentation configuration lives in the private tooling/ workspace package (algokit-tooling).
- Node.js:
>=22.0 - pnpm:
12.11.2(pinned viapackageManagerinpackage.json) - AlgoKit CLI: Required to run LocalNet for integration tests (
algokit localnet start)
This repository uses pnpm workspaces with a single root lockfile and a strict dependency catalog in pnpm-workspace.yaml.
# Install dependencies across all workspace packages
pnpm install
# Build all packages in dependency order (utils -> client-generator -> subscriber)
pnpm run build
# Run tests across all packages (requires `algokit localnet start`)
pnpm run test
# Lint, type-check, format, and audit
pnpm run lint
pnpm run check-types
pnpm run format
pnpm run auditTo run a script in a single package, use pnpm --filter:
pnpm --filter ./algokit-utils-ts run test
pnpm --filter ./algokit-client-generator-ts run check-types
pnpm --filter ./algokit-subscriber-ts run lintImportant
Cross-package dependencies (algokit-client-generator-ts -> algokit-utils-ts, and algokit-subscriber-ts -> both) link to each dependency's built dist/ directory. Run pnpm run build after cloning and after modifying an upstream package before type-checking or testing its dependents.
External dependency versions are centrally managed in the catalog in pnpm-workspace.yaml with catalogMode: strict. Add or update dependencies using pnpm rather than editing package.json by hand:
pnpm --filter ./algokit-utils-ts add -D <pkg>The documentation sites for algokit-utils-ts and algokit-subscriber-ts are built with Astro Starlight and deployed together to GitHub Pages:
# Start a local dev server for a package's docs site
pnpm --dir algokit-utils-ts run docs:dev
pnpm --dir algokit-subscriber-ts run docs:dev
# Build the docs sites
pnpm --dir algokit-utils-ts run docs:build
pnpm --dir algokit-subscriber-ts run docs:buildEach package is versioned and released independently using semfrag.
Any pull request that modifies a package's src/ directory must include a changelog fragment file in that package's changelog.d/ directory (e.g., algokit-utils-ts/changelog.d/my-change.md) containing one or more of the sections defined in semfrag.json:
## Fixes
- Describe the change from the user's point of view| Section | Version Bump |
|---|---|
Breaking Changes |
major |
Features |
minor |
Fixes |
patch |
- Beta releases: Pushing to
mainautomatically merges pending fragments into each package'sCHANGELOG.mdand publishes a beta version to npm under themaindist-tag. - Stable releases: Running the Release workflow manually with Stable release? checked promotes pending beta versions to a stable release on npm under the
latestdist-tag. - Retrying a beta release: Running the workflow manually with Stable release? unchecked (the default) publishes betas like a push does, to retry a push's release that failed and was rolled back.
For deeper details on workspace architecture, shared tooling, DevPortal docs publishing, and how the repository history was combined, see MONOREPO.md.
All packages in this repository are licensed under the MIT License.