Skip to content

Commit c040ac7

Browse files
committed
v1.2.0
1 parent e0ef466 commit c040ac7

18 files changed

Lines changed: 107 additions & 74 deletions

File tree

.github/workflows/publish.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ on:
77
workflow_dispatch:
88
inputs:
99
tag:
10-
description: Existing release tag, for example v1.1.0
10+
description: Existing release tag, for example v1.2.0
1111
required: true
1212
type: string
1313

@@ -102,7 +102,7 @@ jobs:
102102
run: |
103103
gh release create "$RELEASE_TAG" \
104104
--verify-tag \
105-
--title "GuideKit $PROJECT_VERSION" \
105+
--title "GuideKit Compose $PROJECT_VERSION" \
106106
--notes-file release-notes.md \
107107
--latest
108108
env:

CHANGELOG.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,23 @@
11
# Changelog
22

3-
All notable changes to GuideKit will be documented in this file.
3+
All notable changes to GuideKit Compose will be documented in this file.
44

55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project follows semantic versioning.
66

7+
## [1.2.0] - 2026-08-24
8+
9+
### Library changes
10+
11+
- Updated Compose Multiplatform runtime, UI, and foundation dependencies from `1.10.0` to `1.11.1`.
12+
- Removed the unused Material Icons Extended dependency, reducing the library's dependency footprint.
13+
- Renamed the published Maven display name to GuideKit Compose while preserving the existing `io.github.tharukack:guidekit` coordinate and public Kotlin APIs.
14+
15+
### Project and documentation
16+
17+
- Renamed the public-facing product from GuideKit to GuideKit Compose across the README, documentation website, sample application, release titles, and package metadata.
18+
- Added an explicit requirements and compatibility table covering Kotlin, Compose Multiplatform, Material 3, Android `minSdk`, and supported iOS architectures.
19+
- Refreshed the documentation banner, social preview, screenshots, and animated demos with the GuideKit Compose branding.
20+
721
## [1.1.0] - 2026-07-23
822

923
### Library changes
@@ -17,7 +31,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
1731
- Expanded the sample tours with global theme demonstrations, arrow line and anchor variants, repeated targets, top-positioned instructions, arrow-free steps, and circular target highlights.
1832
- Moved the sample guides to the full-screen parent so overlays render above the smaller bottom navigation and the complete screen content.
1933
- Updated the README and website examples, customization guide, and API reference for the new step-override behavior.
20-
- Refreshed the documentation website with the latest demo GIFs and screenshots, a real-flow gallery, the GuideKit favicon, larger syntax-highlighted Kotlin examples, and improved mobile navigation and responsive layouts.
34+
- Refreshed the documentation website with the latest demo GIFs and screenshots, a real-flow gallery, the GuideKit Compose favicon, larger syntax-highlighted Kotlin examples, and improved mobile navigation and responsive layouts.
2135

2236
## [1.0.0] - 2026-07-22
2337

@@ -26,15 +40,15 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
2640
- Expanded the README with the same installation, full-screen parent setup, target-bounds callback, persistence, customization, and API guidance used by the website.
2741
- Replaced public arrow dash interval arrays with named presets directly in `GuideKitArrowLineStyle`: `Dotted`, `ShortDash`, `MediumDash`, `LongDash`, and `DashDot`.
2842
- Renamed the generic `Dashed` line style to `SpacedDash` to describe its visible spacing and distinguish it from the length-based dash presets.
29-
- Replaced public floating-point pixel sizes with integer styling values that GuideKit converts internally.
43+
- Replaced public floating-point pixel sizes with integer styling values that GuideKit Compose converts internally.
3044
- Replaced the separate single-phrase `descriptionHighlight` option with the unified `descriptionHighlights` list.
3145
- Changed `arrowHeadAngleDegrees` from a public `Float` to an `Int`, with conversion handled internally.
3246

3347
## [0.1.0] - 2026-07-16
3448

3549
### Added
3650

37-
- Initial Compose Multiplatform GuideKit library.
51+
- Initial GuideKit Compose library for Compose Multiplatform.
3852
- Coachmark overlay with target highlights, instruction cards, arrows, step indicators, skip/finish callbacks, and auto-scroll support.
3953
- Rounded rectangle and circular target highlight styles.
4054
- Per-step style overrides for arrows, target highlights, instruction cards, and auto-scroll behavior.

README.md

Lines changed: 34 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
<p align="center">
2-
<img src="docs/assets/guide_kit_logo_horizontal.png" alt="GuideKit" width="420" />
2+
<img src="docs/assets/logo_fav.png" alt="GuideKit Compose mark" width="92" />
33
</p>
44

5+
<h1 align="center">GuideKit Compose</h1>
6+
57
<p align="center">
68
<strong>Beautiful coach marks for Compose Multiplatform</strong>
79
</p>
@@ -11,7 +13,7 @@
1113
</p>
1214

1315
<p align="center">
14-
<a href="https://central.sonatype.com/search?q=guidekit"><img alt="Maven Central" src="https://img.shields.io/badge/Maven%20Central-1.1.0-1f6feb?style=for-the-badge" /></a>
16+
<a href="https://central.sonatype.com/search?q=guidekit"><img alt="Maven Central" src="https://img.shields.io/badge/Maven%20Central-1.2.0-1f6feb?style=for-the-badge" /></a>
1517
<img alt="Android" src="https://img.shields.io/badge/Android-supported-16A34A?style=for-the-badge&logo=android&logoColor=white" />
1618
<img alt="iOS" src="https://img.shields.io/badge/iOS-supported-2563EB?style=for-the-badge&logo=apple&logoColor=white" />
1719
<img alt="Kotlin Multiplatform" src="https://img.shields.io/badge/Kotlin%20Multiplatform-ready-7F52FF?style=for-the-badge&logo=kotlin&logoColor=white" />
@@ -28,27 +30,27 @@
2830
</p>
2931

3032
<p align="center">
31-
<img src="docs/assets/guide_kit_banner.png" alt="GuideKit banner" width="100%" />
33+
<img src="docs/assets/guide_kit_banner.png" alt="GuideKit Compose banner" width="100%" />
3234
</p>
3335

3436
---
3537

3638
## Live Demo
3739

3840
<p align="center">
39-
<img src="docs/assets/demo_3_1.gif" alt="GuideKit demo showing coach marks, arrows, and auto-scroll" width="320" />
41+
<img src="docs/assets/demo_3_1.gif" alt="GuideKit Compose demo showing coach marks, arrows, and auto-scroll" width="320" />
4042
&nbsp;&nbsp;&nbsp;
41-
<img src="docs/assets/demo_3_2.gif" alt="GuideKit demo showing alternate styling and circular highlights" width="320" />
43+
<img src="docs/assets/demo_3_2.gif" alt="GuideKit Compose demo showing alternate styling and circular highlights" width="320" />
4244
</p>
4345

4446
---
4547

4648
## Installation
4749

48-
Add GuideKit to the Compose Multiplatform source set where you want to show tours.
50+
Add GuideKit Compose to the Compose Multiplatform source set where you want to show tours.
4951

5052
```kotlin
51-
implementation("io.github.tharukack:guidekit:1.1.0")
53+
implementation("io.github.tharukack:guidekit:1.2.0")
5254
```
5355

5456
For Kotlin Multiplatform projects:
@@ -57,11 +59,25 @@ For Kotlin Multiplatform projects:
5759
kotlin {
5860
sourceSets {
5961
commonMain.dependencies {
60-
implementation("io.github.tharukack:guidekit:1.1.0")
62+
implementation("io.github.tharukack:guidekit:1.2.0")
6163
}
6264
}
6365
}
6466
```
67+
68+
### Requirements / compatibility
69+
70+
GuideKit Compose `1.2.0` is published with the following platform and dependency requirements:
71+
72+
| Requirement | Compatibility |
73+
| --- | --- |
74+
| Kotlin | `2.3.0` |
75+
| Compose Multiplatform | `1.11.1` |
76+
| Material 3 | `1.10.0-alpha05` |
77+
| Android | `minSdk 23` or newer |
78+
| iOS device | ARM64 (`iosArm64`) |
79+
| iOS simulator | Apple Silicon ARM64 (`iosSimulatorArm64`) |
80+
6581
---
6682

6783
## Quick Start
@@ -159,7 +175,7 @@ See the [`sample`](sample/) app for full configuration, styling, auto-scroll, ar
159175

160176
### Add multiple steps
161177

162-
Add one `GuideKitStep` for each composable you want to highlight. Every step receives the bounds measured from its own target composable, and the order of the list determines the order of the tour. GuideKit automatically handles next, previous, and finish navigation.
178+
Add one `GuideKitStep` for each composable you want to highlight. Every step receives the bounds measured from its own target composable, and the order of the list determines the order of the tour. GuideKit Compose automatically handles next, previous, and finish navigation.
163179

164180
The following example creates a three-step guide. `createButtonBounds`, `activityCardBounds`, and `profileButtonBounds` are measured and sent to the parent using the same callback pattern shown in the Quick Start.
165181

@@ -286,7 +302,7 @@ All ordinary override properties default to `null`, meaning “inherit the globa
286302

287303
### Customize step text
288304

289-
Each step requires a title and description. You can highlight one or more exact phrases and change the primary button label. When `primaryButtonText` is not provided, GuideKit uses **Next** and changes the final step to **Got it**.
305+
Each step requires a title and description. You can highlight one or more exact phrases and change the primary button label. When `primaryButtonText` is not provided, GuideKit Compose uses **Next** and changes the final step to **Got it**.
290306

291307
```kotlin
292308
GuideKitStep(
@@ -361,7 +377,7 @@ val specialStep = GuideKitStep(
361377
)
362378
```
363379

364-
GuideKit translates the selected `lineStyle` into its internal drawing pattern, so applications do not need to manage raw dash lengths or gaps.
380+
GuideKit Compose translates the selected `lineStyle` into its internal drawing pattern, so applications do not need to manage raw dash lengths or gaps.
365381

366382
| Arrow option | Default | Purpose |
367383
| --- | --- | --- |
@@ -527,7 +543,7 @@ The same pattern is available for nullable values such as `outerPadding`, size c
527543

528544
### Configure automatic scrolling
529545

530-
Auto-scroll is enabled for each step by default, but the host screen must provide `onScrollBy`. GuideKit calculates the required distance and delegates the actual scroll operation to your scroll state.
546+
Auto-scroll is enabled for each step by default, but the host screen must provide `onScrollBy`. GuideKit Compose calculates the required distance and delegates the actual scroll operation to your scroll state.
531547

532548
```kotlin
533549
val scrollState = rememberScrollState()
@@ -547,7 +563,7 @@ Tune or disable scrolling for an individual step:
547563
GuideKitStep(
548564
targetBounds = lowerCardBounds,
549565
title = "More options below",
550-
description = "GuideKit scrolls this target into a safe position.",
566+
description = "GuideKit Compose scrolls this target into a safe position.",
551567
autoScroll = GuideKitAutoScrollConfig(
552568
enabled = true,
553569
minTopVisibleDistance = 56.dp,
@@ -566,7 +582,7 @@ Use `GuideKitAutoScrollConfig(enabled = false)` for fixed targets such as a floa
566582

567583
### Configure navigation and callbacks
568584

569-
GuideKit owns the current step and its next, previous, skip, and finish behavior. The host app can choose the starting step, show or hide progress, observe changes, and persist completion.
585+
GuideKit Compose owns the current step and its next, previous, skip, and finish behavior. The host app can choose the starting step, show or hide progress, observe changes, and persist completion.
570586

571587
```kotlin
572588
GuideKit(
@@ -606,7 +622,7 @@ GuideKit(
606622
| `onSkipped` | `null` | Shows the close button and runs when the user skips. `null` removes skip. |
607623
| `onFinished` | Required | Runs when the primary button is pressed on the final step. |
608624

609-
Users can move back to the previous step by swiping the instruction card to the right. GuideKit consumes touches while the overlay is visible so the underlying screen is not activated accidentally.
625+
Users can move back to the previous step by swiping the instruction card to the right. GuideKit Compose consumes touches while the overlay is visible so the underlying screen is not activated accidentally.
610626

611627
---
612628

@@ -621,7 +637,7 @@ Users can move back to the previous step by swiping the instruction card to the
621637
| Instruction cards | Show titles, descriptions, highlighted text, buttons, and progress. |
622638
| Auto-scroll | Automatically scroll to keep targets visible and clear of the card. |
623639
| Per-step customization | Override arrows, highlights, cards, labels, and scrolling per step. |
624-
| Internal step management | GuideKit owns next, previous, skip, finish, and current step state. |
640+
| Internal step management | GuideKit Compose owns next, previous, skip, finish, and current step state. |
625641
| Callbacks | React to step changes, skipped tours, and completed tours. |
626642
| Compose Multiplatform | Shared Kotlin API for Android and iOS Compose apps. |
627643

@@ -655,7 +671,7 @@ Users can move back to the previous step by swiping the instruction card to the
655671

656672
## Contributing
657673

658-
Contributions are welcome. If you want to improve GuideKit, start with a small issue, bug report, or sample enhancement.
674+
Contributions are welcome. If you want to improve GuideKit Compose, start with a small issue, bug report, or sample enhancement.
659675

660676
Before opening a pull request:
661677

@@ -671,5 +687,5 @@ Before opening a pull request:
671687
MIT License. See [`LICENSE`](LICENSE).
672688

673689
<p align="center">
674-
<strong>GuideKit</strong> is built for developers who want onboarding to feel native, polished, and easy to maintain.
690+
<strong>GuideKit Compose</strong> is built for developers who want onboarding to feel native, polished, and easy to maintain.
675691
</p>

build.gradle.kts

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ plugins {
99
}
1010

1111
group = "io.github.tharukack"
12-
version = "1.1.0"
12+
version = "1.2.0"
1313

1414
kotlin {
1515
androidTarget {
@@ -35,7 +35,6 @@ kotlin {
3535
api(libs.compose.foundation)
3636
implementation(libs.compose.material3)
3737
implementation(libs.compose.material.icons.core)
38-
implementation(libs.compose.material.icons.extended)
3938
}
4039
commonTest.dependencies {
4140
implementation(libs.kotlin.test)
@@ -68,7 +67,7 @@ mavenPublishing {
6867
)
6968

7069
pom {
71-
name.set("GuideKit")
70+
name.set("GuideKit Compose")
7271
description.set(
7372
"A Compose Multiplatform coachmark overlay library for " +
7473
"product tours, onboarding hints, and guided feature discovery."

docs/assets/Screenshot_1.jpg

-120 KB
Loading

docs/assets/Screenshot_2.jpg

-131 KB
Loading

docs/assets/Screenshot_3.jpg

-122 KB
Loading

docs/assets/demo_3_1.gif

-2.01 MB
Loading

docs/assets/demo_3_2.gif

-658 KB
Loading

docs/assets/guide_kit_banner.png

108 KB
Loading

0 commit comments

Comments
 (0)