Syzygy Hub

This repository is the Syzygy-Hub organisation infrastructure. It is the single source of truth for brand assets, engineering standards, README templates, reusable CI workflows, and lint tooling across every Syzygy repo.

---

Org Profile — profile/

profile/README.md is the public-facing Syzygy-Hub GitHub organisation page — the page visitors see at github.com/Syzygy-Hub.

---

Brand — brand/

Logo, icon, banners, color palette, and typography guidelines.

• brand/ — all asset files (SVG, PNG, WebP in all sizes)
• brand/BRAND_GUIDE.md — usage rules, clear space, do/don't

---

Engineering Standards — engineering/standards/

The canonical rules every Syzygy repo follows.

• readme-standard.md — the README rhythm, section order, badge format, voice rules
• changelog-standard.md — Keep a Changelog format, entry style, unreleased section
• release-standard.md — release trigger format, tag convention, pre-release checklist, multi-platform order
• repository-standard.md — naming convention, syzygy.yml manifest, branch and commit format

---

Ecosystem Architecture — engineering/architecture/

The definitive description of how the Syzygy layers fit together.

• syzygy-ecosystem.md — full layer diagram, dependency rules, what belongs (and doesn't) in each layer, platform support matrix

Individual repo READMEs do not reproduce the ecosystem diagram. They link here.

---

README Templates — engineering/templates/

Copy the appropriate template when creating a new Syzygy repo.

• README-foundation.md — for syzygy-foundation-*
• README-ui.md — for syzygy-ui-*
• README-core.md — for syzygy-core-*
• README-services.md — for syzygy-services-*
• README-base.md — for syzygy-base-*
• syzygy.yml.template — the repo manifest template

---

Lint Tooling — engineering/tooling/

Canonical lint and analysis configs. Consuming repos store a local copy under tooling/{platform}/ and CI fetches the canonical version fresh on each run.

• engineering/tooling/ios/.swiftlint.yml
• engineering/tooling/android/.editorconfig
• engineering/tooling/rn/.eslintrc.json + .prettierrc
• engineering/tooling/flutter/analysis_options.yaml

---

Reusable CI Workflows — .github/workflows/

Platform-specific GitHub Actions workflows called by individual repos via workflow_call.

• ios-ci.yml — build, SwiftLint, test, optional coverage summary
• android-ci.yml — build, ktlint, test, optional JaCoCo coverage summary
• rn-ci.yml — typecheck, lint, test, optional Jest coverage summary
• flutter-ci.yml — analyze (--fatal-warnings), test, optional lcov coverage summary

Coverage is informational only — no threshold enforcement. Results appear in the GitHub Actions job summary.