Services Work About Team Blog Tutorials FAQ 💬 Chat on WhatsApp

Home / Work / The Blissful Soul

Case Study · Headless Commerce & Spiritual Wellness

A unified headless ecosystem
for physical crystals & live Vedic consultations.

The Blissful Soul by Master Pragya Vijh needed to merge physical healing crystal e-commerce with real-time astrologer consultations into a single, seamless checkout. We architected a modular headless monorepo with Next.js 14, Medusa v2, and Strapi CMS.

Client / Founder

The Blissful Soul (Master Pragya Vijh)

Industry

Spiritual Wellness & Astrology

Architecture

Headless Monorepo (migrated from WordPress)

Key Stack

Next.js 14 · Medusa v2 · Strapi · Cal.com

The Blissful Soul - Pragya Vijh Headless E-Commerce Platform engineered by Klickspell

Measurable Results

Engineering performance that powers dual-revenue growth.

By replacing brittle monolithic plugins with custom event-driven TypeScript modules and a Next.js 14 App Router frontend, we achieved instant load times and eliminated 100% of manual booking overhead.

95+

Mobile Lighthouse performance score

100%

Automated booking & meet scheduling

1 unified

Checkout for retail + live consultations

The Client & Brand Vision

Ancient Vedic wisdom meets modern digital craft.

The Blissful Soul is a luxury holistic wellness brand founded by acclaimed spiritual guide and astrologer Master Pragya Vijh. The platform bridges ancient Vedic wisdom, gemstone energy healing, and modern psychology across a dual-revenue business model:

  • Physical Retail: Curated healing crystals, energized bracelets, combo sets, and sacred spiritual artifacts categorized by emotional/life intent (Love, Abundance, Health, Protection).
  • Spiritual Services & Consultations: 1-on-1 personalized sessions including Kundali readings, Tarot guidance, birth chart analysis, and energy healing sessions.

The Challenge

From WordPress plugin bloat to a fragile monolith.

The platform was originally built on WordPress & WooCommerce. As the brand grew, every new business requirement meant tacking on another plugin: an appointment booking plugin, third-party checkout extensions, invoice generators, SMTP mailers, multi-tier shipping calculators, and heavy visual page builders.

Before long, the site became sluggish and fragile:

Severe Plugin Bloat & Maintenance Drag: With dozens of third-party plugins competing for PHP execution and database queries, server response times suffered, plugin updates frequently broke checkout flows, and routine maintenance turned into high-risk firefighting.

Disjointed Consultation & Product Silos: The WordPress booking plugins couldn't cleanly integrate with physical product carts. Customers had to make separate purchases for crystals and consultations on disconnected third-party pages.

Rigid Content vs. Custom Logic: The editorial team struggled with slow admin dashboards, while developers were hamstrung by monolithic theme constraints when implementing custom promotional gift rules and automated PDF tax invoices.

The brand didn't need another WordPress band-aid — they needed to decouple their entire stack onto a clean, modular headless architecture.

The Headless Solution

An event-driven monorepo architecture.

We engineered a modular headless architecture orchestrated with Turborepo and pnpm workspaces, deployed with Docker and Nginx reverse proxy:

Frontend Layer · Port 8001

Next.js 14 App Router & RSC

Server-side rendered storefront using React Server Components for sub-second FCP, seamless URL localization (/[countryCode]/...), and a luxury spiritual design system built with Tailwind CSS.

Commerce Engine · Port 9000

Medusa v2 Core & Custom Modules

Headless commerce engine managing product catalogs, customer accounts, multi-currency pricing, and custom event subscribers connecting payments, booking APIs, and notifications.

Editorial CMS · Port 1337

Strapi Headless CMS

Decoupled content hub empowering the marketing team to dynamically update hero banners, intent collections, founder bios, testimonials, and FAQs without touching code.

Integrations & Infrastructure

Cal.com v2 · Razorpay · Redis · Postgres

Real-time slot locking with Cal.com v2 API, multi-currency Razorpay gateway, Redis job queue, PostgreSQL 16 persistence, and automated EasyInvoice PDF generation.

Engineering Highlights

Custom innovations built for high-touch commerce.

🔮 Unified Cart: Physical Crystals + Cal.com Bookings

When consultation services are added to the cart, session metadata (slot_iso_start, event_slug) attaches to the line item. Upon checkout completion (order.placed event), Medusa triggers a subscriber that calls Cal.com v2 API to lock the appointment and generate Google Meet invites for both Master Pragya and the customer automatically.

📜 Automated PDF Invoicing & Transactional SMTP

Engineered a dedicated Google SMTP notification module paired with easyinvoice within order-invoice.ts to programmatically generate branded, itemized PDF tax invoices with dynamic breakdowns, shipping fees, and order metadata attached directly to customer confirmation emails.

🎁 Intelligent Business Rule Automations

Built auto-add-gift.ts to dynamically evaluate cart subtotal thresholds and inject eligible complimentary energized gifts into the order lifecycle. Added low-stock-notifier.ts to monitor inventory levels in real-time and alert administrators before high-demand gemstones sell out.

⚖️ Custom Weight-Based Shipping Module

Developed a custom weight-shipping module that dynamically aggregates line-item grammage and postal code zones to compute accurate multi-tier carrier rates during checkout.

🔄 Medusa ↔ Strapi Content Synchronization

Created sync-strapi.ts subscribers ensuring categories, intent collections, and marketing tags stay synchronized between the commerce catalog and the headless CMS without duplicate manual data entry.

🌍 URL-Based Global Localization

Configured edge-ready routing (/in/en, /us/en) with automatic geo-detection, currency conversions, and country-specific tax rules for international clients seeking Vedic astrology readings.

Visual Identity

A luxury spiritual aesthetic crafted to convert.

The visual identity was designed to convey reverence, divine energy, and high-end elegance:

Deep Mystical Purple & Champagne Gold Palette

Deep Mystical Purple (#1A0E22) representing higher spiritual consciousness, paired with Champagne Gold (#C5A059) for divine illumination, grounded by warm Ivory Pearl (#FAF9F6).

"Shop by Intent" Experience

Rather than generic product filters, customers discover stones and energized jewelry by emotional and spiritual objectives: Love & Relationships, Wealth & Prosperity, Health & Peace, and Evil Eye Protection.

Interactive Consultation Cards

Interactive flip-cards and modal drawers displaying Master Pragya's consultation offerings with color-coded intent metadata, duration tags, and instant slot availability.

Technology Stack

Battle-tested tools and frameworks.

Layer Technologies & Architecture
Monorepo Management Turborepo, pnpm Workspaces, Shared TypeScript Configs
Frontend Framework Next.js 14 (App Router), React 18, React Server Components (RSC)
Styling & Motion Tailwind CSS, Lucide Icons, Custom Micro-animations
Commerce Backend Medusa v2 (Custom TypeScript Modules, Event Subscribers, Workflows)
Content Management Strapi Headless CMS (Dynamic Zones, Components, REST API)
Persistence & Cache PostgreSQL 16, Redis Cache & Event Bus Queue
Third-Party APIs Cal.com API v2 (Booking Engine), Razorpay Gateway, Google SMTP
PDF Invoicing EasyInvoice (Programmatic dynamic tax & order breakdown)
DevOps & Hosting Multi-container Docker & Docker Compose, Nginx Reverse Proxy, Automated Shell Backups

Conclusion

Freedom, performance, and complete brand control.

The Blissful Soul demonstrates how headless commerce unlocks unmatched operational flexibility and technical speed. By decoupling the presentation layer from backend business logic and editorial workflows, the brand achieved high conversion rates, 100% automated service booking, and full autonomy over their ongoing content marketing.

See more work

Explore the full portfolio

Back to Work ↗

Ready to build a
headless commerce
powerhouse?

Ready for a
headless store?

Let's discuss how Medusa, Next.js, and custom integrations can transform your e-commerce operations.

Free 30-min call. No commitment. No templates.

Book your free call →

The craft in every click.