Sol Mental Health — A Healthcare-Grade Provider Marketplace on Drupal 11

Project Snapshot

• Client: Sol Mental Health (solmentalhealth.com)
• Industry: Behavioral Health, United States
• Engagement: Ground-up Drupal 11 platform build with ongoing work
• Timeline: 8+ months and ongoing
• Stack: Drupal 11.2, Vite 6, Tailwind CSS 4, Platform.sh

The Challenge

Sol Mental Health is a fast-growing behavioral health group offering in-person and virtual care across multiple US states. Patients needed to find the right clinician fast, and Sol needed a platform that could keep pace with the clinical operation behind it. Their existing site was a brochure. The business needed a marketplace.

Four specific gaps we had to close:

• A marketplace, not a brochure. Surface hundreds of providers across 20+ clinical dimensions with sub-second filtering and facets.
• Real-time scheduling with zero vendor lock-in. Show live appointment slots from an external scheduling vendor while staying free to swap providers later.
• Multi-state SEO and UX. State-specific landing pages, regional phone routing, and structured data tuned for medical search.
• A CMS marketers can actually run. Layout Builder, Paragraphs, and custom blocks that ship pages without calling an engineer.

The Solution

A custom Drupal 11 platform built on the Paragon distribution with a bespoke Vite + Tailwind frontend, nine custom modules totaling over 7,300 lines of production PHP, and a decoupled OAuth integration layer for real-time appointment data.

A Provider Directory Built Like a Marketplace

We indexed 22+ searchable fields in Search API, then layered faceted filters on top: specialty, therapeutic approach, language, licensure, insurance, gender, cultural background, age range, and session type. A custom mobile-first filter-toggle component keeps the UX clean on every screen, and a proprietary ranking system sorts results from a single CSV upload. The directory behaves like a marketplace — fast, filterable, and tuned for match quality.

Live "Next Availability" Without Vendor Lock-in

A custom scheduling module authenticates with Sol's appointment system via OAuth 2.0 client credentials, caches access tokens intelligently, and pulls live availability onto every provider card and detail page. The integration is endpoint-configurable, so Sol can switch scheduling vendors tomorrow without touching a line of Drupal code. No lock-in, no rewrite penalty.

State Landing Pages and IP-Based Phone Routing

Every state Sol operates in gets its own landing page, powered by 15 custom Layout Builder blocks we built for location and state contexts. A custom user-region module uses Smart IP geolocation to swap the header phone number to the correct regional intake line across all 50 states plus DC, with graceful fallbacks for unknown regions.

Healthcare-Grade Structured Data

A full Schema.org stack tuned for medical search:

• MedicalOrganization globally on the site
• Person + worksFor: MedicalClinic on every provider page
• MedicalClinic + PostalAddress + OpeningHoursSpecification on every location page
• FAQPage on FAQs and careers pages
• Article with a medical publisher on blog and news content

The structured data is emitted server-side from field-aware templates, not hand-written per page, so editors cannot accidentally break it.

Smart Video Embeds

A custom oEmbed handler auto-detects YouTube, YouTube Shorts, and Vimeo content, determines aspect ratio dynamically, and caches metadata for 24 hours. Editors drop any video URL into a field and the theme renders it correctly.

Related-Providers Recommendation Engine

A custom summary-paragraphs handler walks the entity graph (provider → location → state → specialty) to recommend contextually relevant alternative clinicians on every provider page. Small feature, outsized conversion impact.

Scale of What We Shipped

• 9 custom modules
• 7,330+ lines of production PHP
• 234 Twig templates
• 15 custom Layout Builder blocks
• 70+ contrib modules integrated
• 20 taxonomies modeled
• 22+ search-indexed fields
• 452+ git commits

Tech Stack

• CMS: Drupal 11.2 on PHP 8.3, Paragon distribution
• Frontend: Vite 6, Tailwind CSS 4, PostCSS, Storybook, modern ES6
• Search: Search API, Facets, Better Exposed Filters
• Content: Layout Builder, Paragraphs, Metatag, Schema Metatag
• Integrations: OAuth 2.0, Guzzle, Smart IP, oEmbed, Leaflet
• Infra: Platform.sh, Redis, Memcached, MySQL
• DevOps: DDEV, GitHub Actions, Drush automation

Outcomes

• Faster clinician discovery. Patients find and filter providers in seconds, not minutes, across 20+ clinical dimensions.
• Live availability on every provider card. The "Next Availability" integration turns a static directory into a real-time marketplace.
• Multi-state SEO surface. State-specific landing pages with structured data tuned for medical search give Sol a distinct page for every jurisdiction.
• Zero vendor lock-in on scheduling. The OAuth integration is endpoint-configurable, so switching providers requires config changes, not a rewrite.
• Healthcare-grade schema across the site. MedicalOrganization, MedicalClinic, Person, FAQPage, and Article types emitted server-side from the content model.
• Editor-first CMS. Layout Builder, Paragraphs, and custom blocks let the marketing team ship pages without engineering.

Client Testimonial

"WebEvra did not just rebuild our website. They built the infrastructure our clinical operation needed. Patients find the right clinician faster than they ever could before."

— Sol Mental Health Team

Need a healthcare platform that matches your clinical ambition?

Sol Mental Health is a good example of where Drupal shines: structured clinical content, multi-state operations, real-time external integrations, and editor workflows that do not fall apart at scale. If you run a healthcare group, provider marketplace, or clinical operation that needs more than a brochure site, book a strategy session. See also our Headless Drupal development and Drupal support and maintenance service pages.