LedgerHQ/ledger-live

analytics

Read when adding or changing product analytics events. Import track from @shared/analytics and React adapters from @shared/analytics-react.

detect-data-leaks

Detect new PII leaks introduced by the current branch. Use when asked to check for potential data leaks for the current changes.

e2e-mobile-add-or-update

Rules for writing or updating Detox E2E tests for ledger-live-mobile. Use when adding a mobile e2e spec, creating or refactoring a page object or drawer, adding testIDs to product code for automation, adding or changing a timeout, delay or wait, fixing a…

i18n-keys

Write wording keys the i18n key check can verify. Read when adding or changing t() / Trans i18nKey calls, key tables (titleKey, labelKey, ...) or English catalog entries in features/, domain/ or shared/, or when `lint:i18n-keys` fails.

knip-migration

Dead-code / unused-dependency detection uses `knip`, which requires each package to expose an explicit, minimal `package.json#exports` (no `./*` wildcard). Read this when adding a new package or migrating an existing one to knip.

ledger-wallet-cli

Official Ledger wallet-cli - USB-based CLI for Ledger hardware wallet flows (account discover, receive, balances, operations, send, swap quote/execute/status, genuine-check, assets token / token-by-id), the Ledger Key Ring (ring…

rebuild-to-fix-lib-import-errors

When typecheck finds an error importing from a lib in the monorepo, rebuild the lib

e2e-desktop-add-or-update

Add E2E tests for new coins or update existing Playwright tests for ledger-live-desktop. Use when the user wants to add send/receive e2e tests for a new cryptocurrency, update test configurations, work with Speculos, or a Pay tab spec. Pay tab specs live…

dependency-patches

Read before creating or changing `patches/*.patch`, `pnpm.patchedDependencies`, or using `pnpm patch` to modify third-party dependency source.

pnpm-resolution

`.pnpmfile.cjs` hooks and `pnpm.packageExtensions` are deprecated. Read when fixing MODULE_NOT_FOUND, undeclared peers, lockfile churn, or editing `.pnpmfile.cjs`, `pnpm.packageExtensions`, or `.npmrc` hoist patterns.

structure-flow

Place and organize Ledger Wallet code in the monorepo layers. Use when creating, moving, or reviewing code under apps, features, domain, shared, or support; deciding which layer owns a concern; structuring packages and flow steps; or checking package names,…

codeownership

Maintain CODEOWNERS file and team directories. Provides resolve-codeowners.js to annotate files with their owner team — useful to split a large PR by team. Use when working with "**/team-*/**" or splitting monolithic files.

pre-review

Deep code review

coin-modules

Rules and layout for coin module packages under libs/coin-modules/. Read when adding or modifying a coin module.

data-layer-advanced

Structure a Ledger Wallet data layer where one API response serves several entities. Use when creating or reviewing cross-entity domain/api orchestration with RTK Query, createAsyncThunk, or both, including response validation and tests spanning multiple…

feature-dev

Guided feature development with codebase understanding and architecture focus

package-public-api

A new-architecture package (shared/, domain/, features/) exposes its API through barrels that contain nothing but `export *`, and keeps its private code in an internals location. Read this when creating a package under shared/, domain/ or features/, when…

types-state-mocks

Structure a simple Ledger Wallet data layer where one API response maps to one entity slice. Use when creating or reviewing domain/entity schemas, inferred types, initial state, mocks, selectors, slices, domain/api clients, and their tests.

data-layer-advanced

Structure a Ledger Wallet data layer where one API response serves several entities. Use when creating or reviewing cross-entity domain/api orchestration with RTK Query, createAsyncThunk, or both, including response validation and tests spanning multiple…

structure-flow

Place and organize Ledger Wallet code in the monorepo layers. Use when creating, moving, or reviewing code under apps, features, domain, shared, or support; deciding which layer owns a concern; structuring packages and flow steps; or checking package names,…

types-state-mocks

Structure a simple Ledger Wallet data layer where one API response maps to one entity slice. Use when creating or reviewing domain/entity schemas, inferred types, initial state, mocks, selectors, slices, domain/api clients, and their tests.

configuration

Pick the home for a configuration value — environment variable, backend URL, partner key, public token, per-environment constant, build secret — and take an existing one out of `@shared/env` / `@ledgerhq/live-env` (`getEnv`, `setEnv`, `useEnv`,…

run-e2e-ci

Trigger the on-demand E2E / Coin Tester CI workflows (Desktop E2E, Mobile E2E, Coin Tester) on a branch and post a PR comment. Use when asked to "run e2e", "trigger e2e on CI", or "run coin testers" for a PR/branch.

card-endpoint-shape

Read this before adding or editing an endpoint in `domain/api/card-management/src/api.ts`, a credential-bearing one included.

comments

Stop writing so many comments. Follow these suggestions instead!

wire-devtool

Wire an existing devtool package into host apps (LLD, LLM, web-tools) and optionally create bindings

device-intent-executor

Device Intent Executor (DIE) and Device Intents reference. Read when working with features/platform/device-intent/, DeviceIntentExecutor / DeviceIntentExecutorLWM, Intent definitions (IntentDefinition, IntentPlatformDefinition, Job, createIntent),…

gh-code-review

Follow these instructions when reviewing PRs

package-public-api

A new-architecture package (shared/, domain/, features/) exposes its API through barrels that contain nothing but `export *`, and keeps its private code in an internals location. Read this when creating a package under shared/, domain/ or features/, when…

errors

How to define and check error classes in Ledger Live. Read when adding a new error, creating an errors.ts file, or checking an error's type.

impacting-prs

Find which open PRs are impacted by a migration/sunset/refactor and notify their authors — blocking review when the old path is already gone from develop, heads-up comment when it is only deprecated or its removal is still in review, silent study report only…

cloud-sync-module

Write, review or debug a `cloudSyncModule.ts` — a `CloudSyncDataManager` that syncs one slice of user data through Ledger Sync (Cloud Sync). Covers the contract, its invariants, the mandatory contract test, the wiring checklist and the data-loss traps. Use…

create-pr

Create a pull request with a valid title, description, changeset, and all required elements

git-conventions

Read for naming branches, commit messages, pull request titles and merge commits

rtk-query-api

RTK Query createApi best practices

devtools-import-boundary

Enforce import boundaries inside the devtools scope. Use for any work in "devtools/**".

batch-feature-dev

Handle batches of Jira tickets through shared analysis, per-ticket feature-dev, Lumen UI guardrails, changesets, and draft PRs. Use when the user provides multiple Jira tickets or asks to deliver tickets one by one with PRs.

remove-feature-flag

Remove a Ledger Wallet feature flag while preserving its resolved production behavior, then validate, create a draft PR, and watch CI to green. Invoke only through /remove-feature-flag; this command may stash local work, push a new branch, create or update…

client-ids

Privacy-protected ID management with @domain/entity-client-identity — DeviceId, UserId, DatadogId, export-rules.json

console-log

Convention for console logging levels across the monorepo.