Syzygy is a cross-platform mobile ecosystem — production-ready Foundation, UI, Core and Service libraries, plus starter templates, spanning iOS, Android, React Native, and Flutter.
The name comes from the astronomical term for when celestial bodies align — representing multiple platforms coming together into one cohesive, aligned ecosystem.
Every UI library ships with zero third-party dependencies and the same shared token system — colors, typography, spacing, radius — reproduced consistently across all four platforms, with full Dark Mode support built in from the start. Component naming and API shape stay deliberately consistent cross-platform (the same problem is solved the same way in SwiftUI, Jetpack Compose, React Native, and Flutter), and every repo shares the same CI pipeline and tag-gated release process.
Syzygy is a four-layer architecture. Each layer is independent and can be used without the others.
syzygy-ui-* syzygy-core-* syzygy-services-*
Presentation App infrastructure External world
│ │ │
└─────────────────┼─────────────────┘
│
syzygy-foundation-*
Contracts & primitives
- Foundation — contracts, primitives, shared types. Zero implementation. Every other layer depends on this.
- UI — visual component libraries with design tokens, theming, and dark mode. Zero business logic.
- Core — app infrastructure, navigation, DI, security, architecture utilities. (in progress)
- Services — networking, storage, analytics, OS integrations. (in progress)
Full architecture details: syzygy-ecosystem.md
SYZYGY
│
┌──────────▼──────────┐
│ SYZYGY FOUNDATION-* │
│ │
│ Primitives │
│ Contracts │
│ Shared types │
│ Errors │
└──────────┬──────────┘
│
┌───────────────┼────────────────┐
│ │ │
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌──────────┐
│ UI │ │ CORE │ │ SERVICES │
│ │ │ │ │ │
│ Visual │ │ App │ │ External │
│ system │ │ infra. │ │ world │
└────┬────┘ └────┬────┘ └─────┬────┘
│ │ │
└───────────────┼────────────────┘
│
▼
┌──────────────────┐
│ SYZYGY BASE APP │
└──────────────────┘
| Layer | iOS | Android | React Native | Flutter |
|---|---|---|---|---|
| UI | ✅ | ✅ | ✅ | ✅ |
| Foundation | ✅ | ✅ | ✅ | ✅ |
| Core | ⬜ | ⬜ | ⬜ | ⬜ |
| Services | ⬜ | ⬜ | ⬜ | ⬜ |
| Base App | 🚧 | 🚧 | 🚧 | 🚧 |
✅ Available · 🚧 In progress · ⬜ Not started
Primitives, contracts, shared types, errors — the base every other layer depends on.
- syzygy-foundation-ios — v1.0.0
- syzygy-foundation-android — v1.0.0
- syzygy-foundation-rn — v1.0.0
- syzygy-foundation-flutter — v1.0.0
Component libraries with design tokens, theming, and dark mode support.
- syzygy-ui-ios — Swift 6 · SwiftUI · v2.4.0
- syzygy-ui-android — Kotlin · Jetpack Compose · v2.4.0
- syzygy-ui-rn — React Native · TypeScript · v2.4.0
- syzygy-ui-flutter — Flutter · Dart · v2.4.0
App foundation — navigation, state management, dependency injection, and architecture utilities.
- syzygy-core-ios (coming)
- syzygy-core-android (coming)
- syzygy-core-rn (coming)
- syzygy-core-flutter (coming)
External world integrations — networking, storage, analytics, authentication, and OS services.
- syzygy-services-ios (coming)
- syzygy-services-android (coming)
- syzygy-services-rn (coming)
- syzygy-services-flutter (coming)
Production-ready starter that composes all four layers — Clean Architecture, DI wiring, feature scaffolding, and CI/CD.
Brand assets — logo, icon, banners, and color palette — are hosted in this repository under brand/. See BRAND_GUIDE.md for usage guidelines, clear space rules, minimum sizes, and correct/incorrect usage examples.
Color palette: Purple
#7F77DD · Teal
#1D9E75 · Coral
#D85A30
Typography: Sora for the wordmark and headings · Inter (or the platform system font — SF Pro on iOS, Roboto on Android) for body copy
Available assets:
syzygy-banner-dark/light— SVG, PNG (1200 · 2400px), WebPsyzygy-icon— SVG, PNG (32 · 192 · 512 · 1024px), WebP
Built and maintained by Ayush Kumar Sethi — Mobile Technical Architect with 15+ years across iOS, Android, React Native & Flutter.