SpeakTrue

SpeakTrue Repository Engineering Deep-Dive Reference

Last updated: 2026-06-29

Purpose and usage

This is a single-entry deep index for first-time engineers and cross-surface contributors. It is meant to answer:

Scope

One-time orientation checklist

Repository governance and verification map

Run this sequence before major changes:

  1. Identify changed files and their upstream/downstream surfaces.
  2. Inspect contracts and migration implications.
  3. Update source files + tests + migration/docs in the same pass.
  4. Validate with:
    • feature-level tests on the touched surface,
    • backend function tests,
    • regression scripts in scripts/,
    • and git diff --check.

Deployment and runbook anchors

Change playbooks

Speech and voice generation changes

Soundboard changes

Auth/consent/onboarding changes

Exhaustive file-level behavior index

This section captures each file with important declarations/signatures and serves as a first-pass behavior map.

iOS + Android (swift, kotlin, tests, configs)

Declaration index for first-pass navigation; couple this with existing iOS/Android inventories and per-feature contract docs for deeper behavior interpretation.

iOS (Swift)

ios/SpeakTrueUITests/SpeakTrueUITests.swift

Backend (Supabase Edge Functions)

For full request/response semantics and policy behavior, use backend-functions-deep-dive.md and backend-functions-detailed-map.md in addition to this symbol index.

backend/supabase/functions/stt-transcribe/handler.ts

Web (Marketing + legacy Python runtime)

For legacy runtime behavior beyond this declaration index, consult web/python-web-app/docs and repository-onboarding-reference.md.

web/python-web-app/docs/SOUNDBOARD_CATEGORY_AND_ORDERING.md