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