The Peptide Research Atlas is a single-page reference tool for building, tracking, and managing peptide research protocols. It covers 90+ peptides across 13 categories with dose calculators, scheduling, inventory management, and progress tracking.

First-Time Workflow

1. Enter subject info — Fill in age, sex, height, and weight in the Protocol Builder. BMI is auto-calculated.
2. Select peptides — Browse the Peptide Library tab or check peptides directly in the Protocol Builder. Use search or filter by category.
3. Configure doses — Each selected peptide reveals a configuration panel with dose, frequency, and duration options.
4. Generate protocol — Click "Generate Protocol" to produce a full calendar schedule with phase breakdowns. The app automatically switches to the Calendar tab and scrolls to the top.
5. Track progress — Use the Progress tab to log doses, record weight, blood pressure, body composition, and monitor compliance over time.

Subject Information

Enter age, biological sex, height, and weight. BMI is calculated automatically and used by weight-based dosing peptides. Toggle between imperial and metric units with the unit switcher.

Peptide Selection

Peptides are organized by category (Weight Loss, Growth Hormone, Recovery, etc.). Each category has a distinct color used throughout the UI. All categories are collapsible — click any category header to expand or collapse it. An arrow indicator (▸ / ▾) shows the current state. Check the box next to any peptide to add it to your protocol. Use the search field at the top to quickly find peptides by name.

When a template is applied, categories containing the template's selected peptides auto-expand so you can immediately see and adjust the selections.

Configuration Panels

When you select a peptide, its configuration panel expands below. Depending on the peptide, you will see:

• Dose — Select from preset doses or enter a custom amount. Dose types include per-injection, daily, weight-based (mcg/kg), topical, fixed, and blends.
• Frequency — How often to administer (daily, EOD, 3x/week, weekly, etc.).
• Duration — Total protocol length in weeks.

12 peptides (Semaglutide, Tirzepatide, Retatrutide, Survodutide, MOTS-c, Tesamorelin, Epithalon, SS-31, BPC-157, Ipamorelin, TB-500, PT-141) have hand-tuned configuration panels. All other peptides use auto-generated panels from the data-driven config system.

Templates

Templates let you quickly load pre-configured multi-peptide protocols. Scroll down in the Protocol Builder to see the template grid. Click "+ Add" on any template card to apply it to your current selections. Applying a template scrolls the page to the top of the Protocol Builder.

• Save Current as Template — Click "Save as Template" at the bottom of the template grid to save your entire current setup: all selected peptides, every config panel setting (dose, frequency, duration, variant, protocol type), custom schedules, wizard state, start date, and duration. Saved templates appear with a star icon.
• Customize — When a user-saved template is applied (shown with a green check), the button changes to "Customize". This opens a full editing modal where you can rename the template, change the description, adjust start date and duration, and modify every peptide's configuration (dose, frequency, protocol type, ramp-up, etc.) directly in the modal. For wizard-based templates, an "Open Full Protocol Wizard" button gives access to GLP-1 cycling, add-on peptides, and advanced ramp settings. Saving updates the template in place and regenerates the protocol.
• Delete — Click the trash icon on any user-saved template to permanently remove it.

Custom Protocol Wizard

The Custom Protocol Wizard is an advanced template builder accessed from the Templates section. It provides a guided popup for building a complete multi-peptide protocol:

• Protocol Settings — Set a start date and total duration (weeks) that override the main Protocol Builder controls.
• GLP-1 Agonist — Choose from Semaglutide, Tirzepatide, Retatrutide, or Survodutide. Configure starting dose, maintenance dose, ramp-up weeks, optional ramp-down with end dose (from validated dose steps), and optional cycling (on/off periods with re-ramp per cycle).
• MOTS-c — Set starting week, dose, frequency, cycles (weeks per cycle, number of cycles, gap between cycles), and optional ramp-up/ramp-down (half-dose taper).
• SS-31 Priming (optional) — Enable a mitochondrial priming phase before MOTS-c starts. Choose dose (5-40mg) and duration (2-4 weeks). MOTS-c start week auto-adjusts if needed.
• CJC-1295 / Ipamorelin (optional) — GH secretagogue stack for lean mass preservation. Set individual doses, frequency (nightly, 2x or 3x/week), and optional ramp-up. Runs full protocol duration.
• BPC-157 Gut Support (optional) — Front-loaded gut healing cycle. Choose dose, frequency, and duration (4-8 weeks).

A live Protocol Summary at the bottom updates as you configure, showing peptide count, all enabled add-ons, and total duration with cycling notation (e.g., "2×8wk on / 4wk off"). When cycling is enabled, the Cycles dropdown auto-calculates the maximum number of cycles that fit within your protocol duration.

Clicking "Apply Template" sets all peptide selections, configures every config panel dropdown, and immediately generates the full protocol on the calendar. The wizard remembers your settings when you reopen it, so you can easily make adjustments without starting over.

Stacking Timing Guide

When two or more peptides are selected, a stacking timing guide appears showing the recommended time of day for each injection (morning, pre-bed, post-workout, etc.). This helps you space injections to optimize absorption and minimize interactions between peptides.

Dietary Guidance

When peptides are selected, the Dietary Guidance section shows per-peptide nutritional recommendations: fasting windows, optimal meal timing relative to injections, macronutrient considerations (protein, carbs, fats), and specific foods or supplements to avoid.

Save & Load Protocols

Click "Save Protocol" to store your current configuration to localStorage. Use "Load Protocol" to restore a previously saved protocol. Saved protocols appear in a list below the Protocol Builder with restore and delete options.

If you are already mid-protocol, toggle "Already Started a Protocol?" in the Protocol Builder. This reveals per-peptide cards that let you specify where you are in each protocol.

Multi-Peptide Cards

Each selected peptide gets its own collapsible card with type-appropriate controls:

• Weight Loss peptides (Semaglutide, Tirzepatide, Retatrutide, Survodutide) — Select current dose, weeks at that dose, and optionally configure ramp-down to a maintenance target.
• Non-WL peptides (BPC-157, Epithalon, TB-500, Ipamorelin) — Choose from specific mid-cycle entry points.
• Generic peptides — Select a week-based entry point generated from your protocol duration.

Ramp-Down to Maintenance

For the four supported weight loss peptides, enable ramp-down mode to generate a tapering schedule from your current dose down to a chosen maintenance dose. Each step lasts 2 weeks.

Auto-Detect from Dose Log

Click "Detect from Dose Log" to scan your last 4 weeks of logged doses. Matching peptides are auto-filled with their detected dose and timing. Auto-detected cards show a badge.

Last Dose Date Picker

On weight loss peptide cards, use the date picker to enter when you last took a dose. The system calculates days since last dose and auto-fills weeks at current dose.

Skip Ramp-Up

Each peptide card has a "Skip ramp-up?" toggle that removes the titration phase, starting directly at the configured dose.

4-Week Preview

Each card shows a preview of your next 4 weeks of scheduled doses based on your current settings, so you can verify the output before generating the full protocol.

Click the gear icon (⚙) on any selected peptide to open its Expert Control panel. This gives you fine-grained control over scheduling.

Custom Dosing

Toggle "Custom Dosing" to override the default schedule with your own. You can add, remove, and reorder dose steps, each with a custom dose amount and week range.

Schedule Editor

The schedule editor shows each phase of the protocol as a row. Click "+ Add Step" to add more phases. Drag or use arrows to reorder. Each step specifies a dose and the weeks it applies to.

Cycling Configuration

For cycling-eligible peptides (Epithalon, BPC-157, TB-500, MOTS-c, etc.), set the cycle frequency (2x, 3x, 4x per year) and minimum gap between cycles. The protocol generator will produce multiple cycles with rest periods in between.

Dose Curve Preview

A visual chart shows your dose progression over time, including ramp-up, plateau, and any ramp-down phases.

After generating a protocol, the app automatically switches to the Calendar tab and scrolls to the top. The calendar section shows your complete dosing schedule. Three views are available:

Traditional Calendar (Grid)

A month-by-month grid view showing dose entries on each day. Doses are color-coded by peptide category. Phase indicators show ▲ for ramp-up and ▼ for ramp-down periods.

List View (Table)

A chronological table listing every dose with date, peptide name, dose amount, frequency, and phase. Entries have colored left borders matching their peptide category.

Timeline View

A horizontal bar chart showing each peptide's protocol duration as a colored bar, with opacity variations indicating phases (lighter for ramp-up, medium for ramp-down, full for maintenance/active).

"You Are Here" Marker

If today's date falls within your protocol range, a highlighted marker shows your current position in the calendar and list views.

Category Color Legend

A dynamic legend below the calendar shows the specific peptides in your protocol with their category colors.

Start Week Offset

Use the start week control to shift the entire protocol forward by a number of weeks (e.g., if starting next month).

Calendar Export & Print

Click "Export Calendar" to download your schedule as an ICS file importable into Google Calendar, Apple Calendar, Outlook, etc. Use "Print Protocol" to generate a clean printable version of your full protocol.

The Inventory tab helps you track your peptide supplies.

Adding Items

Click "Add Item" to add a peptide to your inventory. Fill in the peptide name, quantity (mg per vial), concentration, vendor, lot number, expiration date, and storage conditions. You can also add notes and a product URL for reference.

QR Code Scanner & COA Extraction

Scan QR codes from vial labels using the camera button next to the Product URL field. For Janoshik-tested peptides, the three-tier extraction system automatically pulls data from the Certificate of Analysis:

• Tier 1 (URL Parsing) — Extracts test number, peptide name, dosage, and cap/vial colors instantly from the URL.
• Tier 2 (Page Fetch) — Fetches the report page via CORS proxy to discover the COA image.
• Tier 3 (OCR) — Reads the COA image using Tesseract.js to extract sample name, client, batch number, purity, and test date.

When a sample name includes color words (e.g., "blue cap, silver crimp"), the system automatically extracts vial cap and crimp colors into the Notes field. If all proxies fail, a document scanner opens automatically so you can photograph the physical COA with your camera.

Editing & Deleting

Use the Edit, Update, and Delete buttons on each inventory item. On mobile, buttons have 44px touch targets and wrap to fit narrow screens.

Inventory Forecast & Reorder Alerts

After generating a protocol, the Inventory Forecast table automatically compares your stock against protocol requirements. It shows per-peptide status (Sufficient/Low/Insufficient), projected depletion dates, and reorder-by dates based on configurable lead time. When stock is critically low or runs out mid-protocol, a Reorder Alerts banner appears at the top of the Protocol Builder with specific peptides and dates to reorder by.

Reconstitution Calculator & Site Rotation

The Reconstitution Calculator is located in the Inventory tab. Below it, you will find the Injection Site Rotation settings (above the Stacking Timing Guide). Configure your preferred injection sites, enable/disable sites, and reorder them. The system tracks site usage and recommends the next site when logging doses.

The Peptide Library tab provides a browsable reference for all 90+ peptides in the database.

Browsing & Search

Scroll through all peptides or use the search bar to filter by name. Results update as you type.

Category & Evidence Filters

Filter peptides by category (Weight Loss, Growth Hormone, Recovery, etc.) or by evidence level (Strong, Moderate, Preliminary, Emerging) to narrow the list.

Favorites

Click the star icon (★) on any peptide to mark it as a favorite. Favorited peptides appear at the top of the library for quick access.

Peptide Details

Click a peptide card to view its full details: description, mechanism of action, typical dosing ranges, evidence summary, category, and administration route.

Add to Protocol

From a peptide's detail view, click "Add to Protocol" to select it in the Protocol Builder and jump to its configuration panel.

The Interactions tab checks for known interactions between peptides in your protocol.

Using Protocol Selections

Click "Use Protocol Selections" to auto-populate the checker with your currently selected peptides from the Protocol Builder.

Manual Selection

Alternatively, manually check peptides in the Interactions tab to test hypothetical combinations.

Severity Levels

• High — Potentially dangerous combination. Avoid or use only under strict medical supervision.
• Moderate — Significant interaction. Timing adjustments or dose modifications may be needed.
• Low — Minor interaction. Generally manageable with awareness.
• Info — Informational note about the combination. No action typically required.

Interpreting Results

Each interaction shows the two peptides involved, the severity level, and a description of the interaction mechanism. Review all flagged interactions before finalizing your protocol.

The Progress tab helps you track adherence to your protocol and monitor body metrics over time.

Apple Health Import

Import health data directly from Apple Health. Export your data from the Health app on your iPhone (Health → Profile icon → Export All Health Data), then unzip and upload the export.xml file. The importer streams the file (supports 700MB+) and extracts weight, blood pressure, body fat %, lean body mass, resting heart rate, and height. Data is deduplicated against existing entries before import.

Dose Log

Log each dose as you take it. The log shows the date, peptide, dose amount, and injection site. You can edit or delete entries. Upcoming scheduled doses are highlighted so you know what is next. Missed doses (past calendar doses not yet logged) appear in a separate section with quick-log buttons.

Weight Tracking

Add weight entries over time to track changes during your protocol. Entries are graphed as an SVG trend line chart.

Blood Pressure

Track systolic and diastolic readings. Entries are displayed with a dual-line SVG chart and categorized by AHA guidelines: Normal, Elevated, High Stage 1, High Stage 2, and Crisis.

BMI Trend

BMI is calculated from your weight log and height (entered in the BMI card or imported from Apple Health). The chart shows your BMI over time with reference lines at 25 (overweight) and 30 (obese), plus category labels.

Body Composition

Tracks body fat percentage and lean body mass imported from Apple Health. The chart displays trends with sex-aware category ranges (Athletic, Fitness, Average, High).

Resting Heart Rate

RHR data imported from Apple Health. Displayed as a trend chart with fitness categories: Athletic (<60), Good (60-69), Average (70-79), Above Average (80-99), and High (100+).

Time Frame Selectors

All chart cards (Insights Dashboard, Weight, Blood Pressure, BMI, Body Composition, Resting Heart Rate) include a time frame dropdown in their header. Choose from:

• Last 30 Days — Recent snapshot
• Last 90 Days — Quarterly view
• Last 6 Months — Half-year trend
• Last 1 Year — Annual overview
• All Time — Complete history (default)

Charts re-render immediately when you change the time frame, filtering data points and adjusting axis scales accordingly.

Insights Dashboard

Four SVG chart cards in the Progress tab visualize cross-metric correlations:

• Weight vs Protocol Phase — Weight trend overlaid with protocol phase markers.
• Resting Heart Rate vs Dose Changes — RHR plotted against dose adjustments.
• Symptom Frequency by Week — Stacked weekly symptom counts.
• Blood Pressure Across Phases — Systolic/diastolic trends through protocol phases.

Charts auto-populate from your logged data. "No data" placeholders appear when data is insufficient. Each chart also has its own time frame selector.

Compliance Metrics

The tracker calculates your overall compliance rate (doses taken vs. scheduled) and displays it as a percentage with a visual indicator. Review missed doses to identify patterns.

Export Options

• Export Doses (CSV) — Downloads your dose log as a CSV file with date-stamped filename.
• Export Everything (Excel) — Downloads a multi-sheet .xlsx file with all your data: Profile, Inventory, Dose Log, Weight, Blood Pressure, BMI, Body Composition, and Resting Heart Rate. Sheets are color-coded by health category (green for normal, yellow for elevated, red for high) with styled headers and auto-sized columns.

Multi-Profile System

Create multiple profiles to maintain separate protocols, inventories, and progress data. Use the profile selector bar at the top of the page to switch between profiles. Each profile is fully independent.

• Create — Click "New Profile" and enter a name.
• Switch — Click any profile name in the selector bar.
• Rename — Click the rename icon next to the active profile.
• Delete — Click the delete icon. This is irreversible.

Auto-Save (localStorage)

All data is automatically saved to your browser's localStorage as you work. Profile fields auto-save on change. Your generated protocol and active tab persist across page refreshes. Data is local to this browser only — clearing browser data will erase everything.

Saved Protocols

Saved protocols support custom naming and notes via a save modal that appears when you click "Save Protocol". Each saved protocol is displayed as a rich stat card showing:

• Custom name and optional notes you provided
• Stats row — Protocol duration, peptide count, total doses, and subject weight
• Restore and Delete actions per card
• Bulk select & delete — Use the "Select All" checkbox and "Delete Selected" button to manage multiple saved protocols at once

Save Data (JSON)

Click "Save Data" in the bottom action bar to download a complete JSON backup of everything:

• Profile, inventory, saved protocols, and all health logs (dose, weight, BP, body composition, RHR)
• Custom templates you have saved, including all per-peptide settings and wizard state
• Your active generated calendar, custom schedules, and per-peptide settings
• Protocol Builder state (start date, duration), precision policy, site rotation, reminder templates
• Protocol versions, symptom journal, experiments, and already-started state
• Theme, units, favorites, label preferences, and profile index

Load Data

Click "Load Data" at the top of the page to restore from a previously saved JSON file. All data is imported and the UI fully restores: your calendar re-renders with vial binding and inventory forecast, custom templates appear in the template grid, config panels reflect saved settings, and all charts and displays update. A summary toast shows what was imported (inventory items, protocols, dose logs, custom templates, active calendar, etc.).

Clear Data

Click "Clear Data" in the bottom action bar to completely reset the application. This requires two confirmations to prevent accidental deletion. Clears profile, inventory, protocols, all health data, generated calendar, timeline, custom templates, wizard state, per-peptide settings, custom schedules, and all other stored data. This cannot be undone — export a backup first.

Dosing Precision Policy

Configure your syringe accuracy settings via the Settings gear icon. Set minimum/maximum drawable units, preferred range, and measurement rules. The reconstitution calculator shows precision warnings and recommends BAC water volumes to keep doses within your syringe's accuracy range.

Vial Binding

After generating a protocol, calendar doses are automatically bound to specific inventory vials. Each dose entry shows a colored dot indicating binding status:

Click any dose to see a detail popover showing the bound vial's lot number, concentration, units to draw, and precision status.

Depletion Tracking

Logging a dose automatically decreases the bound vial's remaining amount. A low-stock toast notification appears when a vial is nearly depleted.

Injection Site Rotation

The injection site rotation settings are located in the Inventory tab, below the Reconstitution Calculator and above the Stacking Timing Guide. Configure your preferred injection sites (enable/disable and reorder). When logging a dose, the system suggests the next site in rotation. Same-site warnings appear if a site is used too frequently for the same peptide.

Quality Metadata

Inventory items display quality badges based on documentation status:

Expiration risk warnings appear on page load for items expiring within 30 days.

Protocol Versioning

Every time you generate a protocol, a numbered version is created with an auto-detected change description. Access the version history in the Protocol Builder to view, restore, or compare versions.

Each version card now displays enriched details:

• Peptide tags — Color-coded by category, showing all peptides in that version at a glance.
• Stats row — Duration, start date, and total dose count.
• Editable custom names — Click the pencil icon (✎) next to any version name to rename it.
• Bulk select & delete — Use the "Select All" checkbox and "Delete Selected" button to manage multiple versions at once.
• Compare — Select two versions and click "Compare" to see a side-by-side diff of peptide selections and settings.

Symptom Journal

Log symptoms using the "Log Symptom" button in the Progress tab. Each entry captures:

• Type — Choose from 30+ predefined symptoms across 6 categories (GI, neurological, injection site, metabolic, mood, and other).
• Severity — 1-10 scale with color coding (green → yellow → red).
• Details — Link to a specific dose, onset time, injection site, and duration.

Filter symptoms by type, severity, or peptide. The Weekly Insights section shows trend analysis, average onset times, and flags peptides with recurring issues.

Experiment Wizard

The Experiments tab provides a structured framework for N=1 experiments:

1. Hypothesis — Define what you're testing and your expected outcome.
2. Design — Create a multi-phase timeline (baseline, introduction, hold, washout) with customizable durations.
3. Measurements — Set measurement schedules for your endpoints (weight, symptoms, blood markers, etc.).
4. Review & Activate — Review your experiment design and start it.

The active experiment dashboard shows your current phase, progress bar, and measurement logging. Completed and abandoned experiments are tracked in the history.

Insights Dashboard

See Section 9: Progress Tracker for full details on the Insights Dashboard and its four SVG chart cards. Each chart includes a time frame selector and auto-populates from your logged data.

Encrypted Backup

Click the Settings gear icon and open Advanced Backup to access encrypted export/import:

• Export — Enter a passphrase to encrypt all your data using AES-GCM (256-bit). Downloads a .ppa.enc file.
• Import — Upload a .ppa.enc file and enter the same passphrase to decrypt and restore your data.

Encryption uses the Web Crypto API (SubtleCrypto) and never transmits your passphrase or data over the network.

Auto Checkpoints

The system automatically creates checkpoints on key actions (protocol generation, dose logging, inventory changes). The last 10 checkpoints are stored and accessible from the settings panel. You can restore any checkpoint to roll back to that state.

Print Protocol

After generating a protocol, click "Print Protocol" to create a clean, printer-friendly version. This opens your browser's print dialog with a formatted layout including dose schedules, phase breakdowns, and your subject information. Save as PDF for digital records.

Vial Label Generator

Create custom labels for your peptide vials. Enter the peptide name, concentration, reconstitution date, and expiry. Click "Generate Label" to preview, then download as a PNG image or send directly to your printer.

Unit System Toggle

Switch between imperial (lb, ft/in) and metric (kg, cm) units using the toggle in the subject information section. All weight-based calculations update automatically.

Common Issues

• Data not saving? — Ensure your browser allows localStorage. Private/incognito mode may prevent saving. Some browser extensions can also block storage.
• Protocol not generating? — Make sure at least one peptide is selected and all required fields (dose, frequency, duration) are filled in.
• Calendar looks empty? — You need to click "Generate Protocol" after selecting and configuring your peptides. The calendar does not auto-update.
• Lost data after browser update? — Browser updates can sometimes clear localStorage. This is why regular exports are essential.
• Apple Health import not finding data? — Make sure you upload the export.xml file (not the zip). The file must contain Apple Health records in the standard format. Very large files (500MB+) are supported via streaming but may take 30-60 seconds.
• BMI not showing? — BMI requires both weight data and height. Enter your height in the BMI card (ft/in fields) or import it from Apple Health.
• Excel export loading? — The Excel library (~400KB) is loaded from CDN on first use. Requires internet connection for the first export; subsequent exports use the cached library.

Best Practices

• Export backups regularly — Use "Save Data" or "Export Everything (Excel)" at least weekly if you are actively logging doses.
• Use profiles for different stacks — Keep a "current" profile and create separate profiles when planning future protocols.
• Check interactions first — Before finalizing a multi-peptide stack, always run the Interactions Checker.
• Review templates for ideas — The built-in templates represent common well-regarded protocol combinations.
• Import Apple Health data periodically — Re-importing will only add new records; existing entries are automatically deduplicated.

Mobile Usage

The Peptide Research Atlas is fully responsive. On mobile devices:

• Swipe horizontally on the tab bar to access all tabs.
• Tap section headers to expand/collapse content.
• Calendar grid view scrolls horizontally for months with many days.
• Use landscape orientation for the timeline view for best readability.