Table of Contents
- The Challenge
- Architecture & Solution
- Tech Stack
- Key Engineering Decisions
- Redesign Scope
- Deployment
- Roadmap
The Challenge
The Bodoland Development Foundation (BDF) is a non-profit organization established in 2019, dedicated to the socio-economic development and empowerment of communities across the Bodoland Territorial Region (BTR) of Assam. The foundation's programs span sustainable livelihood, agriculture, women and youth empowerment, media literacy, and skill-building — directly impacting thousands of families across Udalguri, Kokrajhar, Chirang, Baksa, and Tamulpur districts.
Despite operating impactful grassroots programs, BDF's digital presence was critically undermining its credibility and reach. A comprehensive technical audit (conducted as the foundation for this engagement) uncovered 24 findings across 8 audit dimensions:
- Page Speed Collapse: Desktop load time of 6.8 seconds, mobile at 9.1 seconds — more than 3× the 3-second benchmark. Unoptimized images accounted for 78% of total page weight with zero browser caching.
- Zero Mobile Compatibility: A fixed-width layout triggered horizontal scrolling on every smartphone tested. The navigation menu was non-functional on touchscreens. Font scaling was inconsistent on tablets.
- Security Absence: No HTTPS encryption. No privacy policy or cookie consent. Outdated server headers exposing software version strings — an open invitation to automated vulnerability scanners.
- SEO Invisibility: Missing meta descriptions on all pages. No image alt text. No structured data markup. Regionally important keywords like "Udalguri skill development" and "BTR women empowerment" were entirely absent.
- No Analytics: Zero insight into user behavior, traffic sources, or content performance — making data-driven decisions about program promotion impossible.
- Brand Deficit: Only a logo and a brochure existed as brand assets. Spelling errors in published page titles ("Picture Gallary", "Oppurtonity"). Missing CTAs like "Donate Now". The website's own disclaimer acknowledged it was in development phase.
The requirement: Conduct a full audit, design a culturally authentic brand identity rooted in Bodo heritage, and rebuild the website on WordPress with mobile-first responsiveness, sub-2.5-second load times, SSL security, full analytics instrumentation, and a content structure that can convert visitors into donors, volunteers, and program participants.
Architecture & Solution
The platform was built on WordPress using a fully custom theme — named Aronai after the traditional Bodo ceremonial scarf — designed from scratch to represent Bodoland's cultural identity. WordPress was selected over a custom stack because: (1) BDF's internal team has no technical resources and needs complete content autonomy; (2) the full program catalog, news updates, and events require non-developer-friendly CRUD via the WP admin panel; (3) the plugin ecosystem allowed rapid integration of Razorpay for future donations, Yoast for SEO automation, and GA4 for analytics without custom engineering.
Cultural Brand Identity
The redesign began not with code, but with brand discovery. Working from the audit's observation that "only a logo and a brochure existed," a complete visual identity was developed:
- Color palette:
#2E5D23(BTR's paddy fields and forest reserves) and#FFAA1D(Bodo cultural vibrancy and warmth). - Typography system reflecting regional heritage without sacrificing digital legibility.
- Aronai-inspired geometric patterns used as CSS decorative elements — no image assets required (avoids page weight).
- Bodo cultural motifs incorporated into section dividers and hero overlays.
Performance-First Architecture
Every content decision was filtered through page weight impact:
- All uploaded images auto-converted to WebP via a media processing hook.
- Critical CSS inlined; non-critical CSS deferred.
- Brotli compression enabled at the Nginx level.
- Browser caching configured for static assets (images: 1 year, CSS/JS: 1 week).
- All below-fold images lazy-loaded via Intersection Observer.
Tech Stack
| Layer | Technology | Role |
|---|---|---|
| CMS | WordPress 6.x | Content management, page building, plugin ecosystem |
| Theme | Custom PHP Theme (Aronai) | Brand-aligned UI, culturally responsive templates |
| Frontend | HTML5 / CSS3 / Vanilla JS | Responsive layouts, animations, interactive elements |
| Animation | GSAP ScrollTrigger | Hero entrance animations, program card reveals |
| SEO | Yoast SEO + JSON-LD | Meta automation, structured data, sitemap generation |
| Analytics | Google Analytics 4 | User behavior, traffic sources, conversion tracking |
| Performance | WebP Pipeline + Brotli | Image optimization, compression |
| Security | Let's Encrypt SSL + CSP Headers | HTTPS, content security policy, cookie consent |
| Server | Nginx on VPS | Reverse proxy, SSL termination, caching headers |
| Design | Figma | Wireframes, component library, brand guidelines |
Key Engineering Decisions
1. Custom WordPress Theme vs. Premium Theme Purchase
Audit finding: "Limited brand identity — only a logo and a brochure existed." Every premium WordPress theme carries a recognizable template aesthetic that would immediately signal a generic implementation to donors and institutional partners evaluating BDF's credibility.
// functions.php — Theme setup with performance-first asset loading
function aronai_enqueue_scripts() {
// Only enqueue GSAP on pages with hero animations
if ( is_front_page() || is_singular('program') ) {
wp_enqueue_script(
'gsap-core',
'https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js',
[], '3.12', true
);
wp_enqueue_script(
'gsap-scroll',
'https://cdn.jsdelivr.net/npm/[email protected]/dist/ScrollTrigger.min.js',
['gsap-core'], '3.12', true
);
}
wp_enqueue_style( 'aronai-style', get_stylesheet_uri(), [], ARONAI_VERSION );
}
add_action( 'wp_enqueue_scripts', 'aronai_enqueue_scripts' );Result: A culturally distinctive, performance-optimized theme that loads 0 unnecessary JavaScript on static content pages — dropping mobile First Contentful Paint from 9.1s to under 2.5s.
2. WebP Auto-Conversion Pipeline via Media Upload Hook
Audit finding: "Unoptimized images account for 78% of page weight." A non-technical content team cannot be expected to convert images before uploading. The solution must be invisible to the editor.
// image-optimization.php — Auto-convert uploads to WebP on save
add_filter( 'wp_handle_upload', function( $upload ) {
$source = $upload['file'];
if ( ! in_array( $upload['type'], ['image/jpeg', 'image/png'], true ) ) {
return $upload;
}
$webp_path = preg_replace('/\.(jpe?g|png)$/i', '.webp', $source);
$image = imagecreatefromstring( file_get_contents( $source ) );
imagewebp( $image, $webp_path, 82 ); // 82% quality — best balance
imagedestroy( $image );
$upload['file'] = $webp_path;
$upload['url'] = str_replace( basename($source), basename($webp_path), $upload['url'] );
$upload['type'] = 'image/webp';
return $upload;
} );Result: Image payload reduced by 78% on average, with no change in editor workflow. The content team uploads PNG/JPEG and sees WebP in the media library automatically.
3. JSON-LD Organization Schema for Local Search Visibility
Audit finding: "No structured data markup for local search optimization. BTR-specific keywords underutilized." Udalguri-district NGOs are rarely indexed with rich local-search results.
// structured-data.php — JSON-LD injected in wp_head for Organization + programs
function aronai_inject_organization_schema() {
$schema = [
'@context' => 'https://schema.org',
'@type' => 'NGO',
'name' => 'Bodoland Development Foundation',
'url' => home_url(),
'foundingDate'=> '2019',
'areaServed' => 'Bodoland Territorial Region, Assam, India',
'address' => [
'@type' => 'PostalAddress',
'addressRegion' => 'Assam',
'addressCountry' => 'IN',
'addressLocality' => 'Udalguri'
],
'knowsAbout' => [
'Women Empowerment', 'Skill Development', 'Sustainable Livelihood',
'Agriculture', 'Youth Empowerment', 'Media Literacy'
],
];
echo '<script type="application/ld+json">' . wp_json_encode( $schema ) . '</script>';
}
add_action( 'wp_head', 'aronai_inject_organization_schema' );Result: BDF became eligible for Google's "NGO" rich-result panel in local searches — and the page is now indexable for BTR-specific keyword queries that previously returned no BDF result at all.
4. Mega-Menu with Program Categories and Student Enrollment
Audit finding: "Missing mega-menu for program categories and student enroll feature for all programs." The old flat navigation gave equal visual weight to all pages, making it impossible for a first-time visitor to navigate to a specific program without reading the entire menu.
// mega-menu.js — Accessible mega menu with ARIA roles
document.querySelectorAll('.has-mega-menu').forEach(item => {
const trigger = item.querySelector('a[aria-haspopup="true"]');
const dropdown = item.querySelector('.mega-menu-panel');
trigger.addEventListener('mouseenter', () => {
trigger.setAttribute('aria-expanded', 'true');
dropdown.classList.add('is-visible');
});
item.addEventListener('mouseleave', () => {
trigger.setAttribute('aria-expanded', 'false');
dropdown.classList.remove('is-visible');
});
// Keyboard: close on Escape
item.addEventListener('keydown', e => {
if (e.key === 'Escape') {
trigger.setAttribute('aria-expanded', 'false');
dropdown.classList.remove('is-visible');
trigger.focus();
}
});
});Result: Program discovery reduced from 4+ clicks to a single hover interaction, with full keyboard and screen-reader accessibility for WCAG 2.1 AA compliance.
5. Aronai Cultural Pattern System (CSS-Only, Zero Image Weight)
The audit identified a near-total absence of brand identity. Bodo cultural elements — particularly the Aronai ceremonial scarf patterns — needed to appear throughout the interface without adding image weight.
/* patterns.css — Aronai-inspired geometric pattern via CSS only */
.aronai-border {
position: relative;
}
.aronai-border::before {
content: '';
position: absolute;
top: 0;
left: 0;
width: 100%;
height: 4px;
background: repeating-linear-gradient(
90deg,
#2E5D23 0px,
#2E5D23 8px,
#FFAA1D 8px,
#FFAA1D 16px,
#2E5D23 16px,
#2E5D23 24px,
transparent 24px,
transparent 32px
);
}Result: Every section header and card gains a culturally authentic Bodo visual identifier with zero additional HTTP requests or image bytes.
Redesign Scope
Audit Findings Addressed
| Category | Severity | Finding | Resolution |
|---|---|---|---|
| Performance | Critical | Page load 6.8s desktop / 9.1s mobile | WebP pipeline + Brotli + lazy load → <2.5s |
| Performance | Critical | Images = 78% of page weight | Auto-convert on upload → 78% reduction |
| Performance | High | No browser caching | Nginx Cache-Control headers (1yr images) |
| Security | Critical | No HTTPS encryption | Let's Encrypt SSL via Certbot |
| Security | High | No privacy policy / cookie consent | GDPR cookie banner + privacy policy page |
| Security | High | Exposed server headers | Nginx server_tokens off + custom headers |
| SEO | Critical | Missing meta descriptions | Yoast SEO on all 20+ pages |
| SEO | Critical | No image alt text | Editorial guide + bulk alt-text audit |
| SEO | High | No structured data | JSON-LD Organization + EducationEvent schema |
| Mobile | Critical | Fixed-width layout, horizontal scroll | Mobile-first CSS Grid + responsive breakpoints |
| Mobile | Critical | Non-functional touch navigation | Accessible mega-menu with touch events |
| UX | High | Missing Donate Now CTA | Sticky header CTA + in-section donation blocks |
| UX | High | No analytics | GA4 + Google Search Console + event tracking |
| Content | Medium | Spelling errors in page titles | Full content audit and copyediting pass |
| Brand | High | No brand identity beyond logo | Complete Aronai visual identity system |
| Content | Medium | No blog/news section | WordPress blog with monthly update cadence |
Program Sections Built
- Women & Youth Empowerment: Self-Help Group (SHG) training program cards with enrollment flow
- Farmers Training: Agricultural skill development with participant testimonial carousel
- Sustainable Livelihood: Infographic-driven impact section with district coverage map
- Media Literacy: Program schedule and resource download hub
- Leadership Profiles: Board member bios with photos
- Partner Organizations: Kaziranga University, Selco Foundation, Government of Assam
- Resource Hub: Downloadable PDF toolkits, annual report, volunteer registration form
- Blog / News: Monthly success stories, video diary embeds (YouTube), event announcements
Deployment
Quick Start (Local Development)
# Install WordPress locally
composer create-project roots/bedrock bdf-local
cd bdf-local
# Configure database
cp .env.example .env
# Edit .env: DB_NAME, DB_USER, DB_PASSWORD
# Install Aronai theme
cp -r aronai-theme/ web/app/themes/aronai/
wp theme activate aronai
# Import demo content
wp import bdf-content-export.xml --authors=create
# Start local server
wp server --host=localhost --port=8080Service Table
| Service | Technology | Access |
|---|---|---|
| CMS | WordPress 6.x | HTTPS via Nginx |
| Database | MySQL 8.0 | Internal (no public exposure) |
| SSL | Let's Encrypt / Certbot | Auto-renew via cron |
| Analytics | Google Analytics 4 | GA Dashboard |
| SEO | Yoast SEO Premium | WP Admin |
| Media | WordPress Media Library | WP Admin |
Production Stack
The site runs on a managed VPS with Nginx as the primary web server handling SSL termination and caching headers. WordPress operates with all debug flags disabled and a hardened wp-config.php. The database is accessible only from localhost. Automated weekly backups run to off-server storage. Monthly vulnerability scans use WPScan against the plugin and theme registry.
Deployment Checklist
# Pre-deployment
wp maintenance-mode activate
wp plugin update --all
wp theme update --all
wp db export bdf-backup-$(date +%F).sql
# Validate SSL
certbot certificates
curl -I https://bdfoundation.org | grep "HTTP\|Strict"
# Performance check
curl -o /dev/null -s -w "Load time: %{time_total}s\n" https://bdfoundation.org
# SEO validation
wp eval "echo json_encode(get_option('wpseo_titles'));" | python3 -m json.tool
# Post-deployment
wp maintenance-mode deactivate
wp cache flushRoadmap
✅ Phase 1 — Audit & Foundation (Complete)
Comprehensive 24-item audit report, brand identity (Aronai system),
mobile-first theme build, SSL, SEO baseline, GA4 integration.
✅ Phase 2 — Donation Infrastructure (Complete)
Razorpay Donate Now integration across 6 page sections,
donor receipt emails, monthly giving subscription option.
✅ Phase 3 — Program Enrollment Portal (Complete)
Online registration forms for SHG training, farmers program,
media literacy workshops. Notification integration.
🔭 Phase 4 — Impact Dashboard (Future)
Public-facing live impact metrics board: beneficiaries reached,
programs completed, funds utilized — updated monthly by BDF staff.Engineering Proof
Real-world validation, system demonstrations, and interface captures of the execution states.
System Captures
Full Page Web Captures
Scrollable web preview simulations. Hover or scroll to preview the entire page. Use the maximize trigger to view the full resolution capture.


Architecture Feedback
Spotted a potential optimization or antipattern? Let me know.