NucMed Dose Lab

Educational radiopharmaceutical dose and decay toolkit for nuclear medicine students.

Overview

NucMed Dose Lab is a public portfolio project that demonstrates educational activity math, physical decay correction, residual activity calculations, and mock documentation workflows used in nuclear medicine training.

The app separates pure TypeScript calculator logic from the UI so formulas can be tested independently. It includes interactive calculators, isotope reference cards, educational example cases, and a mock dose log simulator with local JSON/CSV previews.

All workflows are mock and educational only. The app does not collect PHI, does not store user-entered data, and does not create a clinical record.

Live Demo

Live demo: https://dose.kakushinex.com/

Features

• mCi/MBq conversion
• Decay correction
• Residual/administered activity calculator
• Half-life reference cards
• Mock dose log simulator
• JSON/CSV mock export
• Printable mock report
• Educational example cases
• Unit-tested calculation logic

Educational Safety Boundary

• Educational use only
• Not for direct clinical decision-making
• No PHI
• Does not create a clinical record
• Verify independently
• Follow institutional protocol

Screenshots

Homepage

Example Cases

Conversion Calculator

Decay Calculator

Mock Dose Log

Printable Mock Report

Current Routes

• /
• /examples
• /calculators/conversion
• /calculators/decay
• /calculators/residual
• /calculators/dose-log
• /half-lives

Tech Stack

• Next.js App Router
• TypeScript
• Tailwind CSS
• Vitest

Project Architecture

• UI lives in app/ and components/
• Calculator logic lives in lib/calculators/
• Export helpers live in lib/export/
• Isotope data lives in lib/data/
• Tests live in tests/
• Docs live in docs/

Run Locally

npm install
npm run dev

Run Tests

npm test

Build

npm run build

Example Calculations

• 10 mCi = 370 MBq
• Tc-99m one half-life: 10 mCi decays to about 5 mCi
• Residual example: 10 mCi pre-injection and 0.5 mCi residual equals 9.5 mCi administered

Roadmap

• Additional educational example cases
• Printable report layout refinements
• Optional PDF-style export
• Expanded isotope reference library
• Saved local browser examples without PHI
• Mobile-first UI refinements
• Classroom/demo mode for instructors
• More unit tests for edge cases

License

Copyright © 2026 DevJEscG8. All rights reserved.

This repository is provided for portfolio review, educational demonstration, and technical evaluation only.

You may view the source code, but you may not copy, modify, distribute, sublicense, or use this project or substantial portions of it for commercial purposes without written permission.