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 a la instalación

Repositorio: stellar/freighter
Última actividad en el origen: 6 de mayo de 2026 a las 16:10
Idioma detectado de SKILL.md: inglés
Estrellas: 116
Forks: 57

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

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

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos

12 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

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