Case Study · SaaS

Ifá Wisdom

AI-Powered Ifá Oracle platform — a full-stack SaaS combining 4,000 years of Yoruba philosophy with artificial intelligence.

ClientIfá Wisdom
RoleFull-Stack Developer & Designer
Timeline2025 — 2026
StatusLive in production
Visit ifa-wisdom.com → Start a project
Ifá ritual setup: divination tray, smoke and candles

The Project

Ifá Wisdom is a SaaS platform that brings 4,000 years of Yoruba philosophical wisdom into the digital age. Users consult the Ifá Oracle — a UNESCO-recognized Intangible Cultural Heritage — and receive AI-generated interpretations following the traditional six-step Babalawo consultation structure.

The platform serves a global audience across four languages (Portuguese, English, Spanish, German) with a complete subscription economy, gamification system and educational content.

Technical Challenges

Multi-language architecture

Fully internationalized app (pt-BR, en, es, de) with next-intl + ICU message format. Every page, transactional email, error and AI prompt is locale-aware — including the Oracle consultation responses, which are generated in the user's language while preserving sacred Yoruba terms untranslated.

AI with cultural sensitivity

Integrated Claude (Anthropic) with Kimi/Groq as fallback. The system prompt follows the exact structure of a traditional Babalawo consultation: Odu revelation, Ire and Osogbo guidance, Ese Ifá sacred literature, Ebó prescriptions and Eewò taboos. Robust JSON extraction with regex fallback handles truncated AI responses gracefully.

Real-time subscription lifecycle

Complete Stripe subscription management with native in-app cancellation (no redirect to external portals), 30-day grace period, automatic reactivation, webhook-driven state sync and a safety-net cron that catches missed events. Users see their subscription state update instantly without waiting for webhooks.

Gamification economy

Dual-currency system (XP for levels, Asé for purchasing) with streaks, achievements and tier progression (Aleyo → Abọṣẹ → Ọmọ Ifá → Babaláwo). Balances three free daily consultations for everyone with paid contextual consultations — Premium subscribers get unlimited access while still participating in the gamification loop.

Tech Stack

LayerTechnology
FrameworkNext.js (App Router) + React 19
LanguageTypeScript (strict mode)
StylingTailwind CSS (custom Warm Earth palette)
DatabaseSupabase (PostgreSQL + Auth + RLS + RPC)
PaymentsStripe (Subscriptions + one-time + Customer Portal)
AIAnthropic Claude + Kimi Moonshot (fallback)
StateZustand (client) + Server Components
i18nnext-intl · 4 locales · ICU format
EmailResend (transactional + newsletter)
DeployVercel (Git-triggered CI/CD)
MonitoringVercel Analytics + Google Analytics

Key Features Delivered

Visual Identity

Brand and concept imagery that drives the product's visual language.

Results

Need a similar platform — multilingual, AI-assisted, subscription-driven?

Start a conversation See it live →