BJJ Bloodline

Client: BJJ Bloodline Live site: bjjbloodline.com Year: 2026 Scope: Brand positioning · UX strategy · Custom WordPress theme · Application development · Payments · Security

The Brief

Brazilian Jiu-Jitsu is an art defined by lineage. Every black belt can trace a path back through their teacher, their teacher’s teacher, and on to the founders who brought the art from Japan to Brazil in the early 1900s. But that history has lived in memory, word of mouth, and scattered gym records — never in one place, never verified, never searchable.

BJJ Bloodline came to us with an ambitious goal: build the definitive digital “Hall of Records” for Brazilian Jiu-Jitsu — a living, community-maintained archive that maps the unbroken chain of teachers and students from Mitsuyo Maeda to the practitioners on the mats today.

It needed to feel less like a database and more like an institution. Less like a social network and more like a historical document.

Our Approach

The project sat at an interesting intersection: part archive, part platform, part credentialing system. We needed to design something that felt authoritative enough to be trusted by world-class instructors, but accessible enough that anyone tracing their lineage for the first time could find their way through it.

We started with positioning: BJJ Bloodline isn’t a profile site, it’s a record of record. From there we built a clean, archival visual system that gets out of the way of the content, and an application architecture that supports a verified contributor model — where teachers can claim their own profiles, manage their information, and confirm the students they’ve promoted.

What We Built

Brand & Positioning

• Established BJJ Bloodline’s voice as a historical authority — respectful, accurate, community-led
• Defined the core concept of the “living bloodline” that threads through every page of the site
• Visual system anchored in archival photography and serious typography that signals “this is the record”

Custom WordPress Theme

• Fully custom theme built on Bootstrap — no off-the-shelf themes or page builders
• Responsive across mobile, tablet, and desktop
• Off-canvas mobile navigation and an off-canvas search panel for fast access on any device
• Modal-based authentication with tabbed Login / Register flow
• Profile dropdown with avatar initials and contextual links once a user is signed in
• Custom 404 page themed around the “no lineage” concept — keeping users on-site even when they hit a dead end

The Bloodline Application

• Custom post type for teacher profiles, with rich custom fields for biography, lineage relationships, photos, and credentials
• Profile claim workflow: practitioners search for their profile, verify they’re the rightful owner, and gain editing rights
• Verified-account badging so users can distinguish authenticated profiles from unclaimed entries
• AJAX live search across teachers and pages — results appear as you type without page reloads
• Lineage tree visualization showing the multi-generational links between teachers and students

Authentication & Account System

• Custom AJAX login and registration flows — no jarring page reloads, smooth modal-based UX
• Mandatory email verification before first login, with secure tokens, 24-hour expiry, and a one-click verification link
• “Resend verification email” flow with built-in rate limiting to prevent abuse
• Claim-redirect intelligence: if a user registers while trying to claim a profile, they’re returned to that exact page after verifying
• Admin-bar and wp-admin lockdown for non-admin roles — keeps the front-end experience clean and prevents inexperienced users from wandering into the dashboard

Security & Anti-Abuse

• Honeypot fields on every public-facing form to catch automated bots
• reCAPTCHA v2 on the registration form to block humans-as-bots and scripted account creation
• IP-based rate limiting on the login endpoint — five failed attempts trigger a fifteen-minute cooldown to defeat credential stuffing
• Nonce verification on every AJAX request
• Timing-safe token comparison (hash_equals) for email verification links
• Standard WordPress hardening: escaping on output, sanitization on input, capability checks on privileged actions

Payments Integration

• Gravity Forms + Stripe integration for paid features and donations
• Live and test webhook endpoints configured with signing-secret verification
• Configurable form-feed setup so the team can launch new paid offerings without developer involvement

Technical Stack

• WordPress (custom theme, no page builders)
• Bootstrap 5 for the front-end framework
• Advanced Custom Fields (ACF) for structured content management
• Gravity Forms + Stripe for payments
• Custom PHP application layer for the bloodline / claim system
• AJAX (vanilla JS) for live search, login, registration, and verification flows
• Google reCAPTCHA v2 for bot mitigation

The Result

BJJ Bloodline launched as exactly what the community needed — a single, credible, searchable home for the lineage of an art with deep traditions and a fierce respect for them. Teachers can claim their place in the record. Students can trace their path back through the generations. And the platform is built to grow with the community, one teacher and one connection at a time.

Visit the project live at bjjbloodline.com.