How I Built a 400-Page Diesel Fault Code Database with Python SSG (Zero Node.js)

bob jin — Tue, 07 Jul 2026 07:41:49 +0000

I Built This Because My Dad's Truck Kept Breaking Down

My dad runs a small trucking company in Texas. Last year, his 2018 Kenworth T680 threw SPN 3226 FMI 0 — NOx sensor circuit failure. The dealership quoted $650. He called me: "Can you find what this code means?"

I searched Google. Results: two-line blurbs on generic sites. No technical depth. No repair cost estimates. No Spanish version for his Mexican driver.

That's when I realized: truck drivers need a dedicated fault code database. Not another generic OBD2 site.

The Problem: Diesel Fault Codes Are Undocumented

Heavy-duty trucks use SAE J1939 protocol — not standard OBD2. A single fault code can have:

SPN (Suspect Parameter Number): Which system failed
FMI (Failure Mode Identifier): How it failed
MID/PID: Manufacturer-specific identifiers

Generic OBD2 sites don't cover this. Trucking forums have scattered threads. Dealerships charge $100 just to read the code.

The Solution: Python SSG + JSON Database

I built a pure Python SSG — zero Node.js, zero dependencies:

# build.py core logic
def build_fault_code_page(spn, fmi, data):
    html = f"""
    <article>
        <h1>SPN {spn} FMI {fmi}: {data['title']}</h1>
        <div class="specs">
            <p>SAE J1939 Standard: ✅</p>
            <p>Repair Cost: {data['repair_cost']}</p>
            <p>Severity: {data['severity']}</p>
        </div>
        <div class="content">
            {data['content']}
        </div>
        <div class="schema">
            <script type="application/ld+json">
            {json.dumps(generate_schema(spn, fmi, data))}
            </script>
        </div>
    </article>
    """
    return html

Key features:

Bilingual EN+ES: hreflang tags for US truckers + Mexican drivers
SAE J1939 citations: Every page cites the official standard
Repair cost estimates: Real dealership quotes from forum data
Schema.org markup: TechArticle + BreadcrumbList

Performance Results

Metric	Before (Generic OBD2 Sites)	After (Diesel DTC Hub)	Improvement
Content depth	2 lines	2000+ words	+100x
Bilingual	❌ None	✅ EN+ES	Zero→Dual
SEO Schema	❌ None	✅ 8 types	Zero→Full
Repair cost	❌ None	✅ $200-$8000	Zero→Real data
Pages	10-50	401	+4x

Lessons Learned

Don't use Node.js for SSG: Python's f-string templates are faster and simpler than any JS framework
Cite industry standards: SAE J1939 citations built trust with trucking forums
Real repair cost data: Forum data beats generic "consult a mechanic" advice
Bilingual is a blue ocean: Zero competitors offer Spanish diesel fault code documentation
Schema.org is SEO gold: TechArticle schema drove 40% more traffic in 30 days

Next Steps

I'm now expanding to:

Cummins X15 fault codes (50 new pages)
Paccar MX-13 fault codes (40 new pages)
Spanish audio fault code guides (YouTube channel)

Check out the full 401-page database: https://diesel-dtc-hub.web.app

11 Useful Reference Websites I Built from Public Data

bob jin — Tue, 23 Jun 2026 07:30:59 +0000

I enjoy organizing public information into websites that are easy to search and browse. Here are 11 I have built across different topics — all free to use.

Dream Interpretation & Spirituality

HeartYearning — A searchable reference for dream symbols, angel numbers, tarot cards, and crystal meanings. Each entry includes psychological context and spiritual interpretation.

→ [Dream Dictionary]
→ About HeartYearning

Trade & Travel

PoliteDraft — US import tariff lookup. Search by product or HTS code to find duty rates and trade agreement preferences.

→ HTS Tariff Database
→ About PoliteDraft

EntryPolicies — Check visa requirements for any passport and destination. See where you can travel visa-free and what documents you need.

→ Visa Requirements
→ About EntryPolicies

Home & Family

MeowWonder — What is toxic to dogs and cats? A searchable database of 77 common household substances with danger levels and what to do in an emergency.

→ Pet Toxin Reference
→ About MeowWonder

FinalCostGuide — Compare funeral and cremation costs across 68 US cities. See price ranges, find local funeral homes, and learn your rights under the FTC Funeral Rule.

→ Funeral Cost Comparison
→ About FinalCostGuide

US Wildlife Dispatch — Texas wildlife identification guides. What animal is digging in your yard? What snake is that? When is mosquito season?

→ Texas Wildlife Guides
→ About US Wildlife Dispatch

Industrial & B2B

YKWiki — Steel grade reference with international equivalents. Find the matching grade across ASTM, EN, JIS, GB, and IS standards.

→ Steel Grade Database
→ About YKWiki

Propprose — Engineering plastics reference and injection molding alarm code diagnostics. Material properties, processing parameters, and machine troubleshooting.

→ Engineering Plastics
→ About Propprose

LowersHVAC — Commercial HVAC error code diagnostics. Look up fault codes for chillers, rooftop units, VRF systems, and scroll chillers.

→ HVAC Error Codes
→ About LowersHVAC

PermaRoofing — Commercial roofing product specifications. TPO, EPDM, PVC, shingles, and metal roofing data with insurance documentation guidance.

→ Roofing Specifications
→ About PermaRoofing

Career

YourCareerGPT — Career strategy guides. Salary negotiation, career change planning, remote job search, and reviews of AI job search tools.

→ Career Guides

All websites are free to use. Data comes from publicly available government and industry sources.

DEV Community: bob jin