a love letter to tangled (android, iOS, and a search API)
1---
2title: "Twister — Technical Specification Index"
3updated: 2026-03-22
4---
5
6# Twister Technical Specifications
7
8Twister is a Go-based index and search service for [Tangled](https://tangled.org) content on AT Protocol.
9It ingests records through [Tap](https://github.com/bluesky-social/indigo/tree/main/cmd/tap), denormalizes them into search documents and graph summaries, indexes them in [Turso/libSQL](https://docs.turso.tech), and exposes public APIs for search and index-backed data gaps.
10
11## Specifications
12
13| # | Document | Description |
14|---|----------|-------------|
15| 1 | [Architecture](01-architecture.md) | Purpose, goals, design principles, system context, tech choices |
16| 2 | [Tangled Lexicons](02-tangled-lexicons.md) | `sh.tangled.*` record schemas and fields |
17| 3 | [Data Model](03-data-model.md) | Database schema, search documents, sync state |
18| 4 | [Data Pipeline](04-data-pipeline.md) | Tap integration, normalization, failure handling |
19| 5 | [Search](05-search.md) | Search modes, API contract, scoring, filtering |
20| 6 | [Operations](06-operations.md) | Configuration, observability, security, deployment |
21| 7 | [Graph Backfill](07-graph-backfill.md) | Seed-based user discovery and content backfill |
22| 8 | [App Integration](08-app-integration.md) | Mobile-facing contracts for search and graph summaries |