Conversation
…re.mdx Co-authored-by: Jakub Piasecki <jakub.piasecki@swmansion.com>
Co-authored-by: Jakub Piasecki <jakub.piasecki@swmansion.com>
…on/react-native-gesture-handler into @mbert/docs-state-manager
…eractions.mdx Co-authored-by: Jakub Piasecki <jakub.piasecki@swmansion.com>
…eractions.mdx Co-authored-by: Jakub Piasecki <jakub.piasecki@swmansion.com>
Contributor
There was a problem hiding this comment.
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
GestureStateManagerdocs 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.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
j-piasecki
approved these changes
Jan 30, 2026
akwasniewski
approved these changes
Jan 30, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
This PR handles state management in our docs:
GestureStateManagerentry and moves it to fundamentalsTest plan
Read docs 🤓