GitHunt
SA

SadiEncoded/DIC-Blood-Bank

A high-performance, real-time blood donor management platform built for speed, safety, and community impact. Designed with a FAANG-level aesthetic and powered by a fully reactive data layer.

๐Ÿฉธ DIC Blood Bank: Real-Time Lifesaving Network

Tech Stack
Design
Status

A high-performance, real-time blood donor management platform built for speed, safety, and community impact. Designed with a FAANG-level aesthetic and powered by a fully reactive data layer.


โœจ Core Pillars

1. ๐Ÿš€ Global Real-Time Hub

Every interaction is live. No refreshes. No delays.

  • Learn Feed: Educational articles sync instantly across all clients.
  • Community Wall: Official notices and announcements appear in real-time.
  • Matched Donors: Live availability and verification status updates during the search process.

2. ๐Ÿ›ก๏ธ Admin Command Center

A centralized dashboard for mission-critical operations.

  • Live Verification Pipeline: Review donation proofs as they arrive.
  • Dynamic Content Management: Draft, publish, and toggle articles/events with instant global updates.
  • Impact Metrics: Watch "Lives Saved" and "Pending Requests" counters tick up in real-time.

3. ๐Ÿง  Smart Match Engine

Triangulates the perfect donor for every critical need.

  • Location-Aware Scanning: Filters donors by proximity and urgency.
  • Admin Verification Bridge: Every donor request is held in a secure queue until manually reviewed and approved by an administrator to prevent abuse.
  • Safety-First Routing: Multi-layered validation checks (Protocol Simulation + Admin Oversight + Social Proof).
  • Stepped Workflow: A sleek, animated wizard guides requesters from data entry to contact.

๐Ÿ—๏ธ Technical Architecture

graph TD
    User((User)) -->|Next.js App| Frontend[Frontend: React/Next.js]
    Admin((Admin)) -->|Admin Console| Frontend
    
    Frontend -->|Real-time Subscriptions| Supabase[Supabase Realtime]
    Frontend -->|Server Actions| API[Auth & DB Actions]
    
    API -->|PostgreSQL| DB[(Cloud Database)]
    DB -->|CDC Events| Supabase
    
    Supabase -.->|Instant Updates| Frontend
Loading

Stack & Performance

  • Framework: Next.js (App Router, Server Components)
  • Database: Supabase (PostgreSQL + Realtime Engine)
  • Styling: Tailwind CSS + Framer Motion for 60fps micro-interactions
  • State: Reactive local state synced via Supabase Channels

๐Ÿ“ฑ Design Philosophy: "Mobile-First Premium"

We've optimized every pixel for the mobile experience, where seconds count.

  • Glassmorphic UI: Subtle blurs and semi-transparent layers for depth.
  • Tactile Feedback: Shake animations on form errors and smooth transitions between stages.
  • High-Contrast Accessibility: Bold typography and intentional whitespace for readability under pressure.

๐Ÿ› ๏ธ Setup & Implementation

  1. Environment Config:

    NEXT_PUBLIC_SUPABASE_URL=your_url
    NEXT_PUBLIC_SUPABASE_ANON_KEY=your_key
  2. Install Dependencies:

    npm install
  3. Run Dev Environment:

    npm run dev

๐Ÿ“„ Key Contributors & Impact

DIC Blood Bank is a community-driven initiative dedicated to bridging the gap between donors and patients. Every drop counts.

๐Ÿ‘จโ€๐Ÿ’ป Lead Developer

Sadi (SadiEncoded)
Full Stack Developer

Sadi is the architect behind the DIC Real-Time Network. With a focus on high-performance systems and FAANG-level aesthetics, he has transformed blood donation management into a seamless, lifesaving experience.

Follow Sadi on GitHub