Bloodwork Tracker User Guide

Signing In

1. Open health-tracker.project4.net.
2. Enter your approved email address.
3. Select Send code.
4. Enter the 6-digit one-time code from your email.

Codes expire after 10 minutes. Request a fresh code if one expires.

Main Navigation

• Tracker: latest marker cards grouped by category.
• Data: blood-test table, visual range rows, and trend charts.
• Admin: test definitions, default result date, notes, invitations, merge tools, and reset controls.
• API: create API keys and review access logs.

Finding Markers

Use the Find marker strip to avoid long scrolling. You can search by test, group, unit, status, or latest value, then filter by group or status and jump directly to a marker.

Adding Or Editing Results

1. Go to Tracker.
2. Select Add result on a marker, or Edit beside a history row.
3. Enter the value and date in YYYY-MM-DD format.
4. Save the result.

If a result already exists for the same marker and date, the app asks before replacing it.

Understanding Status Colors

• Green: in range.
• Red: above range.
• Purple: below range.
• Neutral/warning: no result or incomplete reference range.

Admin Tasks

• Set a default result date before entering several results from the same visit.
• Create and edit blood tests with units and reference ranges.
• Choose an existing group from suggestions or type a new group. Matching is case-insensitive to avoid duplicate groups.
• Add clinical notes for context in the AI export.
• Merge duplicate tests when needed.

Exporting Data

• Export: downloads the app's standard JSON data file.
• AI export: opens a modal with a structured JSON preview, copy button, and download button.
• API: create API keys for external integrations.

API Keys

Create API keys from the API page. New keys are shown once, so copy them immediately. Revoke keys you no longer use.

See the API documentation for endpoint details.