Skip to content

Troubleshooting guide#811

Merged
leofelix077 merged 9 commits intolf-add-freighter-mobile-best-practices-skillfrom
lf-troubleshooting-guide
Apr 29, 2026
Merged

Troubleshooting guide#811
leofelix077 merged 9 commits intolf-add-freighter-mobile-best-practices-skillfrom
lf-troubleshooting-guide

Conversation

@leofelix077
Copy link
Copy Markdown
Collaborator

No description provided.

…ry issues

Android Studio sometimes doesn't apply RAM changes to existing AVDs reliably;
recreating the emulator is the definitive fix.
Copilot AI review requested due to automatic review settings April 9, 2026 21:01
@leofelix077 leofelix077 self-assigned this Apr 9, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a centralized troubleshooting reference for common Freighter Mobile dev environment, build, testing, and dependency issues, and links it from the contributor/agent entry-point doc.

Changes:

  • Introduce docs/troubleshooting-guide.md with setup/build/test/dependency troubleshooting steps and known gotchas.
  • Add a “Troubleshooting” row in AGENTS.md to surface the new guide alongside other best-practices entry points.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File Description
docs/troubleshooting-guide.md New troubleshooting guide covering common local dev, CI, and dependency issues.
AGENTS.md Adds a pointer to the troubleshooting guide in the “Best Practices Entry Points” table.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/troubleshooting-guide.md Outdated
Comment thread docs/troubleshooting-guide.md Outdated
Comment thread docs/troubleshooting-guide.md Outdated
Comment thread docs/troubleshooting-guide.md Outdated
@leofelix077 leofelix077 requested a review from CassioMG April 17, 2026 13:18
Comment thread docs/troubleshooting-guide.md Outdated
Comment thread docs/troubleshooting-guide.md Outdated
Comment thread docs/troubleshooting-guide.md Outdated
Comment thread docs/troubleshooting-guide.md
Comment thread docs/troubleshooting-guide.md
Comment thread docs/troubleshooting-guide.md Outdated
Copy link
Copy Markdown
Contributor

@CassioMG CassioMG left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review of PR #811 (Troubleshooting guide). One finding worth flagging — the rest of the guide is well-researched and accurate (verified yarn scripts, file paths, Husky version, Gemfile gems, metro.config claims, and pod-install bundle exec usage all check out).

Comment thread AGENTS.md Outdated
Copy link
Copy Markdown
Contributor

@CassioMG CassioMG left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lgtm - left a couple comments

@leofelix077 leofelix077 merged commit fa6a3a2 into lf-add-freighter-mobile-best-practices-skill Apr 29, 2026
2 checks passed
@leofelix077 leofelix077 deleted the lf-troubleshooting-guide branch April 29, 2026 18:18
leofelix077 added a commit that referenced this pull request May 5, 2026
* add v1 of freighter mobile best practices skill

* adjust styling and comments from copilot reviee

* Adjust code review and update agentic files best practices

* Unify duplicate agent instruction files

Rewrite AGENTS.md as the single AI agent entry point:
- Add glossary section with domain-specific terminology
- Add documentation link index (replaces llms.txt)
- Remove sections that duplicate best-practices reference files
  (code style details, branch conventions, PR instructions)
- Keep unique context: repo map, architecture orientation (ducks/nav/WC),
  security alert list, known complexity/gotchas, pre-submission checklist
- Delete llms.txt (content absorbed into AGENTS.md)
- Delete CLAUDE.md (content absorbed into AGENTS.md)

* minor adjustments from copilot code review

* Apply suggestion from @CassioMG

* remove direct mentions of freighter deep links

* update comments from performance.md claude review

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* adjust deep link and install comments from code review

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Apply suggestion from @CassioMG

* cleanup cross-information with extension and hard examples

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix deeplink

* add superpowers suggestions to best practices

* remove mentions of push tokens

* adjust comments from code review and enforce SDS components rule

* clear up code examples and sds components

* Troubleshooting guide (#811)

* fix(troubleshooting): add emulator recreation tip for persistent memory issues

Android Studio sometimes doesn't apply RAM changes to existing AVDs reliably;
recreating the emulator is the definitive fix.

* cleanup runtime information and clipboard not pasting

* Update code review troubleshooting comments

* cleanup references naming

* clean up troubleshooting guide for stable xcode and IDE config

* breakdown commands on troubleshooting guide for better readability

* remove xcode 26 regression issue

* move changes out of skill folder

* adjust code snippets and last update date

---------

Co-authored-by: Cássio Marcos Goulart <3228151+CassioMG@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Copilot <copilot@github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants