# TrickBook Docs

> Technical documentation for the TrickBook mobile app and platform

## Docs

- [TrickBook Documentation](https://docs.thetrickbook.com/docs.md): Welcome to the TrickBook technical documentation. This site covers the architecture, development, and deployment of the TrickBook mobile app, website, backend services, and AI companions.
- [ADR-002: Kaori Fallback Chain](https://docs.thetrickbook.com/docs/architecture/adrs/kaori-fallback-chain.md): | Field | Value |
- [ADR-001: Native Google Sign-In](https://docs.thetrickbook.com/docs/architecture/adrs/native-google-signin.md): | Field | Value |
- [Data Flow](https://docs.thetrickbook.com/docs/architecture/data-flow.md): How data moves through the TrickBook application.
- [Kaori AI Architecture](https://docs.thetrickbook.com/docs/architecture/kaori.md): Deep-dive into how TrickBook's AI companion system works — one LLM brain serving three surfaces, a streaming voice sidecar, and a 3D body that acts out what she says.
- [Kaori System Audit (May 2026)](https://docs.thetrickbook.com/docs/architecture/kaori-audit-2026-05.md): Status May 2026
- [Architecture Overview](https://docs.thetrickbook.com/docs/architecture/overview.md): TrickBook follows a client-server architecture with a shared backend serving the mobile app, website, and Chrome extension. Real-time features are powered by Socket.IO, and an AI companion layer (Kaori) provides conversational assistance via tool-calling, RAG, and text-to-speech.
- [Repo Dependency Map](https://docs.thetrickbook.com/docs/architecture/repo-dependency-map.md): This page is the implementation-level dependency map for TrickBook across repositories.
- [Technology Stack](https://docs.thetrickbook.com/docs/architecture/tech-stack.md): Complete list of technologies used across the TrickBook platform.
- [API Endpoints](https://docs.thetrickbook.com/docs/backend/api-endpoints.md): Live route signatures from the backend implementation in /Users/weshuber/Reactnative/Backend/routes/*.js.
- [Authentication](https://docs.thetrickbook.com/docs/backend/authentication.md): TrickBook uses JWT-based authentication with Google SSO and Apple Sign-In.
- [Database](https://docs.thetrickbook.com/docs/backend/database.md): TrickBook uses MongoDB Atlas for data storage.
- [Backend Overview](https://docs.thetrickbook.com/docs/backend/overview.md): The TrickBook backend is a Node.js Express API with Socket.IO for real-time features. It serves the mobile app, website, and Chrome extension.
- [Security](https://docs.thetrickbook.com/docs/backend/security.md): Current security status and required improvements for the TrickBook backend.
- [Data Model](https://docs.thetrickbook.com/docs/chrome-extension/data-model.md): Understanding the data structures used by the Chrome extension and how they map to the TrickBook API.
- [Chrome Extension Overview](https://docs.thetrickbook.com/docs/chrome-extension/overview.md): The Skatepark Extractor for Google Maps is a Chrome extension that enables users to extract skate spot information directly from Google Maps and sync it to their TrickBook account.
- [App Store Deployment (iOS)](https://docs.thetrickbook.com/docs/deployment/app-store.md): Guide for deploying TrickBook to the Apple App Store via TestFlight.
- [Backend Deployment](https://docs.thetrickbook.com/docs/deployment/backend.md): Guide for deploying the TrickBook backend API.
- [CI/CD Pipeline](https://docs.thetrickbook.com/docs/deployment/ci-cd.md): Automated quality gates and deployment for all TrickBook repositories. Every PR must pass lint, typecheck, and tests before merge. Every merge to main triggers deployment.
- [Google Play Deployment (Android)](https://docs.thetrickbook.com/docs/deployment/google-play.md): Guide for deploying TrickBook to the Google Play Store via EAS Build and EAS Submit.
- [Infrastructure Overview](https://docs.thetrickbook.com/docs/deployment/infrastructure.md): Production deployment topology for the TrickBook platform.
- [Code Quality](https://docs.thetrickbook.com/docs/engineering/code-quality.md): Cleanup tasks to reduce technical debt and bring TrickBook to professional standards. These are the issues a senior engineer would flag in a code review.
- [Development Workflow](https://docs.thetrickbook.com/docs/engineering/development-workflow.md): This document outlines our standard process for making code changes to the TrickBook mobile app.
- [Error Handling & Monitoring](https://docs.thetrickbook.com/docs/engineering/error-handling.md): TrickBook currently has no error boundaries, no global error handler, and no production error tracking. One uncaught error crashes the entire mobile app with a white screen.
- [Linting & Formatting](https://docs.thetrickbook.com/docs/engineering/linting-formatting.md): TrickBook uses Biome for both linting and formatting across all repositories. One tool, one config, zero debate about semicolons.
- [Structured Logging](https://docs.thetrickbook.com/docs/engineering/logging.md): TrickBook uses console.log with ad-hoc [API] prefixes everywhere. There are 410+ console statements in the backend and 54+ in the mobile app. In production, these are unsearchable, unfilterable, and mix debug noise with actual errors.
- [Engineering Standards](https://docs.thetrickbook.com/docs/engineering/overview.md): Baseline engineering standards for the TrickBook project. These apply to all repositories (TrickList, Backend, Website, Docs) and must be in place before any new feature work.
- [Pre-commit Hooks](https://docs.thetrickbook.com/docs/engineering/pre-commit-hooks.md): Pre-commit hooks prevent broken code from being committed. Every commit is automatically checked for lint errors, formatting issues, and type errors before it enters git history.
- [Testing Strategy](https://docs.thetrickbook.com/docs/engineering/testing.md): TrickBook currently has zero tests across 98+ mobile source files and 24 backend route files. This document defines the testing strategy and the first tests to write.
- [AI Companions](https://docs.thetrickbook.com/docs/features/ai-companions.md): Status 2026-07-12
- [Animation System](https://docs.thetrickbook.com/docs/features/ai-companions/animation-system.md): Status TrickList/src/components/companion/
- [The Board Model](https://docs.thetrickbook.com/docs/features/ai-companions/board-model.md): Status TrickList/src/components/companion/KaoriStage.tsx
- [Mobile App Surfaces](https://docs.thetrickbook.com/docs/features/ai-companions/mobile-app.md): Status: Audited against code 2026-07-12 · repo TrickList, branch v2-rebuild
- [Motion Framework](https://docs.thetrickbook.com/docs/features/ai-companions/motion-framework.md): Status: Designed 2026-07-28 · code audited against TrickList/src/components/companion/ · game-industry claims adversarially verified (20 confirmed / 5 refuted, sources inline)
- [Motion Capture Pipeline](https://docs.thetrickbook.com/docs/features/ai-companions/motion-pipeline.md): Status: Researched 2026-07-12 · sources cited inline; costs verified against vendor pricing pages
- [RAG & Internal Tools](https://docs.thetrickbook.com/docs/features/ai-companions/rag-and-tools.md): Status: Current state audited + architecture researched 2026-07-12
- [Web App Surfaces](https://docs.thetrickbook.com/docs/features/ai-companions/web-app.md): Status: Audited against code 2026-07-12 · repo TrickBookWebsite (Next.js, pages router)
- [Homies](https://docs.thetrickbook.com/docs/features/homies.md): Social networking and friend connections for action sports riders.
- [Media](https://docs.thetrickbook.com/docs/features/media.md): Video streaming platform featuring The Couch (curated films) and Feed (user content).
- [Notifications](https://docs.thetrickbook.com/docs/features/notifications.md): Status Wes / Claude pair · Last updated: 2026-06-14
- [Features Overview](https://docs.thetrickbook.com/docs/features/overview.md): Comprehensive documentation for TrickBook's core features.
- [Spots](https://docs.thetrickbook.com/docs/features/spots.md): Community-driven skate spot and action sports location database.
- [Spots Map](https://docs.thetrickbook.com/docs/features/spots-map.md): The interactive map that lets riders explore, add, tag, and save action-sports spots — the primary discovery surface of the Spots feature.
- [Trickipedia](https://docs.thetrickbook.com/docs/features/trickbook.md): The trick encyclopedia and personal trick list management system.
- [User Feedback Log](https://docs.thetrickbook.com/docs/feedback/user-feedback-log.md): Real feedback from TrickBook users. This log helps us prioritize features and track what users actually want.
- [API Integration](https://docs.thetrickbook.com/docs/mobile/api-integration.md): The mobile app uses a typed API layer in src/lib/api/* and a shared HTTP client in src/lib/api/client.ts.
- [Build Configuration](https://docs.thetrickbook.com/docs/mobile/build-configuration.md): TrickBook uses EAS (Expo Application Services) for building and deploying native apps.
- [Navigation](https://docs.thetrickbook.com/docs/mobile/navigation.md): TrickBook uses Expo Router for file-based navigation, similar to Next.js. Routes are defined by the file system structure in the app/ directory.
- [Mobile App Overview](https://docs.thetrickbook.com/docs/mobile/overview.md): The TrickBook mobile app is built with React Native, Expo SDK 54, and TypeScript. It uses Expo Router for file-based navigation and NativeWind for Tailwind CSS styling.
- [State Management](https://docs.thetrickbook.com/docs/mobile/state-management.md): TrickBook uses Zustand for auth state, React Query for server state, and React Context for theming.
- [v2.0.0](https://docs.thetrickbook.com/docs/releases/v2.0.0.md): Release Date: February 2026
- [v3.0.0 — The Social Update](https://docs.thetrickbook.com/docs/releases/v3.0.0.md): Release Date: March 2026
- [v3.1.0 -- Google Play Launch and Stability](https://docs.thetrickbook.com/docs/releases/v3.1.0.md): Release Date: May 2026
- [AI Companion Tool Calling](https://docs.thetrickbook.com/docs/roadmap/ai-companion-tools.md): Status: Shipped (2026) — implemented as kaori-tools.js in TB-Backend with 8 tools on Gemini Flash via OpenRouter; see Kaori AI Architecture for the live system. This document is preserved as the original plan.
- [Chrome Extension Integration Plan](https://docs.thetrickbook.com/docs/roadmap/chrome-extension-integration.md): This document outlines the plan to fully integrate the Map Scraper Chrome extension into the TrickBook ecosystem, enabling seamless spot discovery and sharing across all platforms.
- [Companions Launch Audit](https://docs.thetrickbook.com/docs/roadmap/companions-launch.md): Status: Audited 2026-07-09 · everything below verified against live prod + the merged code
- [Efficiency Improvements](https://docs.thetrickbook.com/docs/roadmap/efficiency-improvements.md): Recommendations for faster workflows and production deployments.
- [Gap Analysis](https://docs.thetrickbook.com/docs/roadmap/gap-analysis.md): Audit taken early 2026 — preserved as-is for historical reference. See the Status update at the bottom for what has changed since.
- [Mobile App Rebuild Plan](https://docs.thetrickbook.com/docs/roadmap/mobile-app-rebuild.md): Complete plan for rebuilding the TrickBook mobile app with new design
- [Mobile Design Prompt](https://docs.thetrickbook.com/docs/roadmap/mobile-design-prompt.md): NanoBananaPro design specifications for the TrickBook mobile app
- [Monetization: Paywall & Tokens](https://docs.thetrickbook.com/docs/roadmap/monetization.md): Status: Proposed 2026-07-09 — ready to build · researched against July-2026 store rules and live COGS
- [Priority Roadmap](https://docs.thetrickbook.com/docs/roadmap/priorities.md): Status launch the companions behind a paywall, then iterate — more tricks, more companions, better UX everywhere.
- [Security Fixes](https://docs.thetrickbook.com/docs/roadmap/security-fixes.md): Detailed guide for addressing security vulnerabilities in TrickBook.