Repository navigation
v1.0.0 | Initial Release
π Synapse Social v1.0.0 β Initial Release
First stable release of Synapse Social: a cross-platform social media app built on "Native UI, Shared Logic."
π¦ What's Included
This inaugural release ships the full KMP stack across all four targets, with Supabase powering auth, realtime messaging, and storage.
π€ Android (:app) β commonMain + androidMain
- β 100% Jetpack Compose UI (zero XML)
- β
Clean Architecture + MVVM, one ViewModel per screen holding
StateFlow<UiState> - β Hilt dependency injection
- β
MaterialTheme.colorScheme,Spacing, andstringResource()β no hardcoded values - β Rich media posts: images, video (ExoPlayer), markdown rendering
- β Real-time chat via Supabase Realtime subscriptions
- β X-style threaded comments with inline replies
- β Group chat with AI-powered smart replies (Gemini SDK)
- β Encrypted local storage & secure auth flows
π iOS (iosApp) β commonMain + iosMain
- β 100% SwiftUI UI
- β
ObservableObjectViewModels with@Publishedand@MainActor - β
IosSecureStoragefor Keychain-backed sensitive data - β Native iOS look and feel β no cross-platform UI compromises
- β Real-time chat, threads, group chat, rich media parity with Android
π» Desktop (desktop)
- β Compose for Desktop target
- β
Shares
:sharedbusiness logic, networking, and data layer - β Native desktop windowing and input handling
π Web (web)
- β Kotlin/Wasm target
- β Browser-native delivery
- β Shared networking (Ktor), database caching (SQLDelight), and domain models
π§© Shared Core (:shared)
- β Kotlin Multiplatform shared module
- β
Domain: pure data class models, repository interfaces, one
operator fun invoke()per UseCase returningResult<T> - β
Data: DTOs mirroring external schema, mandatory mappers (
toDomain()), repository impls orchestrating DataSources - β
DI: Koin, exposed to iOS via
DependencyContainer - β Backend independence: all Supabase SDK calls (GoTrue auth, Realtime channels, Storage) encapsulated in the data layer; domain remains 100% provider-agnostic
β¨ Features at a Glance
| Area | Highlight |
|---|---|
| π§© Architecture | Clean Architecture + MVVM, KMP shared module |
| π¨ UI | Jetpack Compose (Android), SwiftUI (iOS), Compose Desktop, Kotlin/Wasm |
| π¬ Messaging | Real-time chat, threaded comments, group chat |
| π€ AI | Gemini-powered smart replies in group chat |
| π₯ Media | Image, video (ExoPlayer), and markdown post rendering |
| π Security | Encrypted local storage, Keychain (iOS), secure auth |
| βοΈ Backend | Supabase auth, realtime, storage β fully encapsulated |
π οΈ Get Started
git clone https://github.com/synapseSRC/synapseApp.git
cd synapseApp
# Android
./gradlew :app:installDebug
# iOS (macOS)
open iosApp/iosApp.xcodeproj
# Desktop
./gradlew :desktop:run
# Web
./gradlew :web:wasmJsBrowserDevelopmentRunNative UI. Shared Logic. Real-time everything. β‘
Built with β€οΈ by the StudioAs Inc. team