# docs

organized knowledge base - check here before researching.

structure:
- **frontend/** - svelte 5 state patterns, ui components, navigation
- **backend/** - config system, background tasks, database, transcoder
- **deployment/** - environments, migrations, fly.io
- **tools/** - logfire queries, neon mcp, pdsx cli, plyr.fm mcp
- **local-development/** - setup guide for new contributors
- **moderation/** - copyright detection, sensitive content, ATProto labeler
- **lexicons/** - ATProto record schemas (track, like, comment, list, profile)
- **runbooks/** - operational procedures for production incidents
- **testing/** - pytest patterns, parallel execution, template databases

when you solve a problem or make a design choice, document it here with as much detail as needed