Skip to content

CapitolTrace/capitoltrace-ui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 

Repository files navigation

🏛️ Capitol Trace UI

Open-source React frontend for civic intelligence.
80+ pages of legislative analytics, built for transparency.

Live React Vite Tailwind


Status: Coming Soon — We're extracting the public frontend from the Capitol Trace monorepo. Star this repo to get notified when it drops.


What's in here

The complete React frontend that powers capitoltrace.com — 80+ pages of congressional intelligence, from member dossiers to NatSec dashboards.

🔍 Intelligence

  • Rep Dossiers — 538 member profiles with 17 data sections (votes, trades, donors, ideology, lobbying, demographics)
  • Signal Intelligence — AI-detected correlations between stock trades, votes, and lobbying activity
  • NatSec Dashboard — 7 live feeds: CISA cyber threats, ACLED conflict, satellite tracking, GDELT global monitoring

💰 Follow the Money

  • Money Map — Interactive US map covering all 535 districts
  • Stock Watch — Congressional trading monitor with STOCK Act compliance scoring
  • The Lobby — Senate LDA filings, FARA foreign agents, revolving door tracker

🗳️ Civic Engagement

  • The SCIF — Shadow Congress gamification (vote on real bills, 7-tier rank system, 25 badges)
  • Education Hub — 30+ interactive civics lessons embedded across every page
  • Take Action — Voter registration, call scripts, election tools via Google Civic API

Tech stack

Layer Tech
Framework React 18 with lazy-loaded routes
Build Vite 6 with code-splitting
Styling Tailwind CSS (dark theme, responsive)
State React hooks + Supabase real-time
Auth Supabase Auth with RBAC (admin/team/user)
Testing Vitest (1,835+ unit) + Playwright (128 E2E)
SEO react-helmet-async, JSON-LD, dynamic OG images, prerendering

Project structure

src/
  components/       # 199 React components
  utils/            # 85 utility modules
  hooks/            # Custom hooks (useRole, useSession, useTour)
  contexts/         # Theme, Language, Session, Tour providers
  App.jsx           # 79 route declarations
e2e/                # 128 Playwright E2E tests
__checks__/         # 31 Checkly health checks

Getting started

git clone https://github.com/CapitolTrace/capitoltrace-ui.git
cd capitoltrace-ui
npm install --legacy-peer-deps
cp .env.example .env   # Add your API keys
npm run dev             # http://localhost:5173

Contributing

We welcome contributions! Whether it's fixing a bug, improving accessibility, or adding a new data visualization — PRs are open.

  • Check Issues for good first issues
  • Follow the existing component patterns (Tailwind dark theme, lazy-loaded routes)
  • All PRs require passing unit tests + E2E

License

MIT — use it, fork it, build on it. Democracy deserves open-source tools.


Part of the Capitol Trace ecosystem.
capitoltrace.com

About

Open-source React frontend for Capitol Trace — civic intelligence UI components, 80+ pages of legislative analytics

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors