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.

跳到安装

仓库: stellar/freighter
最近来源活动: 2026年5月6日 16:10
检测到的 SKILL.md 语言: 英语
星标: 116
分支: 57

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

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

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

文件资源管理器

12 个文件

SKILL.md

来源说明 · 只读预览

返回搜索返回安装

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