# HiBoop - LLM Context File
# Version: 2.6
# Last Updated: 2026-05-11
# Purpose: Provide comprehensive context for AI assistants working on HiBoop platform

---

## May 2026 i18n Hardening & Asset Standardization
- **i18n-Aware SEO**: `useSeo.ts` composable updated to be fully locale-aware, dynamically handling `og:locale` and generating localized breadcrumbs and canonical URLs.
- **fr-CA Locale Standard**: The entire site, including glossaries and SEO metadata, is standardized on `fr-CA` (Quebec French).
- **Asset Standardization**: All `<img>` tags and legacy `<Image>` components have been migrated to the standardized `<AppImage>` component.
- **Mock Data Handling**: Untranslatable strings in mockups and visual components are wrapped in `v-text` or `{{ '...' }}` to bypass i18n checks.
- **Compliance Gate**: A new `i18n-compliance.spec.ts` unit test programmatically enforces i18n best practices.

---

## May 2026 Memory Hardening
- **Heap Limits**: Standardized on 12GB (`--max-old-space-size=12288`) for all local dev, build, and test scripts to prevent OOM crashes.
- **Process Management**: `scripts/dev-safe.sh` aggressively cleans up orphaned processes (`nuxt`, `vite`, `esbuild`) before startup.
- **Vitest**: Configured with `singleFork: true` and `maxWorkers: 1` to stabilize memory usage during test execution.

---

## Company Overview

### Basic Information
- **Company**: HiBoop Inc.
- **Industry**: Digital Mental Health Technology / Healthcare SaaS
- **Founded**: 2023 (concept), operational 2024, full launch 2025+
- **Headquarters**: 2031 Store St, Victoria, BC, V8T 5L9, Canada
- **Website**: https://hiboop.com
- **Contact**: hello@hiboop.com | +1 (778) 400-3524

### Mission & Vision
**Mission**: Transform mental healthcare by making mental health assessments accessible, accurate, and actionable through innovative technology that empowers both healthcare providers and patients.

**Vision**: Enable a holistic approach to life-changing therapies, treatments, and medications that was never before possible at scale, recognizing that mental health conditions often coexist and should be addressed comprehensively rather than in isolation.

**Origin**: Born from the founders' personal experiences navigating mental health care complexities.

---

## Product & Core Features

### Primary Product
**HiBoop Digital Assessment Platform** - A comprehensive measurement-based care (MBC) platform for mental health assessments

### Key Capabilities
1. **103+ Validated Clinical Assessments**
   - DSM-5 aligned (preparing for DSM-6)
   - Automated scoring with instant reports
   - Evidence-based, scientifically validated tools
   - Substance use, mood, trauma, PTSD, ADHD, autism, eating disorders, suicide risk, recovery capital

2. **Clinical Workflow Integration**
   - 75% reduction in assessment administration time
   - Real-time progress tracking and outcome monitoring
   - Percentage change analysis for patient outcomes
   - Automated follow-ups and configurable alerts
   - Works on any device (responsive web platform)
   - Zero Footprint (cloud-native, no installs required)

3. **Measurement-Based Care (MBC)**
   - Active Continuity Protocol approach (2026 pivot)
   - Emphasizes discovery and lifecycle data vs. administration
   - Tracks patient progress over time with objective metrics
   - Evidence-based treatment recommendations
   - Collaborative care features with clinician-ready dashboards

4. **Site-Wide Clinical Search**
   - **Pagefind** static search engine (built post-deployment)
   - Real-time indexing of clinical insights, assessments, and help center
   - Hybrid fallback to **Nuxt Content v3** queryCollection in dev mode

---

## Technical Architecture

### Tech Stack
- **Frontend**: Nuxt 4.4.2 (Vue 3.5.32, Tailwind CSS 4.2.2, DaisyUI 5.5.19)
- **Hosting**: Firebase Hosting + Cloud Functions Gen 2
- **Node.js**: 22.12.0+
- **Package Manager**: pnpm 10.12.4
- **CMS**: **Nuxt Content v3 + Nuxt Studio** (Git-based CMS)
- **Styling**: DaisyUI 5.5.19 + Tailwind CSS 4.2.2
- **Error Tracking**: Sentry (@sentry/nuxt 10.47.0)
- **Icons**: Phosphor icons via `@nuxt/icon` (ph:*)

### Key Visual Components (Hardened Clinical Intelligence)
1. **ClinicalResourceWall** (Home): Calmed "Boom/Batton" ticker with "Warm Liquid Soul" gradients.
2. **WarmPulseGrid** (What): Andromeda-style celestial chart constellation.
3. **BlueprintFlowGrid** (How): Isometric pipeline visualizing process flow.
4. **GrowthGrid** (Pricing): Isobaric topographical map visualizing rising value.
5. **ClinicalHorizon** (Who): Low-poly digital landscape with winding river of care.
6. **TrustRadar** (Trust): Rotating conic radar scan with stationary security blips.
7. **WarmTextureBackground**: Generic "soul" underlay for secondary pages.

### Build Commands
```bash
pnpm dev                # Dev server on port 3000
pnpm build:firebase     # Build for Firebase + Pagefind indexing
pnpm deploy            # Build + deploy to production
pnpm test:all          # Run all compliance + unit tests
```

---

## Design System Guidelines

### DaisyUI 5 Components
- **Standardized across 50+ pages**: 1,356 DaisyUI class instances
- **Most used**: Button (333), Badge (179), Card (169), Stats (159)
- **Custom additions**: `.badge-soft` for soft badge variant
- **Score**: 8.5/10 DaisyUI 5 compliance

### Component Patterns
1. **IconWatermarkCard** - Reusable card with layered watermark icon
   - 160px centered icon with 3-layer depth effect
   - 8% base opacity, -12° rotation
   - Used 70+ times across 11 pages

2. **ComparisonGrid** - Clean 2-column product comparison tables on /vs/ pages
   - Always-open FAQ grid (no accordion) with icon+label headers
   - Competitor comparison pages: /vs/trac9/, /vs/osmind/, /vs/eleos/

3. **Scroll Animations** - Intersection Observer-based
   - `useScrollAnimation()` composable
   - Respects `prefers-reduced-motion`
   - Data attributes: `data-scroll-animate`, `data-scroll-delay`

4. **Glass UI Polish** (2026)
   - Glass scrollbars (transparent with primary hover)
   - Brand-aware text selection colors (`primary/20`)
   - "Blur-In" global image loading plugin for smooth unblurring

### Visual Design Principles
- **Spacing**: Tailwind's 4px grid system (0, 1, 2, 3, 4, 6, 8, 12, 16, 20, 24...)
- **Icons**: Phosphor only (no emojis)
- **Colors**: DaisyUI OKLCH theme system
- **Typography**: Fraunces (h1 only), System fonts for body text
- **Buttons**: Global `whitespace-nowrap` to prevent text wrapping

---

## SEO & Content Strategy

### Dynamic Discovery
- **Help Center Sitemap**: `/api/sitemap/help` fetches KB content dynamically.
- **Structured Data**: 
  - `TechArticle` for help articles with `dateModified`.
  - `MedicalWebPage` for clinical documentation.
  - `MedicalTest` for assessment calculators.
- **Article Metadata**: Visual "Last Updated" timestamps and "Related Resources" linking.

### Content Model
- **Nuxt Content v3 Collections**: insights, stories, assessments, help
- **Active Continuity**: Messaging pivot from "Administration" to "Discovery".

---

## Version History
- **v2.5** (2026-04-08): Migrated from Sanity to Nuxt Content v3 + Nuxt Studio. Replaced GROQ search with Pagefind (singleton WASM) and local dev fallback. Updated DaisyUI/Tailwind versions.
- **v2.4** (2026-03-02): 103+ assessment pages, /vs/ competitor pages (Trac9/Osmind/Eleos), /hiqo/ clinical intelligence, /sources/ citations, CLS fix, RB2B + Customer Match enrichment, DaisyUI v5 cleanup, dep security fixes
- **v2.3** (2026-01-31): Hardened Clinical Overhaul, Site-wide GROQ search, Sentry integration, KB SEO upgrade, Glass UI polish
- **v2.2** (2026-01-29): Technical improvements - error tracking infrastructure, breach notification config, logo animation, dependency updates
- **v2.1** (2026-01-23): Added Vue transition requirements, navigation debugging tools, page structure best practices
- **v2.0** (2026-01-23): Added Pokemon card design, competitive landscape, 2026 brand voice, SEO strategy
- **v1.0** (2026-01-16): Initial comprehensive context file

---

**Note**: This file should be automatically loaded by AI assistants when starting work on the HiBoop project. Update this file whenever core brand strategy, technical architecture, or key workflows change.