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.
Datos de origen
- Repositorio
- stellar/freighter
- Última actividad en el origen
- 10 de septiembre de 2026 a las 13:17
- Idioma detectado de SKILL.md
- inglés
- Estrellas
- 118
- Forks
- 60
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.
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 archivosMostrando SKILL.md
SKILL.md
Instrucciones de origen · Vista previa de solo lectura- name
- freighter-best-practices
- description
- 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.
# 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:
1. **extension/** -- the browser extension itself (popup, background service
worker, content scripts)
2. **@stellar/freighter-api/** -- the npm SDK that dApps use to interact with
Freighter
3. **@shared/** -- shared packages (api, constants, helpers) consumed by
multiple workspaces
4. **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 |
Ver en GitHub