About Oil Blender
v1.0.0A free, open-source tool for building custom massage oil blends with real-time compatibility scoring, safety guidance, and printable recipe cards.
What Is This?
Oil Blender was built to make aromatherapy blending accessible, safe, and informed. Whether you're a professional massage therapist formulating client blends, or someone creating a relaxing oil for personal use, the tool walks you through choosing a carrier oil, adding essential oils, and understanding how they interact — all before you mix a single drop.
The compatibility scoring system rates each oil pair as Excellent, Good, Caution, Avoid, or Unsafe, giving you the context you need to blend with confidence. Genuinely dangerous combinations are hard-blocked. Everything else is informative, not restrictive.
Every blend gets a permanent shareable URL and a downloadable PDF recipe card with exact quantities, oil profiles, and pairing notes — useful for both personal records and client handouts.
Features
- ✓Tabbed blend builder: Carriers / Essentials / Quantities / Save
- ✓In-progress blend persists across pages and reloads
- ✓Header blend cart with live A–F grade from any page
- ✓Multi-carrier blending (up to 5) with ml-based input
- ✓Up to 5 essential oils per blend, measured in drops
- ✓Additive carrier model — Volume = carrier amount, EOs add on top
- ✓A–F compatibility grade including carrier↔carrier pairings
- ✓EXCELLENT / GOOD / CAUTION / AVOID / UNSAFE pairing system
- ✓Hard blocks for genuinely dangerous combinations
- ✓Per-oil max-dilution safety warnings
- ✓30 essential oils + 25 carrier oils in the library
- ✓Aromatherapy glossary covering 42 common terms
- ✓Side-by-side oil comparison tool
- ✓Compatibility matrix with drag-to-scroll
- ✓Dilution rate guidance (1–5%)
- ✓Batch volume presets (10–200ml) with proportional rescale
- ✓Persistent shareable blend URLs
- ✓PDF recipe card with QR code download
- ✓Per-oil profiles: benefits, origins, contraindications
- ✓Searchable, filterable oil catalog
- ✓Curated featured blends from the community
AI & LLM Transparency
The oil data in this application was generated using Claude (claude-sonnet-4-6), Anthropic's AI assistant. This includes botanical descriptions, historical context, benefit profiles, contraindications, and pairing compatibility ratings.
While Claude's knowledge of aromatherapy is drawn from reputable sources, AI-generated content can contain errors. The compatibility ratings and safety information are for general guidance only and should not replace consultation with a qualified aromatherapist or healthcare professional.
The UNSAFE pairing list is hand-curated by the developer and cross-referenced against established aromatherapy safety literature — it is not AI-generated.
Additionally, the application itself was built with AI assistance (Claude Code / Anthropic Claude) for code generation, architecture, and development.
Always patch test. Always consult a professional for therapeutic use. Not medical advice.
Your Data & Privacy
What gets stored
When you save a blend, the following data is written to the database: the oils you selected, their quantities and percentages, the blend name, creation timestamp, and view count. No account, login, or personal information is required — the only thing linking you to a blend is the URL.
Blend data is automatically deleted after 30 days of inactivity (last time the blend URL was visited). Blends that have been promoted to the curated showcase by an admin are kept indefinitely.
There is no user tracking, no cookies set by this application, and no personal data collected by the blend builder itself.
Abuse prevention
To prevent automated abuse, your IP address is briefly held in process memory when you save a blend or attempt to log in to the admin area, against a per-minute rate limit. The address is never written to disk, never logged, and never shared with third parties. The in-memory store is cleared on every server restart and stale entries drop out within an hour.
Analytics
This site may use Google Analytics 4 to collect anonymised usage statistics — pages visited, session duration, browser and device type, and approximate location (country or region). This helps understand which features are useful and how the site is being used.
Blend contents and recipe data are never sent to Google. Analytics data is aggregated and anonymised. No personally identifiable information is transmitted.
If you prefer not to be tracked, you can install the Google Analytics Opt-out Browser Add-on, use a content-blocking browser extension (uBlock Origin, Privacy Badger, etc.), or enable “Do Not Track” in your browser settings.
Analytics may not be enabled on all deployments of this open-source project. Self-hosted instances can omit the NEXT_PUBLIC_GA_MEASUREMENT_ID environment variable to disable it entirely.
Tech Stack
Next.js 16
Framework (App Router, TypeScript)
PostgreSQL 16
Database
Prisma 7
ORM and database migrations
Tailwind CSS 4
Styling
@react-pdf/renderer
Client-side PDF generation
Zod
API validation
Anthropic Claude
Data enrichment (AI)
Google Analytics 4
Anonymised usage analytics (optional)
GitHub Actions
CI/CD + container registry
Links
Add to Your Home Screen
Oil Blender works as a home screen app — no App Store required. Once installed it opens full-screen without browser chrome, just like a native app.
iPhone & iPad
- 1.Open the site in Safari
- 2.Tap the Share button (□↑) in the toolbar
- 3.Scroll down and tap “Add to Home Screen”
- 4.Tap Add — done!
Android
- 1.Open the site in Chrome
- 2.Tap the menu ⋮ in the top right
- 3.Tap “Install app” or “Add to Home Screen”
- 4.Tap Install to confirm
Desktop
- 1.Open in Chrome or Edge
- 2.Click the install icon ⊕ in the address bar
- 3.Click Install
Disclaimer
The information provided on this site is for educational and general wellness purposes only. It is not intended as medical advice and should not replace professional healthcare consultation. Essential oils are potent substances — always conduct a patch test before applying to skin, and keep out of reach of children. If you are pregnant, nursing, or have a medical condition, consult a qualified professional before using any essential oil blend.
Oil compatibility data is generated with AI assistance and curated by the developer. While care is taken to ensure accuracy, we make no guarantees. Use at your own risk.