Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

115 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VaxEvidence

Real-World Evidence platform for vaccine research scientists.

CI TypeScript Tests Next.js React Supabase License

Live Demo — No sign-up required. Pre-loaded with sample vaccine research data.

VaxEvidence Screenshot


Why This Exists

Vaccine researchers spend weeks manually assembling study protocols, screening literature, and formatting regulatory submissions. VaxEvidence automates the entire pipeline — from PICO protocol design through PRISMA systematic review to FDA/EMA export — in a single collaborative platform. This is not a todo app with a database; it is a domain-specific tool built for the regulatory complexity of health-tech.

Key Features

Feature What It Does
PICO Protocol Builder Structured study design with version history, diff viewer, and template library
PRISMA Screening Pipeline 4-stage systematic review with duplicate detection (DOI/PMID/fuzzy title)
Risk-of-Bias Assessment RoB 2 (RCTs) and ROBINS-I (observational) with traffic-light visualizations
Meta-Analysis Custom SVG forest plots with CI whiskers, subgroup analysis, pooled effects
Regulatory Exports FDA IND (21 CFR 312.23), eCTD Module 5 (ICH M4E), CDISC SDTM templates
Real-Time Collaboration Yjs CRDT editing, presence cursors, threaded comments with @mentions

Architecture

graph TB
    subgraph Client["Browser"]
        UI[React 19 + shadcn/ui]
        RQ[React Query v5]
        YJS[Yjs CRDT]
    end

    subgraph Server["Next.js 16 App Router"]
        PROXY[proxy.ts — Auth + Security Headers]
        API[76 API Routes]
    end

    subgraph Supabase
        AUTH[Auth — OAuth + Passwordless]
        PG[(PostgreSQL — 27 tables + RLS)]
        RT[Realtime — Broadcast + Presence]
        STOR[Storage]
    end

    subgraph External
        PUBMED[PubMed]
        CT[ClinicalTrials.gov]
        AI[OpenAI / Google AI]
    end

    UI --> RQ --> API
    YJS -->|Broadcast| RT
    PROXY --> API
    API --> PG
    API --> AUTH
    API --> PUBMED & CT & AI
Loading

See ARCHITECTURE.md for the full system design, data model, and design decisions.

Tech Stack

Layer Technology
Framework Next.js 16 (App Router), React 19, TypeScript (strict)
Styling Tailwind CSS v4, OKLCH color space, dark mode default
UI shadcn/ui (New York) + Radix UI + Lucide icons
Database Supabase (PostgreSQL + Auth + RLS + Storage)
Data Fetching @tanstack/react-query v5
Forms react-hook-form + Zod
Real-Time Yjs (CRDT) + Supabase Realtime (Broadcast + Presence)
AI Vercel AI SDK v6, OpenAI, Google AI
Exports jsPDF, docx, papaparse, exceljs, citation-js, archiver
Charts recharts + custom SVG (forest plots)
Monitoring Sentry (error tracking + source maps)
Testing vitest, Playwright
Package Manager pnpm

Quick Start

git clone https://github.com/VaxEvidence/vax-evidence-dev.git
cd vax-evidence-dev
pnpm install
cp .env.test.example .env.local   # Add your Supabase credentials
pnpm dev                          # http://localhost:3000

The demo mode at /demo works without Supabase credentials.

Testing

pnpm test              # ~1,400 unit tests + 51 benchmarks (vitest)
pnpm test:integration  # 60 integration tests against real Supabase
pnpm test:e2e          # 63 E2E tests (Playwright)
pnpm typecheck         # TypeScript strict mode
pnpm lint              # ESLint

Project Stats

Components       136    (55 shadcn/ui + 81 feature)
API Routes        76    (CRUD, export, search, AI, public REST API)
CRUD Modules      18    (one per domain table)
DB Tables         27    (+ RLS on all)
DB Migrations     23
Unit Tests     1,400+
Integration       60    (RLS policies, CRUD, data integrity)
E2E Tests         63    (Playwright)
Benchmarks        51    (perf regression detection)
Zod Schemas       11    (runtime validation)
Export Formats     9    (PDF, Word, CSV, Excel, ZIP, BibTeX, RIS, APA, MLA)

Honest Assessment

See ASSESSMENT.md for a candid evaluation of what works well, what doesn't, and known technical debt. No sugarcoating.

Documentation

Document Description
ARCHITECTURE.md System design, data model, design decisions
CONTRIBUTING.md Setup, conventions, PR process
SECURITY.md Security measures and limitations
ROADMAP.md Full product roadmap (12 phases complete)
ASSESSMENT.md Honest technical assessment
docs/ Performance benchmarks, PRDs, QA checklists

License

MIT

About

Production-grade Real-World Evidence platform for vaccine researchers. Next.js 16 · React 19 · Supabase · TypeScript. Features PICO protocol builder, PRISMA screening pipeline, RoB 2/ROBINS-I assessment, meta-analysis forest plots, real-time CRDT collaboration (Yjs), and FDA/EMA/CDISC regulatory exports. 76 API routes · 27 DB tables · 1,400+ tests.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages