Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexzhirkevich/compose-cupertino
Compose Multiplatform UI components for iOS (Cupertino Widgets)
https://github.com/alexzhirkevich/compose-cupertino
compose compose-ios compose-multiplatform cupertino-widgets ios sf-symbols
Last synced: about 1 month ago
JSON representation
Compose Multiplatform UI components for iOS (Cupertino Widgets)
- Host: GitHub
- URL: https://github.com/alexzhirkevich/compose-cupertino
- Owner: alexzhirkevich
- License: apache-2.0
- Created: 2023-05-04T19:40:39.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-10-29T20:11:07.000Z (about 1 month ago)
- Last Synced: 2024-10-29T22:44:19.246Z (about 1 month ago)
- Topics: compose, compose-ios, compose-multiplatform, cupertino-widgets, ios, sf-symbols
- Language: Kotlin
- Homepage:
- Size: 3.41 MB
- Stars: 1,095
- Watchers: 21
- Forks: 39
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- mobile-awesome - compose-cupertino - Compose Multiplatform UI components for iOS (Cupertino Widgets). (Multiplatform / Android samples)
README
# Compose Cupertino
[](https://github.com/JetBrains/compose-multiplatform)
[](https://github.com/JetBrains/compose-jb)
https://github.com/alexzhirkevich/compose-cupertino/assets/63979218/982485e8-c581-4c0e-8302-0cb257acd892
Compose Cupertino is a Kotlin Multiplatform library for the [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform) UI framework.
It provides various UI components for making native-looking iOS applications, including
- `cupertino` - Compose Multiplatform implementation of iOS-like Cupertino theme and widgets, based on compose.foundation. Inspired by compose.material3 and SwiftUI APIs;
- `cupertino-native` - UIKit native wrappers for Cupertino Widgets. Allows to seamlessly use some UIKit widgets for iOS and their equivalents from cupertino for other platforms;
- `cupertino-adaptive` - adaptive theme and wrappers for Cupertino and Material3 widgets. Allows to seamlessly use both widgets from shared code with correct content color and font style;
- `cupertino-icons-extended` - more than 800 most used monochrome [Apple SF Symbols](https://developer.apple.com/sf-symbols/) as Compose ImageVectors.
These symbols are copyrighted. Please read licence agreement first.
If you don't need these icons for platform other than iOS, you can use ios bundled icons using converters from cupertino-native.
- `cupertino-decompose` - iOS-like swipe-back animation for the 'predictive back' navigation feature of the [Decompose](https://github.com/arkivanov/Decompose) library + `NativeChildren` wrapper over `UINavigationController`.
Provides native-feeling or truly native page transitions and swipe gestures.
## Installation
[](https://maven-badges.herokuapp.com/maven-central/io.github.alexzhirkevich/cupertino)
> [!IMPORTANT]
> The project is in the experimental phase. All APIs can change incompatibly or be dropped without the deprecation cycle!
Add the dependency to your `build.gradle.kts` file.
| Module | Dependency |
|----------------------------|---------------------------------------------------------------|
| `cupertino` | `io.github.alexzhirkevich:cupertino:` |
| `cupertino-native` | `io.github.alexzhirkevich:cupertino-native:` |
| `cupertino-adaptive` | `io.github.alexzhirkevich:cupertino-adaptive:` |
| `cupertino-decompose` | `io.github.alexzhirkevich:cupertino-decompose:` |
| `cupertino-icons-extended` | `io.github.alexzhirkevich:cupertino-icons-extended:` |
# Usage
To use iOS-like widgets with Compose Cupertino and view available components, see [Cupertino](docs/Cupertino.md).
To use widgets that change based on the platform (looking like either Material You or iOS) and view available
components, see [Adaptive](docs/Adaptive.md).
# License
```
Copyright (c) 2023 Compose Cupertino project and open source contributors.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```