LearnCard

LearnCard is a lifelong learning passport that empowers learners to collect, own, and share their skills and experiences.

5 verbs: Issue, Earn, Store, Share, Map.

LearnCloud is an open, API-driven platform that seamlessly integrates learning providers, tech systems, credentials and AI-driven ecosystems, enabling rapid scaling and interoperability for the future of education and employment.

Documentation

All LearnCard documentation can be found at: https://docs.learncard.com

Using an AI coding agent (Claude Code, Cursor, Codex)? Run npx @learncard/cli skill install in your project, then point the agent at Use LearnCard from an AI Agent.

Installation

Use Bun to install LearnCard.

bun install

Building and Testing

This repository uses Nx to manage package relationships. Use the provided scripts to ensure everything is built in the correct order and that tests run against fresh artifacts:

bun run build              # builds all packages (excluding docs and example apps) according to the dependency graph
bun run test:e2e           # builds dependencies then runs the end-to-end tests
bun run run-network-tests  # builds dependencies then runs the Brain service test suite

Avoid running individual package builds or tests directly, as that can lead to stale artifacts.

For CI-only case retries, reporting, and cache input requirements, see CI test retries.

The shared local-service Docker image installs dependencies with Bun 1.4.4 to read lockfile v3, then runs services with Bun 1.3.14. Bun 1.4.x's runtime (rechecked on 1.4.4) bypasses the Compose localhost:host-gateway mapping used for cross-service DID document resolution and notification delivery. Do not run dependency installation with the older runtime. Hosted service and browser E2E runners verify Cloud's localhost DID-document fetch before running their suites. To run that smoke against an already-started service stack:

cd tests/e2e
bash ../../scripts/e2e-hosted/verify-service-did-resolution.sh

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please review the contributing guidelines for more information: Contributing

Please make sure to update tests as appropriate.

Get Help

• Something broken? Open an issue — bugs and technical questions live here, next to the code.
• Want a feature, or curious what's coming? Request and vote on the roadmap · Changelog
• Private or commercial question? [email protected]

Who is Learning Economy Foundation?

Learning Economy Foundation (LEF) is a 501(c)(3) non-profit organization leveraging global standards and web3 protocols to bring quality skills and equal opportunity to every human on earth, and address the persistent inequities that exist around the globe in education and employment.

License

MIT © Learning Economy Foundation