Building BJJ Bloodline: Preserving Brazilian Jiu-Jitsu History Online
Our BJJ Bloodline website development project transformed generations of Brazilian
Jiu-Jitsu lineage into a searchable, verified, community-maintained digital record.
preserving something that could otherwise be lost.
BJJ Bloodline is the second kind.
Creating a permanent record of Brazilian Jiu-Jitsu lineage
For an art as deeply traditional as Brazilian Jiu-Jitsu, lineage is part of a
practitioner’s identity. A black belt can trace their training through their teacher,
their teacher’s teacher, and eventually back toward the generations that established
Brazilian Jiu-Jitsu.
However, much of that history has traditionally lived through memory, word of mouth,
individual academies, federation records, and disconnected online sources. The lineage
existed, but there was no single place designed to show the complete relationship between
teachers and students.
BJJ Bloodline
was created to change that. The goal was to give the Jiu-Jitsu community a searchable
historical record that could continue growing with the sport.
A digital Hall of Records for Brazilian Jiu-Jitsu
The brief was straightforward in concept but technically ambitious: build a
searchable, verified and community-maintained platform that maps teachers and
students throughout Brazilian Jiu-Jitsu history.
It was not meant to become another social network or highlight platform.
Instead, BJJ Bloodline needed to function as a historical document that the
community could help preserve.
914Digital handled design and development
end-to-end. That work included the visual system, brand voice, custom WordPress
development, the bloodline application, verified contributor accounts, payments
integration and platform security.
Where the most interesting BJJ Bloodline development work happened
A project like this involves a large amount of invisible work. Features such as
teacher search, profile pages and account registration may sound simple. Nevertheless,
each feature depends on decisions about permissions, verification, security and user
experience.
Several of those decisions became central to the final platform.
Designing trust into the contributor system
One of the most important questions was also one of the simplest:
Who should be allowed to edit a teacher’s profile?
Allowing anyone to make changes could reduce confidence in the historical record.
On the other hand, requiring the BJJ Bloodline team to manually maintain thousands
of profiles would make accurate growth extremely difficult.
Therefore, we developed a verified claim model. Teacher profiles can begin as
unclaimed records created through research. When a teacher finds their profile,
they can register, verify their email and submit a request to claim the profile.
After approval, the verified user receives control over their profile information.
As a result, the community can help expand the archive while profile ownership
remains tied to verified contributors.
integrity of their own history.
Keeping the registration and claim process connected
User experience mattered just as much as the underlying permission system.
For example, a black belt may discover their profile before creating an account.
Requiring that person to register and then manually search for their profile again
would create unnecessary friction.
Instead, the system remembers the profile the visitor intended to claim. After
registration and email verification, the user returns directly to that destination.
Consequently, registration, verification and profile claiming feel like one
continuous process.
A custom WordPress login experience
Standard WordPress authentication often removes visitors from the visual experience
of the website and directs them toward a generic login screen. That approach did not
fit the BJJ Bloodline experience.
We therefore built custom login and registration functionality directly into the
site’s interface. Login, registration and verification actions use asynchronous
AJAX requests, which means users can complete key account actions without leaving
the page they were viewing.
Users can also switch between login and registration inside the same interface.
This keeps the experience consistent and makes the platform feel like a purpose-built
application rather than a collection of WordPress components.
Building layered security into the platform
Once a website includes user accounts and contributor permissions, security becomes
a fundamental part of the development process. For that reason, BJJ Bloodline uses
several layers of protection.
AJAX nonce protection
Sensitive asynchronous requests use WordPress nonce verification to help
protect actions from unauthorized requests.
Spam prevention
Registration forms include honeypot protection and reCAPTCHA to reduce
automated and scripted account creation.
Login rate limiting
Repeated failed login attempts are rate limited to help reduce automated
credential attacks against user accounts.
Secure verification
Email verification uses expiring tokens and secure comparison methods
designed to make account verification safer.
In addition, non-administrator users are kept out of the WordPress dashboard.
This allows contributors to interact with the platform through the experience
designed specifically for BJJ Bloodline.
A custom WordPress website built from the ground up
BJJ Bloodline does not rely on a traditional page builder or an off-the-shelf
premium theme. Instead, the interface was developed as a fully custom WordPress
theme using Bootstrap 5 as the responsive foundation.
Building the theme from scratch gave us greater control over performance,
accessibility, responsive behavior and long-term maintainability. It also allowed
every component to be designed around the needs of the application rather than
around the limitations of a prebuilt theme.
The responsive experience includes mobile navigation, a site-wide search interface
and account controls that adapt depending on whether a visitor is signed in.
AJAX live search across the BJJ archive
Search is especially important because one of the main reasons to visit BJJ Bloodline
is to find a specific person in the lineage.
Visitors can open the search interface from around the website and begin typing a
name or search term. Results are returned asynchronously across relevant site content,
including teacher profiles, without requiring the visitor to load a traditional
WordPress search-results page.
The result is a faster and more application-like way to explore the Brazilian
Jiu-Jitsu archive.
The BJJ Bloodline technology stack
The platform combines WordPress with purpose-built development rather than relying
on unnecessary plugins for every feature.
Content management and application foundation
Responsive front-end framework
Bloodline and account application logic
Structured WordPress content
Forms and payment functionality
AJAX interactions and interface behavior
What we’re proudest of
Some of our favorite parts of this BJJ Bloodline website development project are
details that most visitors may never consciously notice.
The verification system remembers which profile a person intended to claim. The
login protection resets appropriately after a successful login. Spam protection
remains invisible during normal use. Even the 404 page reflects the concept behind
the website with the message, “This page has no lineage.”
Those small decisions help separate a website that was simply assembled from a
digital product that was carefully designed.
More importantly, BJJ Bloodline is preserving information that matters to the
Brazilian Jiu-Jitsu community. The technical foundation was therefore designed
to support a platform that can continue growing for years.
Explore the Brazilian Jiu-Jitsu lineage on BJJ Bloodline
Search the archive, explore teacher profiles and see the custom platform
developed to help preserve generations of Brazilian Jiu-Jitsu history.