trezor/trezor-suite

defensive-programming

Type safety practices including exhaustive checks, explicit return types, Result-based error handling, and non-mutating array methods. Use when writing TypeScript logic that handles multiple cases or error conditions, or when sorting, reversing, splicing, or…

原文语言：英语

performance-complexity

Collection-handling performance for Trezor Suite — indexing before iteration, O(1) sort comparators, and reduce accumulators that don't allocate. Use when writing a loop, sort or reduce over accounts, tokens, transactions or UTXOs.

原文语言：英语

performance-dom

Browser rendering performance for Trezor Suite — forced synchronous layout from geometry reads, observer APIs instead of measuring an element, and transitioning only compositor properties. Use when measuring, scrolling or animating a DOM element, or when…

原文语言：英语

performance-react-hooks

React render performance for Trezor Suite — memoization under React Compiler, referentially stable hook dependencies, minimal dependency arrays, and telling a wasted memo from a render loop. Use when adding useMemo, useCallback or memo, when writing a…

原文语言：英语

performance-scheduling

Deferring non-essential work with requestIdleCallback. Use when a startup path blocks interaction, or when scheduling analytics, prefetch or other background work.

原文语言：英语

common-tasks

Dependency management, package creation, and troubleshooting commands for the Trezor Suite monorepo. Use when managing dependencies or debugging build issues.

原文语言：英语

redux

Redux Toolkit patterns including slices, selectors, thunks, and middleware conventions for Trezor Suite. Use when writing or reviewing Redux state management code.

原文语言：英语

comments

Comment conventions for Trezor Suite — prefer self-documenting code, and how to write and format a comment when one is actually needed. Use when writing or reviewing code comments.

原文语言：英语

tests-common

TDD practices and test utilities for suite-common packages, including Red-Green-Refactor workflow and @suite-common/test-utils usage. Use when writing tests for suite-common packages.

原文语言：英语

tests

Test style guidelines including naming conventions, mock organization, translation handling, and file structure. Use when writing or organizing tests in the Trezor Suite codebase.

原文语言：英语

publish-config

publishConfig rules for public npm packages in the Trezor Suite monorepo. Use when adding or editing publishConfig, exports, or preparing a package for npm publishing.

原文语言：英语

dependency-injection

Dependency Injection pattern for service definitions, factories, and composition roots. Use when working with packages that use the DI pattern.

原文语言：英语

common-issues

Known issues and their solutions in the Trezor Suite monorepo. Use when encountering build failures, test failures, or environment problems.

原文语言：英语

development-commands

Commands for running apps, linting, testing, and building in the Trezor Suite monorepo. Use when you need to run, build, or check code quality.

原文语言：英语

components

React component file structure and patterns for Trezor Suite. Use when creating or reviewing React components, including prop passing and component organization.

原文语言：英语

packages

How to create and structure packages in the Trezor Suite monorepo, including scopes and sizing guidance. Use when creating new packages or resolving cyclic dependencies.

原文语言：英语

tests-native

Use when writing component or hook tests in suite-native and need to choose between renderWithBasicProvider, renderWithStoreProvider, or store helpers like createStoreFromPreloadedState, createLightStore, or mergePreloadedState.

原文语言：英语

security-headers

Generated code must be aligned with security headers (e.g. no unsave JS eval). The permissions policy is especially relevant when changing any code related with the `navigator` object.

原文语言：英语

trezor-mcp

Trigger on any mention of Trezor wallet interaction, crypto addresses, sending crypto, checking balances, signing messages, or hardware wallet operations via MCP. Also trigger when users mention configuring or troubleshooting the Trezor MCP server connection.

原文语言：英语

idb-migrations

How to create and implement IndexedDB storage migrations in the Trezor Suite web app. Use when writing migrations that transform persisted data between Suite versions.

原文语言：英语

basic-syntax

If-else formatting, spacing, function parameters, and conditional rendering rules for the Trezor Suite codebase. Use when writing or reviewing TypeScript/React code.

原文语言：英语

git-and-commit-guidelines

Conventional Commits format, commit types, scopes, and PR best practices for Trezor Suite. Use when committing code or creating pull requests.

原文语言：英语

import-export

Named export conventions and barrel file usage rules for the Trezor Suite codebase. Use when writing imports, exports, or deciding on module structure.

原文语言：英语

naming

Naming conventions for variables, functions, booleans, components, and domain-specific terms in Trezor Suite. Use when naming anything in the codebase.

原文语言：英语

project-structure

Overview of the Trezor Suite monorepo structure and key directories. Use when navigating the codebase or deciding where to place new code.

原文语言：英语

setup-requirements

Prerequisites and initial environment setup for the Trezor Suite monorepo, including Node.js, Yarn, Git LFS, and submodules. Use when setting up or troubleshooting the development environment.

原文语言：英语

skills-and-code-style-contribution

How to contribute to the Trezor Suite code style guide, including issue proposals and pull request workflows. Use when proposing code style changes.

原文语言：英语

tests-commands

Commands for running unit tests in the Trezor Suite monorepo. Use when you need to run tests for specific packages or the entire project.

原文语言：英语

typescript

TypeScript-specific conventions including ts-expect-error usage, unknown vs any, const assertions, and type vs interface preferences. Use when writing TypeScript code.

原文语言：英语