My Truck — User Manual

1. Load # — the number from your dispatch. Optional but recommended; it's your reference on every screen.
2. Trailer # — optional, your reference.
3. Empty miles — miles from where the last load ended to where you hooked up. The drive to pick up your freight.
4. Tap START LOAD. The load goes in flight and the in-flight screen takes over.

Empty miles at start, loaded miles at end — that split is what feeds your empty-miles percentage later.

Gallons Needed = total miles ÷ your MPG goal. Remaining (Needed minus Bought) turns red the moment you're over budget — an early warning, live as you drive. It's a plan, not a verdict: your true MPG lands at EMPTY.

Every fill-up is a fuel stop — gallons only. No prices, no locations. My Truck tracks what burns, not what it costs.

1. Type the gallons in the box (three decimals if you've got them).
2. Tap BUY FUEL.

Stops list in order. Mistyped one? Tap Delete on the stop, then tap again to confirm — two taps so you can't lose a stop by accident.

1. Tap EMPTY and enter your loaded miles — the trip from pickup to delivery.
2. Tap EMPTY again to confirm — same two-tap protection as delete.
3. The load completes with its MPG: (empty + loaded miles) ÷ total gallons.

Load MPG lands in your Stats, your week bucket, and your rolling window. A load you never EMPTY doesn't count anywhere — see the FAQ.

• EDIT LOAD — from any completed load's detail screen. Fix load #, trailer and truck #, empty and loaded miles, notes, and even the completed date if the paperwork says otherwise. Stats and history update to match, everywhere.
• DELETE LOAD — removes the load and its fuel stops for good. Two-tap confirm, no undo — edit instead whenever possible.
• Delete a fuel stop — same two-tap pattern, right on the stop.

• Headline MPG — pooled total miles ÷ total gallons for the period. Never an average of averages.
• Miles — empty + loaded, with the split.
• Per-load table — every completed load with its own MPG and the goal that was in effect when it completed.
• Weekly buckets — Sunday-anchored weeks in your timezone. Your numbers stay put no matter where the truck is when the week flips.
• Utilization denominator — custom ranges show both numbers in the Goal column (e.g. 11,000 of 11,393): your mileage goal is a 28-day target, so a 29-day pull gets 29/28ths of it. Whole calendar months are judged flat against the goal. Dates read US-style and stack From/To — no sideways scroll.
• Rolling 4-week detail — rolling-mode users get a sliding window view: the trailing four buckets that feed Analytics.

SAVE → PDF gives a clean formatted report; SAVE → CSV gives spreadsheet-ready rows. Both cover exactly the period you're viewing — set the period first, then save.

Owner-operators: CSV drops straight into Excel or Google Sheets for your own paperwork and quarterly reviews.

The current quarter, the three before it, and the same quarter last year — your honest year-over-year line. Each quarter shows months M1/M2/M3 with miles, gallons, MPG and Util% (of your mileage goal), plus a pooled TOTAL recomputed fresh from raw loads — never an average of monthlies.

The numbers speak in color, the same language everywhere: green means at or above goal, red means below it, neutral grey means there's nothing to score. A month with a goal but no driving is neutral, not red: no activity isn't a failed goal. MPG scores against your MPG goal — and the goal you set carries forward month to month until you change it, so a great month never goes unjudged. Util% scores against your mileage goal. TOTAL rows carry the same colors as the months.

Sample numbers for illustration. Export: PDF and CSV, same as Stats.

• 4-week scorecard — average MPG, miles, and loads at a glance.
• MPG Trend — recent 28 days vs the 28 before it, over a 12-week sparkline. Rising, falling, or stable — stated plainly.
• Month-End Projection — where your MPG and miles will land if you keep this pace, measured against your goal.
• Weekly Miles vs Goal — the last four closed weeks as bars with hit/miss coloring, a streak counter, and the trend verdict vs the four weeks before. Closed weeks only: the week you're driving doesn't count until it completes Saturday night. A week off the road resets the streak honestly.
• Weekly Breakdown — the last four closed weeks side by side: loads, miles, MPG, empty %. Same weeks, same miles as the goal bars — one weekly language.
• Week Insights — best week, lightest week, and a consistency read: steady, variable, or swingy.
• Empty Miles Analysis — your empty percentage over time. For owner-operators this is negotiation ammo: unpaid miles, quantified.
• Fuel Patterns + Load Stats — fill sizes, total gallons, loads per week, average load distance.

Analytics reads a true trailing 28-day window, refreshed live — except the weekly card, table, and trend lines, which close out full weeks (Sunday through Saturday, your time) so every weekly number on the page agrees.

The 28-day window and Analytics are working data: glance, decide, drive. Nothing there needs a meeting.

• In-flight: Gallons Needed vs Bought. The remaining-gallons number turning red is a live budget warning — it means the plan is burning faster than the pump is keeping up. Ease off early and the load still lands on goal; ignore it and EMPTY tells you what it cost.
• Rolling MPG trend, not single loads. One heavy load or a wind week is weather, not decline. The 28-day trend smooths that out. Three falling weeks in a row is a real signal — tires, idling, routing — worth acting on.
• Weekly miles vs goal: your pace gauge. Behind on miles with days left in the week means push; a long streak with buffer built means the break is earned. A week off the road resets the streak honestly — plan the reset, don't stumble into it.
• Month-End Projection: steer, don't mourn. The projection is today's pace carried to month end. Its job is mid-month course correction — fueling habits, home-time timing — not month-end regret.

The Quarterly wall is the corporate quarterly review moved into the cab: retroactive comparison, horizon planning, and the numbers that line up with profit and loss.

• Miles ≈ volume — revenue follows miles. Gallons ≈ your biggest variable cost. MPG ≈ the efficiency margin between those two lines. Util% ≈ how much of your earning capacity you actually sold.
• Compare quarters, then explain them. Line a strong quarter up against a weak one and ask what differed: lanes, empty-miles percentage, home time, freight mix. The year-over-year line at the top is your honest trajectory — one quarter is noise, two moving the same direction is a trend.
• Read it after the fact. The current month is still being written; its colors firm up as it closes. The wall tells you where the business stands — steering belongs to the cockpit.
• Plan the next quarter from evidence. A quarter above target proves the target is reachable; two in a row means it's time to raise it. Util% consistently under 100% with miles you wanted but didn't run is capacity discussion material.

• Pooled, never averaged. Headline MPG is always total miles ÷ total gallons for the period. Three light 8.0 loads and one heavy 6.0 don't average to 7.5 — they pool to one honest number that admits the heavy load happened.
• Whole periods, no proration. Change a goal mid-month and the month flips whole: a month is scored by the goal it ended under, and weeks work the same way — the week a change lands in flips to it. The last goal standing wins the period. Simple to audit, nothing split into fractions.
• Two grains, two truths. The weekly bucket answers "what was I driving under that week"; the calendar month answers "which goal did the month belong to." When a goal lands in the last week of a month, the week flips but the month keeps the goal it ended under — both are right, they're answering different questions.
• Neutral means nothing to score. A month with a goal but no driving reads neutral, not red — no activity isn't a failed goal. Dashes are the app declining to lie to you.
• Edits recompute everywhere. Fix a load's miles and every downstream number rebuilds from raw miles and gallons — Stats, trends, quarters, all of it. Numbers never drift; they recompute.
• Your clock, not the server's. Weeks and months flip in the timezone you set in Profile — where you run, not where the app lives. Set it to your running territory and the boundaries stay put.

Set in Profile (e.g. 7.200). It drives your in-flight gallon budget and your goal-hit history. Every completed load is judged against the goal that was in effect when it completed — change the goal mid-period and past loads keep their original verdict. History stays honest.

Monthly tracking: your monthly mileage goal (e.g. 10,000 mi/month). Feeds Utilization % in Stats and Quarterly, and the weekly bars in Analytics — weekly comparisons use your monthly target ÷ 4.

Rolling 4-week tracking: your 28-day mileage target (e.g. 11,000 mi). Partial windows — like your rolling 28 days — spread the target by the day across exactly the days the window covers. Full calendar months (Quarterly and year-to-date views) compare flat against the target: finish a month above target and it reads above 100%.

Company posts the new goal a few days into the month? In Profile, set the goal and pick the date it should have taken effect — the 1st of the month. The app writes it from that date forward and clears anything newer, so every load in between is scored against the goal that was truly in effect. Owner-operators use the same field the same way: when the truck's baseline changes (tuning, gearing, trailer config), anchor the new goal to the day reality changed.

Mid-month changes follow one simple rule: the month is scored by the goal it ended under. Change the goal on the 15th and the whole month flips to the new number — no proration, matching how weekly views score the whole week a change lands in. The last goal standing in a month wins it.

Your recent goal changes are listed right under the date field in Profile — a late entry is a visible fact, not a mystery.

• Display name, Driver ID, truck make/model/number — what shows on your reports.
• Timezone — where your weeks flip. Set it to where you run.
• MPG goal + mileage target — the two numbers from section 6.
• Plan — your tier, renewal date, and upgrade door. Upgrading runs through secure Paddle checkout (monthly or annual); switching down to Diesel is self-serve anytime.
• Account off-ramps — switch to Diesel (free, keeps your data) or deactivate (1 year to change your mind, then permanent deletion).

This manual lives here too — the User Manual button on the Profile screen brings you right back.

Run My Truck like a real app — full screen, own icon, no App Store.

Tickets — bottom nav → Tickets → + New Ticket. Say what happened and what you expected; replies land right there, typically within 24 hours. One open ticket at a time, and your email needs to be verified first.

Before writing a ticket, skim this manual — most answers live in sections 2, 3, and 10. A ticket with your load # and what you expected vs. what you saw gets resolved fastest.