Leyman

An Nx monorepo of TypeScript libraries and tools for Node.js ESM environments.

First time here? Open this repo in VSCode — it will prompt you to reopen in the DevContainer, which sets up Node, PNPM, and all tooling automatically.

Packages

Full index of packages can be found here.

Getting Started

# Install dependencies
pnpm i

# Build and test everything
test-ci

Nx is not globally installed. It ships with @leyman/main and is on PATH automatically. Use nx directly — not npx nx or pnpm exec nx.

See AGENTS.md for the full skill index.

CI

This repo uses Dagger for CI. To replicate CI locally:

dagger-test
# or equivalently:
dagger call --mod ./dagger/test-and-build/ --source . run

Run test-ci first — it's faster for iteration. Use Dagger to confirm before pushing.

See all aliased (via PATH set during Devcontainer setup) scripts in the /scripts/commands directory.

Coding Agents

The .claude-config/ directory is not version-controlled (it's in .gitignore). While operating in devcontainer, that is where Claude credentials will be stored, so session can persist across devcontainer builds.

(If you use a different coding agent, PRs are welcome to support those directories).

Contributing

1. Make your changes
2. Run test-ci to verify
3. Run changeset and follow the prompts to document your changes
4. Submit a PR — GitHub Actions runs Dagger automatically

Tooling

Tool	Role
PNPM	Package manager with workspace support
Nx	Task runner with caching and dependency graph
TypeScript	Language (ESM, strict mode)
SWC	Fast TypeScript compiler
ESLint	Linting (opinionated, 15+ plugins)
Biome	Formatting
Mocha + Chai	Testing
C8	Coverage (100% required)
Dagger	CI pipeline
Changesets	Versioning and changelogs