Repository navigation
Description
DESIGN DOC ➡️
Slack Room: #migrate
- WhatsNext post
- Predesign: merge images on client or backend
- Predesign: Partial odometer expenses
- Design Doc: Go to market review
- Figma design
Implementation issues:
Main Flow Phase 1: Add Odometer expense type
- [Odometer] Update CreateDistanceRequest command for Odometer #77099
- [Odometer] Modify UpdateMoneyRequestDistance command for Odometer #78383
- [Odometer] Create NewDot Odometer expense flow #77191
- [Due for payment 2026-03-13] [Odometer] Build Odometer expense image capture flow #77266
- [Odometer] Build Odometer merged image flow #77267
- [Odometer] Create manual test cases for Odometer phase 1 #77292
- https://github.com/Expensify/Expensify/issues/571644 [phase 1]
- Show the feature without need for beta
Bugs/Improvements:
- Phase 1 blockers
- Odometer - Unexpected error when submit expense with image #85405
- Odometer - Photo is not cropped after saving cropped photo #85365
- [Due for payment 2026-04-14] Odometer - Removed photo is shown on confirm page when it is removed from Distance page #85368
- Odometer image previews infinitely loading #86152
- [Odometer] [$250] Capture an image in Odometer user is redirected back to Inbox #83526
- Odometer - Image preview - Blank page opens when tap on upload start odometer photo #82327
- [Odometer] [$250] Odometer distance page shows wrong amount after changing distance unit #82650
- [Due for payment 2026-02-24] [Odometer] Refactor IOURequestStepDistanceOdometer to use handleMoneyRequestStepDistanceNavigation #81727
- https://github.com/Expensify/Expensify/issues/608481
- https://github.com/Expensify/Expensify/issues/608482
- [Odometer] Fix trackExpense to persist odometer readings for selfDM tracked expenses #81728
- [Due for payment 2026-01-27] [Odometer] Verify optimistic data is correct when offline #78961
- [Due for payment 2026-01-27] [Odometer] Distance expense category removed on 2nd policy switch #79598
- [Odometer] Remove Odometer expense splitting #82157
- [Odometer] [$250] Distance - Odometer - Next button is hidden behind the keyboard #82647
- Distance - Discard changes modal opens after creating Odometer expense #84218
- Phase 1 non-blockers
- [Odometer] Reloading app during creation flow with preview open lands on not-found page #81901
- [$125] Expense - Loading indefinitely when no description is saved. #76326
- [Due for payment 2026-05-07] [Odometer] Improvement to DiscardChangesConfirmation usage #79502
- [Due for payment 2026-03-30] Odometer - User can input any character in the Odometer input field #84220
- Move odometer image stitching to confirmation page #84998
- Improve camera capture performance (see this)
- [Due for payment 2026-04-14] Expense - Odometer photo is closed immediately after clicking rotate #86355
- [HOLD] [Odometer] Fix state restoration after App reload when image preview is open #82407
- Create unit test for
isOdometerDistanceRequesttransaction - [$250] [Due for payment 2026-04-14] [Odometer] DRY shared camera logic between IOURequestStepScan and Odometer image capture #83356
- Add custom Sentry spans for odometer distance expenses #87814
Main Flow Release 2: Add 'Save for later' feature
- Add Save for later button to the Odometer expense page
- Add ability for Odometer readings and image data to be saved to device storage
- Modify Odometer expense tab to detect and retrieve draft expense data
- Create test cases and update Help Doc pages regarding the Save for later feature
- Announce the feature in the next product announcement video
Bugs/Improvements:
- Phase 2 blockers
- Phase 2 non-blockers
- [Odometer] Enable Split on Odometer expenses #83232
- [Odometer] Add save for later functionality #87726
- https://github.com/Expensify/Expensify/issues/625486
- [Due for payment 2026-05-18] [Odometer] Edited start reading not reflected on Odometer tab after returning from confirmation page #89633
- [Due for payment 2026-07-08] [Odometer] Show discard changes modal when switching tabs with unsaved values #89940
- [Due for payment 2026-03-23] Distance Request tabs - Merge TabSelector and scrollable variant #81338
Related:
Proposal
Add Odometer mileage expenses to NewDot
Background
Expensify is completing the migration from Classic to NewDot. Feature parity is essential for retaining users during this migration, and odometer tracking is one of the few remaining blockers to achieving this. Manual odometer tracking is necessary for users who prefer explicit control over mileage entries rather than automatic GPS tracking, particularly for those who drive frequently for work and need precise records for tax purposes and reimbursement.
Problem
When users track distance expenses via odometer readings in Classic, if they are migrated to NewDot, then they must either manually calculate total distance (losing odometer proof and audit trail) or abandon NewDot to stay in classic or switch to a competing application.
Solution
Introduce odometer mileage as a distance tracking method in NewDot with feature parity to Classic. Users will be able to:
- Select the new Odometer tab in the Track Distance page
- Manually enter start and end mileage readings
- Attach photos of each reading
- View calculated odometer readings and submit as a distance expense
For compatibility and parity, the feature will use the same NVP storage approach (odometerStart, odometerEnd) and validation logic (preventing negative distances, requiring both readings for submission) as Classic.
Tasks
- Post Proposal (full Problem/Solution statement) in
#whatsnext - Wait at least one full business day, and until the post has a majority (2/3) of positive reactions (👍)
- Paste Proposal in the space above with a link to the Slack thread
- Email
strategy@expensify.comand paste in the Proposal - Host a pre-design meeting (example) in an appropriate slack channel to discuss any necessary details in public before filling out the High-level of proposed solution section.
- Fill out the High-level overview of the problem, Timeline, Terminology, and High-level of proposed solution sections of the Design Doc
- Email
strategy@expensify.com(continue the same email chain as before - your last message should be the WN Proposal) with the link to your Design Doc containing your high-level problem and solution - Add the
DesignDocReviewlabel to get the High-level overview of the problem and High-level of proposed solution section reviewed - Respond to any questions or concerns and bring up blockers in Slack to get a consensus if necessary
- Confirm that the doc has the minimum necessary number of reviews before proceeding
- Host another pre-design meeting in the appropriate slack channel to ask for engineering feedback on the technical solution.
- Fill out the Detailed implementation of the solution and related sections.
- Re-add the
DesignDocReviewlabel to this issue - Respond to any questions or concerns and bring up blockers in Slack to get consensus if necessary
- Confirm that the doc has the minimum necessary number of reviews before proceeding
- Email
strategy@expensify.comone last time to let them know the Design Doc is moving into the implementation phase - Implement the changes
- Add regression tests so that QA can test your feature with every deploy (instructions)
- Confirm any related help site updates have been published
- Send out a follow up email to
strategy@expensify.comonce everything has been implemented and do a Project Wrap-Up retrospective that provides:- Summary of what we accomplished with this project
- What went well?
- What could we have done better?
- What did we learn?
Metadata
Metadata
Labels
Type
Projects
- StatusShow more project fieldsDone
Activity
melvin-bot commentedon Oct 14, 2025
Triggered auto assignment to @VictoriaExpensify (
NewFeature), see https://stackoverflowteams.com/c/expensify/questions/14418#:~:text=BugZero%20process%20steps%20for%20feature%20requests for more details. Please add this Feature request to a GH project, as outlined in the SO. Remember to draft any necessary HelpDot updates by following the instructions here.melvin-bot commentedon Oct 14, 2025
melvin-bot commentedon Oct 14, 2025
Triggered auto assignment to Design team member for new feature review - @shawnborton (
NewFeature)[-][Placeholder] Add Odometer milage to NewDot[/-][+][Tracking] Add Odometer milage to NewDot[/+]156 remaining items
Julesssss commentedon Apr 21, 2026
The feature is live and in use by customers! Phase 2 PRs are in progress.
Going ooo for surgery and recovery, I'll send the wrap up for phase one once I'm back.
Julesssss commentedon Apr 23, 2026
Next up is image persistence: #87818
Prior PRs merged 🎉
Julesssss commentedon Apr 27, 2026
PR to implement 'Save for Later' and resolve 2 bugs is in draft, nearing review.
Julesssss commentedon May 5, 2026
'Save for Later' feature PR has had some bugs fixed, back in review
Julesssss commentedon May 5, 2026
Release 2 is essentially complete as the Save for Later feature is merged 🎉 We raised a last bug related to splits
Julesssss commentedon May 7, 2026
Odometer release 2 is live on production. Expense drafts can now be persisted and retrieved.
Julesssss commentedon May 8, 2026
Remaining tasks:
Julesssss commentedon May 11, 2026
The project is officially complete 🎉 🚗
Julesssss commentedon May 15, 2026
Finishing up issues outside of this tracker.