> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chromaflow.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Practical fixes for common issues: envs, builds, hooks, and integration edge cases.

# Troubleshooting

## Environment Variables

* Supabase keys may contain stray trailing characters (e.g., %). Trim values before use.
* Prefer FRODO\_SUPABASE\_URL and FRODO\_SUPABASE\_ANON\_KEY for local dev.

## Missing Dependencies

* Ensure both `nanostores` and `@nanostores/react` are installed to avoid state errors.

## Pre-commit Hooks in CI

* If CI reports “files were modified by this hook”, run:
  * pre-commit run --all-files
  * git add changed files
  * commit and push

## Backup Directories in CI

* Backup TypeScript files are validated by CI. Keep syntax correct across backups to prevent failures.

## Auth & Redirects

* Validate callback/logout URLs after environment changes
* Confirm BASE\_URL propagation to Auth0 config

See also: [Deployment](deployment), [Observability](sre-observability).