GSoC 2025 Final Report: Navigation Recording, Replay & Snapshot Testing

[Kandarp05]

GSoC'25 Final Report

This is a summary of the work completed during Google Summer of Code 2025, tracked in the Project Board. It highlights the main features delivered, outlines future opportunities, and links each PR for easy reference.

Completed Work

• Serialization Format - Implemented a structured, efficient, and platform-independent serialization format.
• Recording System - Implemented a system to record complete navigation sessions in a platform-independent way.
• Replay System - Added functionality to replay recorded navigation sessions across platforms.
• Implement recording/replay in web-demo - Integrated recording and replay into the web-demo for testing and demonstration.
• Documentation - Guides and details about how to use this new system.

Remaining Work / Future Suggestions

• Snapshot Testing - These recordings can be used for snapshot testing.
• IOS/Android Implementation - Implementation on iOS & Android remains to be done.

All my PR's

• PR #596 - Define initial data models required for navigation recording.
• PR #599 - Define methods that needed for navigation recording.
• PR #605 - Define the Navigator trait and refactor higher levels to use it instead of the concrete NavigationController.
• PR #614 - A small update to NavigationRecording struct.
• PR #619 - Define NavState(a wrapper around TripState) and update core Navigator methods to return it.
• PR #630 - Implement serialization to convert recordings to JSON.
• PR #653 - Define and implement a wrapper around NavigationRecording which provides recording capabilities, and also introduce unit testing for recording.
• PR #662 - Refactor: Separate Navigation Core logic from Map Rendering in Web.
• PR #673 - Define models for replaying navigation, with Web implementation.
• PR #677 - Update Rust docs to reflect new recording and replay features.
• PR #679 - Add play, pause, and other controls for replay in web-demo.

Acknowledgements

Huge thanks to my mentors, Ian Wagner and Jacob Fielding, for their guidance and support throughout the project. This wouldn't have been possible without their help.

[ianthetechie]

Thanks so much for your work on this, Kandarp!