LedgerHQ/ledger-live

dependency-patches

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

Idioma del texto original: inglés

device-intent-executor

Device Intent Executor (DIE) and Device Intents reference. Read when working with features/platform/device-intent/, DeviceIntentExecutor (package component or the apps' components/DeviceIntentExecutor wrappers), Intent definitions (IntentDefinition,…

Idioma del texto original: inglés

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, or work with Speculos.

Idioma del texto original: inglés

e2e-earn

Check, update, and RUN Earn E2E tests for Ledger Wallet Desktop (Playwright) and Mobile (Detox). Covers the Earn v2 dashboard, the native + redirect staking flows, and the delegate specs (owned by the Earn team). Use to run earn.v2 / delegate locally, adapt…

Idioma del texto original: inglés

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…

Idioma del texto original: inglés

e2e-swap

Write or update Swap E2E tests for Ledger Live Desktop (Playwright) and Mobile (Detox). Use for swap spec updates, provider flows, multi-step approvals, page-object refactors, swap-history checks, KYC/validation banners, and review-driven cleanup.

Idioma del texto original: inglés

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…

Idioma del texto original: inglés

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.

Idioma del texto original: inglés

testing

Write unit and integration tests for Ledger Wallet apps. Use for Jest tests (Desktop/Mobile), MSW handlers and testing best practices. Applies to "*.test.*", "*.spec.*", "**/tests/**", "**/__tests__/**", "**/__integrations__/**", "**/jest-setup*"

Idioma del texto original: inglés

wrap-third-party-libs

Apps do not depend on third-party libraries directly: the lowest valid package owns each one. Read before adding a dependency to apps/*/package.json, importing a new npm package from an app, or bumping a library the apps use.

Idioma del texto original: inglés

analytics

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

Idioma del texto original: inglés

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.

Idioma del texto original: inglés

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.

Idioma del texto original: inglés

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.

Idioma del texto original: inglés

rebuild-to-fix-lib-import-errors

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

Idioma del texto original: inglés

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,…

Idioma del texto original: inglés

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.

Idioma del texto original: inglés

pre-review

Deep code review

Idioma del texto original: inglés

coin-modules

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

Idioma del texto original: inglés

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…

Idioma del texto original: inglés

feature-dev

Guided feature development with codebase understanding and architecture focus

Idioma del texto original: inglés

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…

Idioma del texto original: inglés

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.

Idioma del texto original: inglés

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…

Idioma del texto original: inglés

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,…

Idioma del texto original: inglés

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.

Idioma del texto original: inglés

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`,…

Idioma del texto original: inglés

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.

Idioma del texto original: inglés

card-endpoint-shape

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

Idioma del texto original: inglés

comments

Stop writing so many comments. Follow these suggestions instead!

Idioma del texto original: inglés

wire-devtool

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

Idioma del texto original: inglés

gh-code-review

Follow these instructions when reviewing PRs

Idioma del texto original: inglés

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…

Idioma del texto original: inglés

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.

Idioma del texto original: inglés

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…

Idioma del texto original: inglés

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…

Idioma del texto original: inglés

create-pr

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

Idioma del texto original: inglés

git-conventions

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

Idioma del texto original: inglés

rtk-query-api

RTK Query createApi best practices

Idioma del texto original: inglés

devtools-import-boundary

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

Idioma del texto original: inglés