Tester Manual

Beta v1.0 Windows Only · Updated May 2026

Welcome to the TruckOmeter beta program. This manual covers setup, core features, and what we specifically need testers to evaluate. If you find a bug, use the Bug Report page.

Installation Windows

  1. Open the Microsoft Store on your Windows PC.
  2. Search for TruckOmeter or use the direct link provided by your program contact.
  3. Click Get and wait for the download to complete.
  4. Launch TruckOmeter from the Start menu or taskbar.
⚠ Beta Notice

This is a beta release. You may encounter bugs. Your data is stored locally on your device. Use the backup feature (Settings → Backup) after each session to protect your entries.

First Run

On first launch, TruckOmeter will:

  1. Ask you to sign in or create a free account. Use your real email — it's how you receive beta communications.
  2. Walk you through the Minimal Setup wizard: enter your company name, add at least one truck and trailer.
  3. Download the community site database (~2,300+ truck stops, warehouses, and delivery sites). This takes 20–30 seconds on a good connection. Do not close the app during sync.
  4. Land on the main dashboard.

Truck & Trailer Setup

Go to Settings → Fleet to add or edit trucks and trailers.

Truck Fields

  • Unit Number — your internal fleet number (e.g. T-01)
  • Year / Make / Model — for display and odometer tracking
  • VIN — optional but useful for maintenance records
  • Odometer — enter your current reading at setup
✓ Tip

Accurate odometer entry at setup is important. TruckOmeter estimates mileage between loads; if your starting odometer is wrong, the estimates will drift.

Community Site Sync

TruckOmeter maintains a shared database of locations — truck stops, warehouses, distribution centers, fuel stations — contributed by the user community.

  • First install: full download (~2,300 sites) runs automatically during setup.
  • Returning logins: a silent delta sync runs in the background, pulling only new or changed sites.
  • New site entry: when you type a ZIP code in a location field, the app checks Firestore for sites at that ZIP before prompting you to create a new one.
ℹ About Site Data

When you save a new site, it is automatically shared to the community database so other drivers benefit. Sites are validated before sharing — address, coordinates, and state are required.

Loads

Loads are the core of TruckOmeter. Every load tracks:

  • Pickup and delivery locations (with scheduled times)
  • Freight rate (flat or per-mile)
  • Loaded miles and empty miles
  • Fuel consumed en route
  • Detention time at each stop

Adding a Load

  1. Tap + New Load from the Loads screen.
  2. Enter pickup location — start typing a city, ZIP, or site name. The app will suggest from the community database.
  3. Add delivery location(s). You can have multiple stops.
  4. Enter rate, truck assignment, and scheduled date/times.
  5. Save. The load appears as Active until you mark it delivered.
⚠ Tester Note

Please test loads with multiple delivery stops. The route calculation system was recently rewritten to handle segment-by-segment routing. Report any mileage discrepancies.

Fuel

Track every diesel fill-up to:

  • Calculate real MPG per trip and over time
  • Feed IFTA state tax calculations
  • Analyze fuel cost as a percentage of revenue per load

Fuel Entry Fields

  • Date & Location — select the truck stop from the site database
  • Gallons — total gallons pumped
  • Price per gallon
  • Odometer at fill-up
  • State — auto-populated from location; critical for IFTA
✓ Tip — Saddle Tanks

If your truck has saddle tanks, they may not fill to the same level simultaneously. Log each pump transaction separately to get accurate per-gallon data.

Expenses

Log any business expense: tires, tolls, lumper fees, truck washes, permits, etc. Expenses can be assigned to a specific load (affecting that load's ROI) or marked as general operating expenses (affecting the monthly P&L).

Drivers & Pay

ℹ Design Note

Driver pay always appears as a cost — even if you are the driver. This is intentional. Seeing your own labor as a cost builds accurate financial habits and prevents underpricing loads. There is no toggle to hide this.

Driver pay can be set as:

  • Cents per mile (loaded miles only, or all miles)
  • Percentage of gross load rate
  • Flat amount per load

Pay stubs are generated per driver per pay period and can be exported as PDF.

Maintenance

Log service records per truck or trailer:

  • Oil changes, tire rotations, brake jobs, DOT inspections
  • Parts and labor cost (feeds expense reports)
  • Odometer at service (triggers interval reminders)

IFTA Report

TruckOmeter generates IFTA quarterly reports from your load and fuel data. The report breaks down:

  • Miles driven in each IFTA jurisdiction
  • Gallons purchased in each state (from fuel entries)
  • Tax owed or credit due per state
⚠ Accuracy Requirement

IFTA calculations depend on accurate state tax rates and per-state mileage. Always verify state fuel tax rates in the Settings before generating your quarterly report. TruckOmeter syncs reference tax rates from the cloud but rates change — confirm with your state's IFTA reporting authority before filing.

ROI / Monthly P&L

The ROI dashboard shows your real net income after:

  • Fuel cost
  • Driver pay
  • Maintenance and expenses
  • Fixed costs (insurance, payments — enter in Settings → Fixed Expenses)

View per-load ROI or monthly totals. Use this to evaluate which load types and lanes are actually profitable vs. which ones just look good on paper.

Detention Time Report (DTR)

The DTR summarizes all detention events across a date range — shipper name, hours detained, and estimated detention revenue owed. Use this as documentation when disputing detention fees with brokers or shippers.

Test Account

Your test credentials were provided separately. Use them to:

  • Sign into the app on Windows
  • Create loads, fuel entries, and expenses with realistic data
  • Test the backup and restore flow (Settings → Backup)
⚠ Test Data Notice

Do not enter real personal or financial data into the beta. Use realistic but fictitious load rates, odometer readings, and routes for testing purposes.

What We Need You to Test

Focus your testing on these areas (in priority order):

  1. Load Entry with Multiple Stops — add a load with 2+ pickups and 2+ deliveries. Verify mileage looks reasonable.
  2. Site Search — when adding a load location, search by city and by ZIP. Verify suggestions appear and are correct.
  3. Fuel Entry — log 3–5 fuel entries in different states. Verify state is auto-populated correctly.
  4. IFTA Report — generate an IFTA report for any date range containing your test loads. Check that states and miles look right.
  5. Backup & Restore — use Settings → Backup to save a backup, then Settings → Restore. Verify data is intact after restore.
  6. Odometer Checker — go to Tools → Odometer Checker and review any flagged entries.

Known Issues

  • Odometer Checker accumulation — after advancing past a flagged entry, estimated odometer may jump back. Under investigation.
  • PDF reports — Fuel Analysis, Load Summary, and Maintenance Report pages are locked (coming in a future update).
  • Route recalculation — manually editing a load's miles after the route is calculated may not update the IFTA state split correctly. Workaround: delete and re-enter the load.

Found something not on this list? Submit a bug report →