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

# Developer documentation

> Developer guide index for getbased: architecture, data model, AI surfaces, feature internals, testing, deployment, and release gates.

# Developer documentation

getbased is a native ES module web app with no app bundler. It still uses npm for tests, type checks, Playwright, and deployment helpers.

If you are new here, start with [CONTRIBUTING.md](https://github.com/elkimek/get-based/blob/main/CONTRIBUTING.md) for setup, local runs, tests, and PR guidelines. Use this section when you need implementation details that are too technical for the user guides.

## Start here

| Page                                                       | Use it for                                                                   |
| ---------------------------------------------------------- | ---------------------------------------------------------------------------- |
| [Architecture](/developers/architecture)                   | How the app is structured, started, and deployed without bundling app source |
| [Module Reference](/developers/module-reference)           | Finding the JS module that owns a feature or window binding                  |
| [Cross-Module Patterns](/developers/cross-module-patterns) | Shared patterns: window exports, state access, dependency boundaries         |

## Data model and sync

| Page                                                         | Use it for                                                                        |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| [Data Pipeline](/developers/data-pipeline)                   | How `getActiveData()` builds the data used by charts and AI context               |
| [Storage Schema](/developers/storage-schema)                 | localStorage, importedData, IndexedDB, export/import, and Agent Access state      |
| [Sync and Delta Internals](/developers/sync-delta-internals) | Cross-device sync surfaces, tombstones, import snapshots, and merge rules         |
| [Context Assembly](/developers/context-assembly)             | How labs, context cards, wearables, notes, and Agent Access context are assembled |

## AI and agents

| Page                                                         | Use it for                                                                         |
| ------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| [AI Surfaces Map](/developers/ai-surfaces-map)               | Which features use AI and which are deterministic                                  |
| [AI Provider Internals](/developers/ai-provider-internals)   | Provider routing, private transports, Custom API proxying, OAuth, and web search   |
| [Agent Access Relay](/developers/agent-access-relay)         | Owner-bound encrypted context relay, setup payload, and local MCP decrypt behavior |
| [Local Lens Internals](/developers/lens-local-internals)     | In-browser Knowledge Base storage, chunks, embeddings, and worker behavior         |
| [Lens Endpoint Contract](/developers/lens-endpoint-contract) | Wire spec for an external Knowledge Source server                                  |

## Feature internals

| Page                                                   | Use it for                                                                         |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| [Biology Scores](/developers/biology-scores)           | Score engine, coverage planner, context gate, adapters, UI, and tests              |
| [Sun Spectrum Model](/developers/sun-spectrum-model)   | Bird-Riordan spectral reconstruction for Light sessions                            |
| [Wearables Internals](/developers/wearables-internals) | OAuth, local daily rows, synced summaries, runtime config, and Agent Access series |

## Operations and release checks

| Page                                                                 | Use it for                                                                        |
| -------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [Testing](/developers/testing)                                       | Test commands, browser specs, and how to add assertions                           |
| [Deployment](/developers/deployment)                                 | Vercel config, CSP, service worker, API routes, and PWA behavior                  |
| [Legal Consent](/developers/legal-consent)                           | First-launch Terms/Privacy gate, re-consent, startup ordering, and release checks |
| [Routstr/Cashu Safety](/developers/routstr-cashu-safety)             | Money-path invariants and required tests for wallet/node/session flows            |
| [Codex PR Coverage Workflow](/developers/codex-pr-coverage-workflow) | PR review and coverage workflow for agent-assisted changes                        |

## Maintenance rule

When adding a user-visible feature, update both sides in this repo:

* the user guide that explains what the feature does and how to use it;
* the developer page that explains storage, sync, privacy, tests, and owner modules.

Do not create a second long-lived docs surface in the app repository. The app repo may keep executable tests and temporary notes; durable docs belong here.