Skip to documentation content

Repository ownership and contribution routing

Layout (accepted)

tunes          → charter, governance, research, methodology, schemas, open data
tunes-ios      → iOS recorder product
tunes-web      → landing, public map, upload/pipeline jobs (Next.js starter scaffold)

Flow:

tunes-ios  --derived uploads-->  tunes-web  --validated releases-->  tunes
tunes      --schema / methodology / licences-->  tunes-ios & tunes-web

Owns / does not own

ConcernOwnerNot owner
Project charter, ADRs, research programmetunesios, web
Open dataset releases & citationtunesios, web (may link/host UI)
Capture, offline reliability, alignment UXtunes-iostunes, web
Map runtime, cron/pipeline workerstunes-webtunes, ios
Canonical acoustic methodologytunesios/web link only

Contribution routing

  • Science / schema / licence / claim-language disputes → PR or ADR in tunes
  • Recorder bugs / capture UX → tunes-ios
  • Map / API / jobs → tunes-web
  • Cross-cutting privacy → ADR in tunes, then implement client (ios) and server (web)

Sibling checkout layout

Clone all three repos as siblings (same parent folder):

workspace/
  tunes/
  tunes-ios/
  tunes-web/
RepoRelative path (from tunes root)
tunes.
tunes-ios../tunes-ios
tunes-web../tunes-web

GitHub: tunes-org/tunes · tunes-ios · tunes-web

Recommendation

Do not reopen monorepo-vs-multi-repo; implement as three repos per ADR-003.

Confidence: High.

Depends on experiment/legal/user-test? No.

Links: project-charter.md; sibling READMEs in tunes-ios and tunes-web.