How watashi199/purgeq works
PurgeQ is a browser extension for managing shared FACEIT player banlists. A user signs in through the popup, manages bans there or from FACEIT player cards, and sees cached ban data highlighted on FACEIT pages; popup changes are relayed to open tabs. Supabase provides authentication, shared-list data and server-side protections, while the hosted auth page mediates Discord OAuth and Turnstile. The README also documents import/export, settings, account-data controls and localization. Several backend and popup capabilities are documented but their implementations were not sampled, so those links are documented or left unverified.
Main entry points: supabase.ts Supabase client · popup.tsx Popup manager · banlist-store.ts Banlist data layer · service-worker.ts Background worker
Components 19
Extension experience
- Popup manager
extension/src/popup/popup.tsx
Extension runtime
- Inline ban actions
extension/src/content/content-script.ts - Background worker
extension/src/background/service-worker.ts - Banlist data layer
extension/src/shared/banlist-store.ts - User settings
extension/src/shared/settings.ts - Extension localization
extension/src/shared/i18n.ts - Supabase client
extension/src/shared/supabase.ts - Database types
extension/src/shared/db.types.ts
Backend services
- Banlist database
supabase/migrations - Pro billing webhook
supabase/functions/stripe-webhook/index.ts
Hosted site
- Marketing site
landing - Auth bridge
landing/auth
Other components
- Extension user
- FACEIT pages
- Extension local storage
- Supabase platform
- Stripe
- Discord OAuth
- Cloudflare Turnstile
Connections 25
- Extension user → Popup manager: manages bans
README.md - FACEIT pages → Inline ban actions: hosts cards
README.md - Inline ban actions → Background worker: requests banlist
extension/src/content/content-script.ts - Background worker → Banlist data layer: reads and mutates
extension/src/background/service-worker.ts - Background worker → Inline ban actions: notifies tabs
extension/src/background/service-worker.ts - Popup manager → Banlist data layer: loads banlist
extension/src/popup/popup.tsx - Popup manager → User settings: loads settings
extension/src/popup/popup.tsx - Popup manager → Supabase client: authenticates
extension/src/popup/popup.tsx - Popup manager → Extension localization: translates UI
extension/src/popup/popup.tsx - User settings → Extension localization: uses language defaults
extension/src/shared/settings.ts - Banlist data layer → Supabase client: queries through
extension/src/shared/banlist-store.ts - Supabase client → Database types: types client
extension/src/shared/supabase.ts - Banlist data layer → Extension local storage: caches banlist
extension/src/shared/banlist-store.ts - User settings → Extension local storage: stores preferences
extension/src/shared/settings.ts - Supabase client → Extension local storage: persists session
extension/src/shared/supabase.ts - Supabase client → Supabase platform: connects to
README.md - Supabase platform → Banlist database: serves data
README.md - Banlist database → Database types: schema represented by
- Stripe → Pro billing webhook: sends events
supabase/functions/stripe-webhook/index.ts - Pro billing webhook → Banlist database: updates profiles
supabase/functions/stripe-webhook/index.ts - Extension user → Marketing site: visits
README.md - Supabase client → Auth bridge: launches auth flow
extension/src/shared/supabase.ts - Auth bridge → Cloudflare Turnstile: runs challenge
README.md - Auth bridge → Supabase platform: hands off OAuth
README.md - Supabase platform → Discord OAuth: uses OAuth
README.md