Skip to content

chore: reorganise repo layout — apps/ subtree, CONTRIBUTING.md, PUBLISHING.md#11

Merged
happycodelucky merged 1 commit into
mainfrom
happycodelucky/peaceful-brattain-8fce7e
Jun 11, 2026
Merged

chore: reorganise repo layout — apps/ subtree, CONTRIBUTING.md, PUBLISHING.md#11
happycodelucky merged 1 commit into
mainfrom
happycodelucky/peaceful-brattain-8fce7e

Conversation

@happycodelucky

Copy link
Copy Markdown
Owner

Summary

  • Move the three sample apps into a shared apps/ directory (apps/ios, apps/macos, apps/android) to declutter the repo root and group platform projects together
  • Add mise run open:android task that opens the project root (where settings.gradle.kts lives) in Android Studio
  • Move docs/contributing.mdCONTRIBUTING.md at the repo root (GitHub surfaces this automatically on the repo home and PR pages)
  • Move docs/publishing.md.github/PUBLISHING.md (maintainer-only runbook, clearly scoped out of the public docs site)

What changed

Directory moves (via git mv, history preserved):

  • iOSApp/apps/ios/
  • macOSApp/apps/macos/
  • androidApp/apps/android/

Reference updates across the codebase:

  • mise.toml — task dir, run, and description fields for xcodeproj:ios, xcodeproj:macos, open:ios, open:macos, open:android (new), clean, lint:swift, format:swift
  • settings.gradle.ktsprojectDir for :androidApp now points at apps/android; Gradle project name is unchanged
  • .gitignore — xcodeproj ignore paths updated
  • CLAUDE.md — module layout table and SPM local-dev note
  • mkdocs.ymlcontributing.md and publishing.md removed from nav
  • All cross-links updated in: README.md, reachable/README.md, apps/ios/README.md, apps/macos/README.md, docs/installation.md, .github/workflows/ci.yml, .github/workflows/release.yml, gradle/libs.versions.toml

Reviewer notes

  • The Gradle :androidApp project name is intentionally preserved — changing it would be a breaking change for anyone running ./gradlew :androidApp:assembleDebug. Only projectDir was updated.
  • docs/check.py validates that every .md under docs/ appears in the mkdocs nav — since the files moved out of docs/, it won't flag them.
  • The macOSApp reference in docs/platforms/macos.md is the Xcode scheme name, not a directory path — correctly left unchanged.

…SHING.md

Move the three sample apps into a shared apps/ directory so platform
projects live alongside each other rather than cluttering the repo root:
  iOSApp/     → apps/ios/
  macOSApp/   → apps/macos/
  androidApp/ → apps/android/

Add a mise task `open:android` that opens the project root (where
settings.gradle.kts lives) in Android Studio.

Move contributor/maintainer docs out of the mkdocs public site:
  docs/contributing.md → CONTRIBUTING.md  (GitHub surfaces this automatically)
  docs/publishing.md   → .github/PUBLISHING.md  (maintainer-only runbook)

Update every reference: mise.toml task dirs and descriptions, settings.gradle.kts
projectDir, .gitignore xcodeproj ignore paths, CLAUDE.md module layout, mkdocs.yml
nav, and all cross-links in README, docs, workflow files, and per-app READMEs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@happycodelucky happycodelucky merged commit f359716 into main Jun 11, 2026
2 checks passed
@happycodelucky happycodelucky deleted the happycodelucky/peaceful-brattain-8fce7e branch June 11, 2026 15:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant