AGENT SKILL

troubleshoot

Known bugs, quirks, and their fixes discovered during development

License 许可
MIT
最近更新
2026-09-26
Stars
★ 0
Forks
0

01 前言 Front Matter

name
troubleshoot
license
MIT
version
1.0.0
description
Known bugs, quirks, and their fixes discovered during development

03 SKILL.md 正文

Use this skill when debugging issues that may have known solutions. Check here before investigating from scratch.

React Native + @expo/ui

Nested Pressable + native SwiftUI Menu

When a Pressable from react-native wraps a native SwiftUI Menu (@expo/ui/swift-ui), tapping the menu fires both the native menu and the outer onPress. stopPropagation() does not work because the native SwiftUI touch handling bypasses React Native's event system.

Fix: Import Pressable from react-native-gesture-handler instead of react-native for the outer pressable. The RNGH version properly blocks event propagation to parent handlers when a child native view handles the touch.

// Before (broken — both handlers fire)
import { Pressable } from "react-native";

<Pressable onPress={() => navigate()}>
  <Menu label={<RNHostView>...</RNHostView>}>
    ...
  </Menu>
</Pressable>

// After (works — only menu opens)
import { Pressable } from "react-native-gesture-handler";

<Pressable onPress={() => navigate()}>
  <Menu label={<RNHostView>...</RNHostView>}>
    ...
  </Menu>
</Pressable>

Reference: app/(tabs)/saved/my-sessions.tsx — list item with three-dot dropdown menu.

04 同仓库更多 Skills

jestsee
jestsee/opencode-config

widget-custom-fonts

Bundle custom fonts into iOS widget extensions (expo-widgets) — expo-font only covers the main app target, not the widget extension

★ 0
jestsee
jestsee/opencode-config

set-app-identity

Sweep every file that carries app identity (name, bundle id, scheme, URLs, emails, entitlement IDs, DB filename, EAS project, theme colors) and update them in one consistent pass when renaming/rebranding an expo-starter project. Use when the user says 'rename the app', 'rebrand', 'change app identity', 'update bundle id', 'set up identity for a new project', 'customize the template', or otherwise needs to replace the placeholder identity shipped with expo-starter. Covers app.config.ts BASE_* constants, package.json name, constants/index WEB_URL, lib/mail SUPPORT_EMAIL, constants/revenuecat ENTITLEMENT_ID, db/app/index DB filename, maestro appId, paywall plan names, tailwind theme colors, and EAS project config.

★ 0
jestsee
jestsee/opencode-config

react-native-best-practices

Software Mansion's best practices for production React Native and Expo apps on the New Architecture. MUST USE before writing, reviewing, or debugging ANY code in a React Native or Expo project. If the working directory contains a package.json with react-native, expo, or expo-router as a dependency, this skill applies. Trigger on: any code task in a React Native/Expo project, 'React Native', 'Expo', 'New Architecture', 'Reanimated', 'Gesture Handler', 'react-native-svg', 'ExecuTorch', 'react-native-audio-api', 'react-native-enriched', 'Worklet', 'Fabric', 'TurboModule', 'WebGPU', 'react-native-wgpu', 'TypeGPU', 'GPU shader', 'WGSL', 'svg', 'animation', 'gesture', 'audio', 'rich text', 'AI model', 'multithreading', 'chart', 'vector', 'image filter', 'shared value', 'useSharedValue', 'runOnJS', 'scheduleOnRN', 'thread', 'worklet', 'Bundle Mode', or any question involving UI, graphics, native modules, or React Native threading and animation behavior. Also use when a more specific sub-skill matches.

★ 0
jestsee
jestsee/opencode-config

motion-design

Applies motion design principles to create emotionally-driven, technically sound animations and transitions. Provides timing, easing, choreography, and Disney animation principles adapted for UI. Use when creating animations, transitions, micro-interactions, loading states, page transitions, scroll-triggered effects, or any motion work. Works with CSS, Framer Motion, GSAP, Lottie, Spring, or any animation system.

★ 0
jestsee
jestsee/opencode-config

expo-web-to-native

Framework (OSS). Migrate an existing web React app to a native iOS/Android app with Expo. Use when the user wants to turn a website into a mobile app, port a Next.js/Vite/CRA React codebase to React Native, reuse web code on native incrementally, or asks how web idioms (the DOM, CSS, React Router, localStorage, window) map to native. This is the end-to-end migration guide; use the `expo-dom` skill for the DOM-component mechanism itself.

★ 0
jestsee
jestsee/opencode-config

expo-upgrade

Framework (OSS). Guidelines for upgrading Expo SDK versions and fixing dependency issues

★ 0