🩸👦🏼 Bloodboy

July 9, 2026 · View on GitHub

Track and visualize your blood test results over time with AI-powered data extraction

👉 Try it live at bloodboy.report 👈

Upload your reports, extract biomarkers, and track changes over time — right in your browser.

💎 Core Values

Open Source - Free and open source software under AGPL-3.0
Privacy First - Everything stays on your device
No Subscriptions - Free for personal use, forever
You Own Your Data - Export and backup anytime
Any Biomarkers - Supports extracting and tracking any biomarkers with any units

✨ Features

PDF Upload - Drag & drop blood test PDFs for automatic data extraction
Built-in PDF Viewer - View uploaded documents directly in the app
File Organization - Organize your files and keep them in one place near to extracted values
AI-Powered - OpenAI integration for intelligent biomarker extraction
Unit Converter - Automatic unit conversion
Data Visualization - Interactive charts and trend analysis
Anomaly Detection - Filter biomarkers with strong fluctuations between tests
Local Storage - All data stored locally using IndexedDB
Google Drive Backups - Optional browser-based two-way backup sync with a latest file and dated history
Professional Tables - Sorting, filtering, and inline editing with AG-Grid
Saved Filters - Save and quickly apply custom filter combinations
Modern UI - Clean interface built with AntDesign and Tailwind CSS
Import/Export - Backup and restore your data anytime

🚀 Getting Started

Installation

npm install

Development

npm run dev

Build

npm run build

Scripts

Command	Description
`npm run dev`	Start development server
`npm run build`	Build for production
`npm run preview`	Preview production build
`npm run typecheck`	Run TypeScript type checking
`npm run lint`	Run ESLint
`npm run lint:fix`	Fix ESLint issues

🛠️ Tech Stack

React 19 - UI library
TypeScript 5 - Type safety
Vite 6 - Build tool
Tailwind CSS 3 - Styling
AntDesign 5 - UI components
AG-Grid 32 - Data tables
Dexie - IndexedDB wrapper
OpenAI - PDF parsing

📁 Project Structure

src/
├── components/    # Reusable UI components
├── pages/        # Page components
├── db/           # Database models and services
│   ├── models/   # Data models
│   ├── services/ # Dexie instance
│   └── hooks/    # Database hooks
├── constants/    # App constants
├── types/        # TypeScript types
├── utils/        # Helper functions
├── openai/       # OpenAI integration
└── App.tsx       # Root component

🔧 Configuration

See .env.example for optional environment variables. The app works fully offline without any configuration.

To enable Google Drive backups, create a Google OAuth web client and set VITE_PUBLIC_GOOGLE_CLIENT_ID. Google Drive sync is two-way: newer Drive backups are restored into the browser, and newer local data is uploaded back to Drive. Backups are stored in Google Drive as:

Bloodboy Backups/
├── latest/
│   └── bloodboy_db_backup_latest.json
├── history/
│   └── YYYY/
│       └── MM/
│           └── bloodboy_db_backup_<timestamp>.json
└── bloodboy_backup_manifest.json

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request or open an issue.

📧 Contact

For questions or feedback, reach out at yashugaev@gmail.com

📄 License

Licensed under AGPL-3.0 - free and open source software.

Made with ❤️ and 🩸 for better health tracking