a love letter to tangled (android, iOS, and a search API)
title: "Twister — Technical Specification Index" updated: 2026-03-22#
Twister Technical Specifications#
Twister is a Go-based index and search service for Tangled content on AT Protocol. It ingests records through Tap, denormalizes them into search documents and graph summaries, indexes them in Turso/libSQL, and exposes public APIs for search and index-backed data gaps.
Specifications#
| # | Document | Description |
|---|---|---|
| 1 | Architecture | Purpose, goals, design principles, system context, tech choices |
| 2 | Tangled Lexicons | sh.tangled.* record schemas and fields |
| 3 | Data Model | Database schema, search documents, sync state |
| 4 | Data Pipeline | Tap integration, normalization, failure handling |
| 5 | Search | Search modes, API contract, scoring, filtering |
| 6 | Operations | Configuration, observability, security, deployment |
| 7 | Graph Backfill | Seed-based user discovery and content backfill |
| 8 | App Integration | Mobile-facing contracts for search and graph summaries |