freighter-best-practices

Comprehensive best practices for the Freighter browser extension. Covers code style, architecture, security, testing, performance, error handling, i18n, messaging, git workflow, dependencies, and anti-patterns. Use when writing new features, reviewing PRs, adding message handlers, working with Redux, modifying content scripts, handling keys, building transactions, or any development work in the freighter extension repo. Triggers on any task touching the freighter codebase.

Ir para a instalação

Repositório: stellar/freighter
Última atividade na origem: 6 de maio de 2026 às 16:10
Idioma detectado do SKILL.md: inglês
Estrelas: 116
Forks: 57

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/stellar/freighter --skill freighter-best-practices

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

Explorador de arquivos

12 arquivos

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

Freighter Best Practices

Freighter is a non-custodial Stellar wallet shipped as a browser extension (Manifest V3) for Chrome and Firefox. The repository is a Yarn workspaces monorepo with four main workspaces:

extension/ -- the browser extension itself (popup, background service worker, content scripts)

@stellar/freighter-api/ -- the npm SDK that dApps use to interact with Freighter

@shared/ -- shared packages (api, constants, helpers) consumed by multiple workspaces

docs/ -- documentation and skills

Reference Guide

Concern

File

When to Read

Code Style

references/code-style.md

Writing or reviewing any code

Architecture

references/architecture.md

Adding features, understanding the codebase

Security

references/security.md

Touching keys, messages, storage, or dApp interactions

Testing

references/testing.md

Writing or fixing tests

Performance

references/performance.md

Optimizing renders, bundle size, or load times

Error Handling

references/error-handling.md

Adding error states, catch blocks, or user-facing errors

Internationalization

references/i18n.md

Adding or modifying user-facing strings

Messaging

references/messaging.md

Adding popup<>background<>content script communication

Git & PR Workflow

references/git-workflow.md

Branching, committing, opening PRs, CI

Dependencies

references/dependencies.md

Adding, updating, or auditing packages

Anti-Patterns

references/anti-patterns.md

Code review, avoiding common mistakes

Troubleshooting

../../docs/troubleshooting-guide.md

Build failures, setup issues, known bugs and gotchas