tyiuandClaude Sonnet 5
c00f124b28
README: drop the stale Skip attribution line (the project moved to Kotlin Multiplatform entirely; the "Kotlin Multiplatform" line below it already covers the current tooling) and fix the stated minimum Android version — androidApp's actual minSdk is 24 (Android 7.0), not 10.0. AGENTS.md: a navigation/orientation doc for AI agents, focused on the things that aren't obvious from reading the code or that took real trial-and-error to establish this session — the localization architecture constraint (no synchronous, cross-platform way to resolve a moko-resources string outside Compose/Apple, so shared code must return data, not sentences), the Swift-interop plain-function convention, per-platform currency-data quirks (web's ICU-dependent currency list, missing color-emoji font), and the verification workflow for each platform (especially that Compose for Web renders to a <canvas>, so headless Chrome + specific GL flags is the way to actually see a change, not DOM inspection). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01FXcrACM5sok3M1KQJ8kByy
88 lines
4.2 KiB
Markdown
88 lines
4.2 KiB
Markdown
<div align="center">
|
||
|
||
<img src="./docs/assets/satsprice-logo.png" alt="SatsPrice Logo" title="SatsPrice logo" width="256"/>
|
||
|
||
# SatsPrice
|
||
|
||
This app fetches the price of Bitcoin relative to common fiat currencies from multiple sources, and converts inputted amounts between Sats, BTC, and the selected fiat currency.
|
||
|
||
[](https://github.com/tyiu/sats-price/releases)
|
||
|
||
[](https://github.com/tyiu/sats-price)
|
||
[](/LICENSE)
|
||
|
||
## Download and Install
|
||
|
||
[<img src="./docs/assets/download_on_apple.svg"
|
||
alt="Download on the Apple App Store"
|
||
height="70">](https://apps.apple.com/app/satsprice/id6478230475)
|
||
[<img src="./docs/assets/download_on_zapstore.svg"
|
||
alt="Get it on Zap Store"
|
||
height="70">](https://github.com/zapstore/zapstore/releases)
|
||
[<img src="./docs/assets/download_on_obtainium.png"
|
||
alt="Get it on Obtaininum"
|
||
height="70">](https://github.com/ImranR98/Obtainium)
|
||
[<img src="./docs/assets/download_on_github.svg" alt="Get it on GitHub"
|
||
height="70">](https://github.com/tyiu/sats-price/releases)
|
||
|
||
## Supported Platforms
|
||
|
||
iOS 16.0+ • macOS 13.0+ • Android 7.0+
|
||
|
||
## Kotlin Multiplatform
|
||
|
||
This is a Kotlin Multiplatform project targeting Android, iOS, Web, Desktop (JVM).
|
||
|
||
* [/iosApp](./iosApp/iosApp) contains an iOS application. Even if you’re sharing your UI with Compose Multiplatform, you
|
||
need this entry point for your iOS app. This is also where you should add SwiftUI code for your project.
|
||
|
||
* [/shared](./shared/src) is for code that will be shared across your Compose Multiplatform applications. It contains
|
||
several subfolders:
|
||
- [commonMain](./shared/src/commonMain/kotlin) is for code that’s common for all targets.
|
||
- Other folders are for Kotlin code that will be compiled for only the platform indicated in the folder name. For
|
||
example, if you want to use Apple’s CoreCrypto for the iOS part of your Kotlin app,
|
||
the [iosMain](./shared/src/iosMain/kotlin) folder would be the right place for such calls. Similarly, if you want
|
||
to edit the Desktop (JVM) specific part, the [jvmMain](./shared/src/jvmMain/kotlin)
|
||
folder is the appropriate location.
|
||
|
||
### Running the apps
|
||
|
||
Use the run configurations provided by the run widget in your IDE's toolbar. You can also use these commands and
|
||
options:
|
||
|
||
- Android app: `./gradlew :androidApp:assembleDebug`
|
||
- Desktop app:
|
||
- Hot reload: `./gradlew :desktopApp:hotRun --auto`
|
||
- Standard run: `./gradlew :desktopApp:run`
|
||
- Web app:
|
||
- Wasm target (faster, modern browsers): `./gradlew :webApp:wasmJsBrowserDevelopmentRun`
|
||
- JS target (slower, supports older browsers): `./gradlew :webApp:jsBrowserDevelopmentRun`
|
||
- iOS app: open the [/iosApp](./iosApp) directory in Xcode and run it from there.
|
||
|
||
### Running tests
|
||
|
||
Use the run button in your IDE's editor gutter, or run tests using Gradle tasks:
|
||
|
||
- Android tests: `./gradlew :shared:testAndroidHostTest`
|
||
- Desktop tests: `./gradlew :shared:jvmTest`
|
||
- Web tests:
|
||
- Wasm target: `./gradlew :shared:wasmJsTest`
|
||
- JS target: `./gradlew :shared:jsTest`
|
||
- iOS tests: `./gradlew :shared:iosSimulatorArm64Test`
|
||
|
||
## Attribution
|
||
|
||
This project uses [Kotlin Multiplatform](https://www.jetbrains.com/help/kotlin-multiplatform-dev/get-started.html),
|
||
[Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform/#compose-multiplatform), and
|
||
[Kotlin/Wasm](https://kotl.in/wasm/).
|
||
|
||
The [Bitcoin Calculator](https://www.flaticon.com/free-icons/bitcoin-calculator) icon was created by Icon home and licensed as free for personal and commercial use with attribution.
|
||
|
||
The following free APIs are used:
|
||
- Coinbase
|
||
- [Get Exchange Rates](https://docs.cdp.coinbase.com/coinbase-app/docs/api-exchange-rates#get-exchange-rates)
|
||
- [Get Spot Price](https://docs.cdp.coinbase.com/coinbase-app/docs/api-prices#get-spot-price)
|
||
- CoinGecko
|
||
- [Coin Price by IDs](https://docs.coingecko.com/reference/simple-price)
|
||
|
||
</div> |