suplenet-dosage-calculator

Evidence-based supplement dosage calculator. Returns personalized doses for 8 common supplements based on body weight, gender and fitness goal.

Built and maintained by Suplenet — Colombia's specialist supplement retailer.

Install

npm install suplenet-dosage-calculator

Usage

const { calculate, getSupplements } = require('suplenet-dosage-calculator');

// List all available supplements
console.log(getSupplements());
// ['creatine', 'whey', 'magnesium', 'vitamin_d3', 'zinc', 'omega3', 'caffeine', 'bcaa']

// Calculate a dose
const result = calculate('creatine', 75, 'male', 'muscle');
console.log(result.primary);
// { value: 5, unit: 'g/day', label: 'Maintenance dose' }

console.log(result.timing);
// 'Post-workout (or any time with food)'

console.log(result.notes[0]);
// 'Monohydrate is the most studied and effective form'

console.log(result.refs[0]);
// { text: 'Kreider et al. (2017) — ISSN Position Stand on Creatine', url: 'https://pubmed.ncbi.nlm.nih.gov/28615996/' }

API

calculate(supplementKey, weightKg, gender, goal)

Returns a DoseResult object.

| Parameter | Type | Values | |---|---|---| | supplementKey | string | See table below | | weightKg | number | 30–300 | | gender | string | 'male' | 'female' | | goal | string | 'muscle' | 'loss' | 'health' | 'endurance' |

Returns:

{
  primary:   { value, unit, label },   // Main recommended dose
  secondary: { value, unit, label },   // Secondary dose or null
  timing:    string,                   // When to take it
  notes:     string[],                 // Clinical notes (goal-specific)
  refs:      [{ text, url }]           // PubMed / NIH references
}

getSupplements()

Returns an array of all available supplement keys.

getSupplementInfo(supplementKey)

Returns { name, nameEn, category } for a supplement without calculating a dose.

Supported Supplements

| Key | Name | Category | |---|---|---| | creatine | Creatine Monohydrate | Strength & Power | | whey | Whey Protein | Muscle Mass | | magnesium | Magnesium | General Health | | vitamin_d3 | Vitamin D3 | Immune System | | zinc | Zinc | Immune System | | omega3 | Omega-3 (EPA+DHA) | Cardiovascular Health | | caffeine | Caffeine | Performance | | bcaa | BCAA | Recovery |

Dose Methodology

All calculations are based on peer-reviewed research and institutional guidelines:

• Creatine: Kreider et al. 2017 — ISSN Position Stand
• Whey: Morton et al. 2018 — Protein meta-analysis
• Magnesium: NIH Office of Dietary Supplements
• Vitamin D3: Holick et al. 2011 — Endocrine Society
• Zinc: NIH Office of Dietary Supplements
• Omega-3: Calder 2020 — Inflammatory Processes
• Caffeine: Grgic et al. 2020 — IOC Consensus
• BCAA: Wolfe 2017 — BCAA and muscle protein synthesis

License

MIT © Suplenet