Extra Chill Users

Network-wide user management for the Extra Chill platform.

What It Does

Extra Chill Users handles everything about user identity across the network:

• Authentication — Login, registration, Google OAuth, token-based API auth
• Profiles — Avatars, badges, ranks, artist relationships
• Onboarding — Guided first-time user experience
• Membership — Lifetime membership validation (ad-free benefit)
• Notifications — Network-wide idempotent delivery receipts and digest preferences

How It Works

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   SIGNUP    │ ──▶ │  ONBOARD    │ ──▶ │   ACCESS    │
│ Login/OAuth │     │  Profile,   │     │ All network │
│ Turnstile   │     │  Avatar     │     │   sites     │
└─────────────┘     └─────────────┘     └─────────────┘

Users sign up once and get access to all Extra Chill network sites with a unified identity.

Features

Auth Flow

1. Registration — Email/password or Google OAuth with Turnstile captcha
2. Login — Returns access + refresh tokens for API clients
3. Refresh — Token refresh for long-lived sessions
4. Cross-Domain — Network-wide authentication via multisite

REST API

All auth endpoints live in extrachill-api under extrachill/v1:

Requirements

• WordPress Multisite
• PHP 7.4+
• WordPress 5.0+
• Requires: extrachill-network, extrachill-api

Development

See AGENTS.md for technical implementation details.

# Build blocks
npm run build

# Package for distribution
homeboy review build extrachill-users

Documentation

• AGENTS.md — Technical reference for contributors
• docs/CHANGELOG.md — Version history
• docs/gardner-persona.md — Canonical nontechnical power-user test contract
• docs/notifications.md — Notification producer and receipt contracts