The Technology

Engineering guided by divine vision.

Trinetra is a purpose-built platform: QR identity, real-time alerts, live GPS, and a hardened backend, designed from the ground up for one of the world's largest human gatherings.

Core Pillars

Eight systems, one seamless shield

Each pillar is a discrete, independently scalable layer. Together they form the infrastructure that reunites families in minutes.

QR Identity System

Every devotee receives a unique QR code. A single scan retrieves their profile, photo, and family contact from an indexed database lookup, with the finder needing no login to identify them.

Unique per personInstant lookupNo login to scanWristband + printout

Real-time Alerts

The moment a QR is scanned, Firebase Cloud Messaging fires push notifications to every registered family device. In-app banners mirror the push so no alert is missed, even on low-spec handsets.

FCM pushIn-app bannerDelivery receiptRetry on failure

Live GPS Navigation

Finders and volunteers broadcast their precise location. Families see a live dot on Google Maps and can start turn-by-turn navigation to the reunion point with one tap.

Live broadcastGoogle MapsTurn-by-turnVolunteer pins

Secure Backend

FastAPI with async Python handles every request. JWTs with short expiry govern session tokens, bcrypt-hashed credentials, and per-endpoint rate limiting prevent abuse at any crowd scale.

FastAPI asyncJWT authRate limitingRole-based access

Cloud Storage

Profile photos and printed QR images are stored on dedicated object storage (S3), kept separate from the application database. Access follows the same role checks that gate the rest of the platform.

Object storage (S3)Photo uploadsRole-gated accessSeparate from DB

Payments via Razorpay

Families pay the per-person registration fee through Razorpay, in the app or in cash at a booth. Each online payment is signature-verified server-side before a registration is confirmed, and every transaction is tracked for admins.

Razorpay SDKSignature verifiedTransaction trackingCash or online

Three-language Support

Every screen, notification, and printed card is available in English, Hindi, and Marathi. The language is set once at registration and persisted across app and web.

EnglishहिंदीमराठीPersisted preference

Mobile via Capacitor, PWA-ready

The Android app is built on Capacitor, wrapping the same Next.js codebase so web and native share one source of truth. A service worker powers installable PWA delivery and background push, while booth, gate, and parking locations are cached on-device so the map stays usable when the signal dips.

Capacitor shellPWA installPush via FCMCached map dataAndroid APKWeb fallback
Architecture

Layered by design, resilient by nature

Five clean tiers from device to data, each with a single responsibility. Role-based access gates every interaction.

Client Layer
Web app (Next.js) + Android (Capacitor) + Booth kiosks
Next.js 15Capacitor AndroidPWA installBooth Kiosk
Trinetra API
FastAPI · async Python · JWT auth · rate limiting
FastAPIJWT + bcryptRate limiterRole router
Services Layer
Firebase FCM · Google Maps · Razorpay
Firebase FCMGoogle Maps SDKRazorpay API
Data Layer
MySQL · Object storage (photos + QR files)
MySQLObject Storage (S3)
JWT auth on every request
Async end-to-end
Role-gated routes

Role-based access

Citizen

Register, QR, alerts, GPS

Operator

Booth management, scans

Supervisor

Zone oversight, stats

Volunteer

Location broadcast, scan

Admin

Full platform control

Built for the Real World

Millions of users. Patchy network. Three languages. It still works.

A pilgrimage crowd is not a controlled environment. Towers get overwhelmed, devices are three years old, and half a million people may be on-site at the same moment. Trinetra was stress-designed for these exact conditions, not retrofitted for them.

  • Async FastAPI handles many concurrent requests without blocking on slow work.
  • Per-endpoint rate limiting protects the API from overload and abuse at crowd scale.
  • Lightweight pages keep load times low even on slower on-ground connections.
  • Booth, gate, and parking locations are cached on-device so the map survives signal gaps.

Built to scale

Composed of independently scalable, battle-tested building blocks.

BackendAsync FastAPI
AuthJWT + bcrypt
Abuse controlRate limited
NotificationsFirebase FCM
LanguagesEN · हि · मर
By the Numbers
0+

Core system pillars

0

Role tiers

0

Languages

0h

JWT session expiry

Partner with engineering built for the sacred and the serious

Whether you represent a government body, NGO, or technology sponsor, Trinetra is designed to integrate, scale, and serve with you.