Skip to content

Conversation

@m-bert
Copy link
Contributor

@m-bert m-bert commented Jan 8, 2026

Description

This PR handles state management in our docs:

  • Moves information about states to "under the hood" section
  • Rewrites entire states & events page to focus more on callbacks
  • Updates GestureStateManager entry and moves it to fundamentals
  • Merges manual gesture guide with manual gesture docs

Test plan

Read docs 🤓

Base automatically changed from @mbert/docs-detector to next January 27, 2026 14:21
Copilot AI review requested due to automatic review settings January 29, 2026 15:54
Copy link
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

Updates the React Native Gesture Handler documentation to better explain gesture state management by shifting focus from raw states/events to callback-driven lifecycle descriptions, and consolidating manual gesture guidance.

Changes:

  • Reworks state-related docs by moving handler state details under “under the hood” and introducing a new “callbacks & events” fundamentals page.
  • Moves/rewrites GestureStateManager docs into fundamentals and updates references accordingly.
  • Adds interactive callback flow charts (via vis-network) and consolidates the manual gesture guide into the Manual gesture docs page.

Reviewed changes

Copilot reviewed 35 out of 37 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
packages/react-native-gesture-handler/apple/RNGestureHandlerDetector.mm Whitespace cleanup.
packages/docs-gesture-handler/yarn.lock Adds lock entry for new docs dependency.
packages/docs-gesture-handler/src/theme/MDXComponents/Details.js Adjusts summary detection logic for MDX <summary>.
packages/docs-gesture-handler/src/examples/CallbacksFlowCharts/index.ts Exposes new callback flow chart components.
packages/docs-gesture-handler/src/examples/CallbacksFlowCharts/TouchEventChart.jsx Adds touch callback flow chart node/edge data.
packages/docs-gesture-handler/src/examples/CallbacksFlowCharts/GestureEventChart.jsx Adds gesture callback flow chart node/edge data.
packages/docs-gesture-handler/src/examples/CallbacksFlowCharts/FlowChart.jsx Renders charts using vis-network.
packages/docs-gesture-handler/package.json Adds vis-network dependency for charts.
packages/docs-gesture-handler/docs/under-the-hood/state.md Rewrites handler state documentation as a callback-focused table.
packages/docs-gesture-handler/docs/guides/troubleshooting.md Removes troubleshooting section about automatic workletization (now covered elsewhere).
packages/docs-gesture-handler/docs/guides/manual-gestures/index.md Removes the standalone manual gestures guide (content moved/merged).
packages/docs-gesture-handler/docs/guides/manual-gestures/_steps/step7.md Removes old manual-gestures step content.
packages/docs-gesture-handler/docs/guides/manual-gestures/_steps/step6.md Removes old manual-gestures step content.
packages/docs-gesture-handler/docs/guides/manual-gestures/_steps/step5.md Removes old manual-gestures step content.
packages/docs-gesture-handler/docs/guides/manual-gestures/_steps/step4.md Removes old manual-gestures step content.
packages/docs-gesture-handler/docs/guides/manual-gestures/_steps/step3.md Removes old manual-gestures step content.
packages/docs-gesture-handler/docs/gestures/use-tap-gesture.mdx Removes links to removed states/events page; simplifies wording.
packages/docs-gesture-handler/docs/gestures/use-rotation-gesture.mdx Updates activation wording and removes states/events deep links.
packages/docs-gesture-handler/docs/gestures/use-pinch-gesture.mdx Updates activation wording and removes states/events deep links.
packages/docs-gesture-handler/docs/gestures/use-pan-gesture.mdx Removes states/events deep links and updates wording.
packages/docs-gesture-handler/docs/gestures/use-native-gesture.mdx Simplifies state-based phrasing around activation/interruption.
packages/docs-gesture-handler/docs/gestures/use-manual-gesture.mdx Merges manual gesture guide into Manual gesture docs and updates state-manager link.
packages/docs-gesture-handler/docs/gestures/use-long-press-gesture.mdx Removes states/events deep links; simplifies wording.
packages/docs-gesture-handler/docs/gestures/use-fling-gesture.mdx Removes states/events deep links; simplifies wording.
packages/docs-gesture-handler/docs/gestures/state-manager.md Removes old Gesture state manager page (moved to fundamentals).
packages/docs-gesture-handler/docs/gestures/_shared/base-gesture-config.md Rewords state-based config descriptions to callback/behavior language.
packages/docs-gesture-handler/docs/gestures/_shared/base-continuous-gesture-config.md Updates state manager link to new fundamentals location.
packages/docs-gesture-handler/docs/gestures/_manual_gesture_steps/step7.md Adds new manual gesture step snippet for activation/deactivation callbacks.
packages/docs-gesture-handler/docs/gestures/_manual_gesture_steps/step6.md Adds new manual gesture step snippet for onTouchesUp handling.
packages/docs-gesture-handler/docs/gestures/_manual_gesture_steps/step5.md Adds new manual gesture step snippet for onTouchesMove handling.
packages/docs-gesture-handler/docs/gestures/_manual_gesture_steps/step4.md Adds new manual gesture step snippet for onTouchesDown handling.
packages/docs-gesture-handler/docs/gestures/_manual_gesture_steps/step3.md Adds new manual gesture step snippet for wiring up pointers + detector.
packages/docs-gesture-handler/docs/gestures/_manual_gesture_steps/step2.md Refactors the pointer component snippet to typed TS style.
packages/docs-gesture-handler/docs/gestures/_manual_gesture_steps/step1.md Refactors pointer type snippet to TS type.
packages/docs-gesture-handler/docs/fundamentals/states-events.mdx Removes old states & events fundamentals page.
packages/docs-gesture-handler/docs/fundamentals/state-manager.mdx Adds new fundamentals page documenting GestureStateManager.
packages/docs-gesture-handler/docs/fundamentals/callbacks-events.mdx Adds new fundamentals page describing callbacks/events + flow charts.

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Documentation change/enhancement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants