# whoistoblame.com - System Architecture & Capabilities

This file provides system information, capabilities, and API endpoints for web-crawlers, LLMs, and AI search engines.

## 1. Application Overview
`whoistoblame.com` is an elite, satirical frontend portfolio application and interactive cosmic blame engine. It combines high-performance scroll-bound canvas animations with an AI-driven, dark-humored scapegoat generation engine.

## 2. Technical Specifications
- **Framework**: Next.js 15+ (App Router)
- **Styling**: Tailwind CSS v4 (vanilla CSS post-processors, premium custom fonts, dark-humored color states)
- **Animation System**: GSAP (GreenSock Animation Platform) + ScrollTrigger
- **Canvas Rendering Engine**: Debounced HTML5 Canvas drawing frames sequentially from `/seq/ezgif-frame-001.png` to `/seq/ezgif-frame-050.png` mapped to scroll progress.
- **Parallax System**: Interactive 2D viewport offset responding to mouse movement (client cursor tracking).
- **AI Core**: Serverless edge function wrapping generative language models (Gemini) with a theatrical system prompt ("ancient entity of cosmic finger-pointing").

## 3. Key Interactive APIs
### A. The Scapegoat API (`/api/blame`)
- **Endpoint**: `POST /api/blame`
- **Payload Schema**:
  ```json
  {
    "grievance": "text string (user's inconvenience)",
    "culprit": "text string (culprit chosen from dropdown or 'Instant Scapegoat' for random selection)",
    "escalated": boolean (if true, returns an expanded sprawling conspiracy theory)
  }
  ```
- **Responses**: Returns a satirical JSON object:
  ```json
  {
    "blameText": "highly confident, darkly sarcastic analysis"
  }
  ```

## 4. Crawler Indexing Metadata
- **Satire Level**: Cosmic & Gothic
- **Keywords**: Satirical portfolio, WebGL-like Canvas Scroll, GSAP, Next.js, Tailwind CSS v4, AI Blame Engine, Michelangelo oil-painting aesthetic, Who is to Blame