OrderTracker

← horaciovaldes.com

OrderTracker User Guide

OrderTracker is a desktop app for tracking orders locally on your computer.

What You Can Do

• Add and edit orders
• Track status (Ordered, Shipped, Late, Delivered, Cancelled)
• Search and filter orders
• Mark orders as delivered
• Export an invoice PDF
• Add order reminders/events to your calendar

Getting Started

Option 1: Run from source

dotnet build
dotnet run

Option 2: Use a packaged release

Download a zip from the Releases section below, extract it, and run the app.

First Launch

On first launch, the app creates a local SQLite database automatically.

Default database path:

• macOS: ~/Library/Application Support/OrderTracker/orders.db
• Windows: %LOCALAPPDATA%/OrderTracker/orders.db

Main Screen Overview

• Search box: search by order number, item, vendor, or notes
• Status dropdown: filter by status
• Search button: run search
• Delete button: delete selected order (with confirmation)
• Add button: create a new order
• Orders table: your saved orders
• Footer: summary counts and export folder link (auto-hides after 45s)

Add a New Order

1. Click Add.
2. Fill in order details.
3. Click Save.

Notes:

• Order Number is required.
• Duplicate order numbers are blocked.
• Date pickers highlight today.

Edit an Order

1. Select an order.
2. Right-click and choose Edit, or open Open Actions then click Edit Order.
3. Save changes.

Right-Click Menu

Right-click any order row to access:

• Open Actions
• Mark Delivered
• Edit
• Delete
• Export Invoice PDF
• Add to Calendar

Order Actions Window

Double-click a row (or use Open Actions) to open a quick actions window.

From there you can:

• Mark delivered
• Edit the order
• Export PDF
• Add to calendar

Export Invoice PDF

1. Trigger export from context menu or actions window.
2. Choose save location in the file dialog.
3. Save.

After export:

• Main window shows an Open folder hyperlink.
• Actions window also shows an Open folder hyperlink.

Add to Calendar

When you click Add to Calendar, the app creates an .ics file and opens it in your default calendar app.

Event date logic:

• Uses Expected Delivery Date if set
• Otherwise falls back to current date

Keyboard Shortcuts

• Enter in search box: run search
• In Add/Edit dialog:
  • Enter = Save
  • Escape = Cancel

Troubleshooting

Context menu actions are disabled

Click a row first, then right-click it. The app uses selected row actions.

Export folder does not open

• Confirm folder still exists
• Retry export and click the folder link again

Date shows unexpectedly old values

Leave optional dates blank if not known yet. The picker display defaults are set to practical values.

Privacy and Storage

• All data is local to your machine.
• No cloud sync by default.
• No shared database.

Releases

Packaged builds are available in docs/downloads/.

Current release downloads:

• OrderTracker 0.1.1 (Windows x64)