Skip to content

Comprehensive React Native & Expo skills guide#526

Merged
jamespepper81 merged 3 commits into
mainfrom
dev
Jan 28, 2026
Merged

Comprehensive React Native & Expo skills guide#526
jamespepper81 merged 3 commits into
mainfrom
dev

Conversation

@jamespepper81
Copy link
Copy Markdown
Contributor

This pull request introduces a comprehensive React Native & Expo skills guide, including best practices, rule templates, and category definitions for building high-performance mobile apps. It adds detailed documentation, rule structure, and specific performance and optimization rules for React Native and Expo projects.

Major documentation and structure additions:

  • Added a top-level skills README (.github/skills/react-native-skills/README.md) outlining best practices, tech stack, directory structure, rule categories, and instructions for creating new rules.
  • Introduced a skill overview and quick reference file (.github/skills/react-native-skills/SKILL.md) summarizing rule categories, priorities, and usage instructions for the skillset.
  • Added a metadata file (.github/skills/react-native-skills/metadata.json) describing the guide's version, organization, abstract, and references.

Rule system and templates:

  • Defined all rule sections, their ordering, impact levels, and descriptions in _sections.md to standardize rule categorization.
  • Provided a rule template (rules/_template.md) for consistent creation of new best-practice rules, including frontmatter and example structure.

Performance and optimization rule examples:

  • Added detailed rules for animation best practices:
    • Prefer useDerivedValue over useAnimatedReaction for deriving shared values (animation-derived-value.md).
    • Use GestureDetector for animated press states instead of Pressable (animation-gesture-detector-press.md).
    • Animate only GPU-accelerated properties like transform and opacity (animation-gpu-properties.md).
  • Added a rule for loading fonts natively at build time using Expo config plugins (fonts-config-plugin.md).
  • Added a JavaScript optimization rule for hoisting Intl formatter creation (js-hoist-intl.md).
  • Added a list performance rule for hoisting callbacks to the root of lists (list-performance-callbacks.md).

jamespepper81 and others added 3 commits January 28, 2026 09:01
Introduces a comprehensive performance and best practices guide for React Native, targeting AI agents and LLMs. The guide covers 35+ rules across rendering, list performance, animation, navigation, state management, UI, and more, with detailed explanations and code examples for each rule.
- Remove monorepo rules (not applicable to single app)
- Remove design-system compound components (over-engineering)
- Remove imports-design-system-folder (not needed)
- Remove ui-image-gallery (Galeria not used)
- Update navigation rules to focus on Expo Router
- Update styling rules to include NativeWind patterns
- Update SKILL.md, README.md, metadata.json for v2.0.0
- Recompile AGENTS.md with 25+ rules across 11 categories

https://claude.ai/code/session_017tt4qNH9acAqYDyyNGbCwu
…kills-gcMxT

Refactor React Native skills: consolidate to Expo-focused best practices
@jamespepper81 jamespepper81 merged commit d03b004 into main Jan 28, 2026
13 checks passed
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.

2 participants