⚡ Quickstart Guide
Get your first formula mixed in 5 minutes.
Step 1: Set Your Target
Open the Formula Builder page and set your EC (Electrical Conductivity) target.
💡 Tip: Start with EC 1.8 mS/cm for leafy greens, EC 2.0 for tomatoes.
Step 2: Choose a Preset
Select a crop-specific formula from the Quick Presets:
- Lettuce — Seedling: High nitrogen, low EC
- Lettuce — Grow: Balanced formula for vegetative growth
- Tomato — Vegetative: Moderate nitrogen, higher potassium
- Tomato — Bloom/Fruit: Reduced nitrogen, high phosphorus & potassium
Step 3: Fine-Tune Sliders
Adjust the nutrient sliders to customize the formula for your specific crop and growth stage:
- Macronutrients: N, P, K, Ca, Mg, S (use to balance ratios)
- Micronutrients: B, Fe, Mn, Zn, Cu, Mo (usually kept at standard levels)
ℹ️ Info: Adjust in small increments (±5-10%) to avoid major imbalances.
Step 4: Solve & Review
Click Solve to generate the formula. Review the results:
- EC Estimate: Should match your target (±0.2)
- Element Deviation: Bars should be mostly green (±10%)
- Compatibility Alerts: Check for any warnings (yellow/red)
Step 5: Mix Your Batch
Go to the Production page to:
- View the Bill of Materials with chemical quantities
- Follow the Mixing Guide step-by-step
- Complete the Verification Checklist before using
⚠️ Important: Always follow the A/B split — mix Part A (Calcium) and Part B (Sulfate/Phosphate) separately to prevent precipitation.
Next Steps
- Read the User Guide for advanced techniques
- Check Reference for nutrient data and presets
- Visit Troubleshooting if something doesn't work
📖 User Guide
Complete reference for NutriCalc features and workflows.
Overview
NutriCalc is a hydroponic nutrient calculator designed to help growers formulate precise, balanced solutions for any crop and growth stage. The tool combines:
- Scientific solver: Uses SVD-based mathematics to calculate exact chemical quantities
- Safety alerts: Warns about precipitation risk, solubility limits, and nutrient toxicity
- Cost tracking: Estimates production cost per batch
- Production workflows: Guided mixing steps, verification checklists, and supplier BOM
Formula Builder
EC Target
Electrical Conductivity (EC) measures the total dissolved nutrients in your solution:
- 0.8–1.2 mS/cm: Seedlings, weak plants (recovery)
- 1.2–1.8 mS/cm: Leafy greens, herbs
- 1.8–2.2 mS/cm: Fruiting crops (tomatoes, cucumbers)
- 2.2–2.8 mS/cm: High-demand crops (strawberries, peppers)
Nutrient Sliders
Adjust each element in ppm (parts per million):
- Nitrogen (N): Drives vegetative growth; reduce during bloom
- Phosphorus (P): Essential for root and flower development
- Potassium (K): Improves stress tolerance and fruit quality
- Calcium (Ca): Structural nutrient; prevent Ca deficiency in high-demand crops
- Magnesium (Mg): Core of chlorophyll; 10–15% of N level
- Sulfur (S): Often overlooked but important; usually 10–20% of N
Micronutrients
Boron, Iron, Manganese, Zinc, Copper, Molybdenum, Nickel. Start with standard levels and adjust only if symptoms appear.
Nutrient Profile
Radar Chart
Compares your formula to the target. All points should align with the outer circle.
Element Deviation
Shows percentage deviation from target:
- Green (±10%): Excellent match
- Yellow (±20%): Acceptable, but consider re-solving
- Red (>±20%): Significant deviation; try different compounds
Nutrient Ratio Analysis
Compares your formula to scientific reference frames (Bugbee, Hoagland). Slight deviations are OK for crop-specific optimization.
A/B Stock Split
Why split? Calcium (Ca²⁺) + Sulfate (SO₄²⁻) form insoluble calcium sulfate (CaSO₄) when mixed together. By keeping them in separate containers:
- Part A: Contains calcium nitrate, potassium, magnesium, and micronutrients
- Part B: Contains potassium sulfate, phosphate, and additional sulfate
Mix Part A first in water, then Part B. Never pre-mix dry Part A + Part B together.
Production Workflow
Bill of Materials
Shows exact quantities of each chemical needed. Assumes a 100× concentrate (diluted 1:100 in final reservoir):
- For 50× concentrate, divide all volumes by 2
- For 200× concentrate, multiply all volumes by 2
Mixing Guide
Step-by-step instructions:
- Prepare: Clean containers, measure water temperature, gather chemicals
- Part A (Calcium): Dissolve in water first, stir until fully dissolved
- Part B (Sulfate/Phosphate): Dissolve in separate water, stir until fully dissolved
- Store: Label containers, keep in cool dark place
- Dilute: Add both parts to final reservoir at 1:100 ratio
⚠️ Critical: Never mix Part A and Part B dry chemicals together. Precipitation will ruin your solution.
Verification Checklist
Before using your solution, complete these tests:
- pH Test: Use calibrated pH meter; target is crop-specific (usually 5.5–6.5)
- EC Test: Confirm EC matches your target (±0.2 mS/cm tolerance)
- Appearance: No cloudiness, precipitate, or discoloration
- Smell: No unusual odor indicating decomposition
- Temperature: Room temperature (18–25°C); cold solutions reduce absorption
Chemical Alerts
NutriCalc checks for these compatibility issues:
- Calcium + Sulfate precipitation: Avoids by A/B split design
- Calcium + Phosphate precipitation: Warns if high levels
- Iron solubility: Unchelated iron oxidizes at pH > 5.5
- Ammonium toxicity: Warns if >10% of total nitrogen
- Boron solubility: Warns if >4.7 g/L (boric acid limit)
Cost Tracking
NutriCalc estimates production cost per batch based on chemical prices. Prices come from:
- Supplier APIs (if configured)
- Manual entry (Chemical Library page)
Use cost comparison to find the cheapest blend without sacrificing quality.
Dosing & MQTT
For automated greenhouse control, configure MQTT (Message Queuing Telemetry Transport):
- Set broker address and port (usually localhost:1883 for local server)
- Map each compound to a physical pump number
- Click "Publish" to send dosing instructions to all pumps
ℹ️ Advanced: Requires MQTT-compatible pump controllers (e.g., ESP32 with PubSubClient).
📚 Reference
Technical data, presets, and lookup tables.
Preset Formulas
Scientific formulas based on published research (Bugbee, Hoagland, Steiner).
Lettuce — Seedling (EC 1.2)
N: 100 ppm | P: 30 | K: 120 | Ca: 60 | Mg: 45 | S: 30
Lettuce — Grow (EC 1.6)
N: 140 ppm | P: 35 | K: 160 | Ca: 80 | Mg: 50 | S: 35
Tomato — Vegetative (EC 1.8)
N: 160 ppm | P: 35 | K: 180 | Ca: 90 | Mg: 55 | S: 40
Tomato — Bloom/Fruit (EC 2.0)
N: 120 ppm | P: 45 | K: 220 | Ca: 100 | Mg: 60 | S: 45
EC Ranges by Crop
| Crop |
Stage |
EC (mS/cm) |
| Lettuce, Spinach |
All |
1.2–1.8 |
| Tomato |
Vegetative |
1.8–2.2 |
| Tomato |
Bloom/Fruit |
2.0–2.4 |
| Cucumber |
All |
1.8–2.2 |
| Herbs |
All |
1.0–1.6 |
| Strawberry |
Bloom/Fruit |
2.2–2.8 |
Micronutrient Standard Levels (ppm)
| Nutrient |
Standard |
Range |
| Boron (B) |
0.5 ppm |
0.3–1.0 |
| Iron (Fe) |
2.0 ppm |
1.0–5.0 |
| Manganese (Mn) |
0.5 ppm |
0.3–1.0 |
| Zinc (Zn) |
0.05 ppm |
0.02–0.1 |
| Copper (Cu) |
0.02 ppm |
0.01–0.05 |
| Molybdenum (Mo) |
0.05 ppm |
0.01–0.1 |
| Nickel (Ni) |
0.1 ppm |
0.05–0.5 |
Common Chemical Sources
| Nutrient |
Chemical |
Notes |
| Nitrogen |
Calcium Nitrate (CaNO₃) or KNO₃ |
Main N source; provides Ca or K simultaneously |
| Phosphorus |
Monopotassium Phosphate (MKP) |
Most common; soluble, stable |
| Potassium |
Potassium Sulfate (K₂SO₄) or KNO₃ |
K₂SO₄ is in Part B; KNO₃ in Part A |
| Calcium |
Calcium Nitrate (CaNO₃) |
Goes in Part A only (separate from sulfate) |
| Magnesium |
Magnesium Sulfate (MgSO₄) or Mg Nitrate |
MgSO₄ (Epsom salt) is cheap; goes in Part B |
| Micronutrients |
Multi-micronutrient mix or individual salts |
Use chelated forms (DTPA, EDTA) for stability |
pH Target by Crop
- Lettuce, leafy greens: 5.5–6.5 (optimal 6.0)
- Tomato, cucumber: 5.5–6.5 (optimal 6.0–6.2)
- Herbs: 5.5–7.0
- Most hydroponic crops: 5.5–6.5 (general guideline)
Unit Conversion Table
| From |
To |
Multiply By |
| grams |
ounces |
0.03527 |
| liters |
gallons (US) |
0.2642 |
| kg |
lbs |
2.205 |
🔧 Troubleshooting
Common problems and solutions.
Formula Issues
❌ "Solver failed" or "No solution found"
Problem: NutriCalc cannot formulate your target with the selected chemicals.
Solutions:
- Add more chemical options (Chemical Library page)
- Lower EC target slightly (sometimes high EC + specific elements conflict)
- Adjust nutrient ratios (some target combos are mathematically impossible)
- Use a preset formula as a baseline; then tweak
❌ Element deviation is red (>±20%)
Problem: One or more elements miss the target significantly.
Solutions:
- Try different compounds for that element
- Adjust EC target ±0.2 mS/cm to find a better balance
- Check if compound is missing from library; add it
- Accept slight deviation if agronomically acceptable (expert users only)
❌ "Chemical incompatibility warning"
Problem: Precipitation risk detected.
Solutions:
- Calcium + Sulfate: Use A/B split (automatic in NutriCalc)
- Calcium + Phosphate: Reduce calcium or phosphorus slightly
- Iron at high pH: Lower pH to 5.5 or switch to chelated iron
- Boron > 4.7 g/L: Use boric acid carefully; may precipitate
Mixing Issues
❌ Solution is cloudy (white/gray)
Problem: Precipitation has occurred.
Cause: Usually calcium sulfate (CaSO₄) — indicates A/B parts were mixed together before dilution.
Solution:
- Discard the batch
- Follow A/B split strictly: Part A (Ca) separate, Part B (SO₄) separate
- Only mix when diluting to final reservoir
❌ EC is too high or too low
Problem: Measured EC doesn't match target.
Causes & solutions:
- Tap water EC: If tap water is not DI/RO, EC will be higher. Measure your source water.
- Measuring error: Calibrate meter with known solutions; check temperature compensation
- Concentrate ratio wrong: Confirm 100× dilution (1 part concentrate : 99 parts water)
- Evaporation: Water evaporates before nutrient, raising EC; top-up with DI/RO water
❌ pH is way off (too acidic or alkaline)
Problem: pH doesn't match target after mixing.
Solutions:
- Too acidic (< 5.0): Add potassium hydroxide (KOH) in small amounts OR reduce nitrate salts
- Too alkaline (> 7.0): Add phosphoric acid (H₃PO₄) or nitric acid (HNO₃) in small amounts
- Tap water pH issue: Measure source water pH; some water is naturally basic
- Meter error: Calibrate pH meter with pH 7.0 and pH 4.0 standards
App Issues
❌ Formulas not saving
Problem: Click "Save" but formula doesn't appear in Saved Formulas.
Solutions:
- Check browser console (F12 → Console) for errors
- Clear browser cache and reload
- Try a different browser
- Ensure browser allows LocalStorage / cookies
❌ MQTT publish fails
Problem: "No ACK received" or publish times out.
Solutions:
- Verify broker is running:
mosquitto -v on Linux/Mac
- Check broker address and port (default: localhost:1883)
- Ensure pump controllers are subscribed to the topic
- Check firewall rules allow MQTT traffic
- Use a MQTT client (e.g.,
mosquitto_pub) to test connection
❌ Prices not updating
Problem: Chemical prices are stuck or showing "—".
Solutions:
- Click "Refresh Prices" on the Chemical Library page
- Check "Price Sources" — ensure you have API keys configured (if required)
- Manually add prices: edit each compound in the library
- Some chemicals may not have public pricing; you'll need to enter manually
Crop-Specific Issues
Yellowing leaves (nitrogen deficiency)
Solution: Increase nitrogen slightly, re-solve, and remix.
Purple/dark leaves (phosphorus deficiency)
Solution: Increase phosphorus, re-solve, and remix.
Weak stems (potassium deficiency)
Solution: Increase potassium, re-solve, and remix.
Interveinal chlorosis (magnesium deficiency)
Solution: Increase magnesium, re-solve, and remix.
Still Stuck?
If you can't find a solution:
- Check error messages in browser console (F12)
- Review the User Guide section relevant to your issue
- Double-check A/B split and mixing procedure
- Test your EC meter and pH meter with known standards