You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CHANGELOG.md
+18-4Lines changed: 18 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,23 @@
1
1
# Changelog
2
2
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.
4
4
5
5
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project follows semantic versioning.
6
6
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
+
7
21
## [1.1.0] - 2026-07-23
8
22
9
23
### Library changes
@@ -17,7 +31,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
17
31
- 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.
18
32
- Moved the sample guides to the full-screen parent so overlays render above the smaller bottom navigation and the complete screen content.
19
33
- 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.
21
35
22
36
## [1.0.0] - 2026-07-22
23
37
@@ -26,15 +40,15 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
26
40
- Expanded the README with the same installation, full-screen parent setup, target-bounds callback, persistence, customization, and API guidance used by the website.
27
41
- Replaced public arrow dash interval arrays with named presets directly in `GuideKitArrowLineStyle`: `Dotted`, `ShortDash`, `MediumDash`, `LongDash`, and `DashDot`.
28
42
- 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.
30
44
- Replaced the separate single-phrase `descriptionHighlight` option with the unified `descriptionHighlights` list.
31
45
- Changed `arrowHeadAngleDegrees` from a public `Float` to an `Int`, with conversion handled internally.
32
46
33
47
## [0.1.0] - 2026-07-16
34
48
35
49
### Added
36
50
37
-
- Initial Compose Multiplatform GuideKit library.
51
+
- Initial GuideKit Compose library for Compose Multiplatform.
38
52
- Coachmark overlay with target highlights, instruction cards, arrows, step indicators, skip/finish callbacks, and auto-scroll support.
39
53
- Rounded rectangle and circular target highlight styles.
40
54
- Per-step style overrides for arrows, target highlights, instruction cards, and auto-scroll behavior.
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
+
65
81
---
66
82
67
83
## Quick Start
@@ -159,7 +175,7 @@ See the [`sample`](sample/) app for full configuration, styling, auto-scroll, ar
159
175
160
176
### Add multiple steps
161
177
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.
163
179
164
180
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.
165
181
@@ -286,7 +302,7 @@ All ordinary override properties default to `null`, meaning “inherit the globa
286
302
287
303
### Customize step text
288
304
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**.
290
306
291
307
```kotlin
292
308
GuideKitStep(
@@ -361,7 +377,7 @@ val specialStep = GuideKitStep(
361
377
)
362
378
```
363
379
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.
365
381
366
382
| Arrow option | Default | Purpose |
367
383
| --- | --- | --- |
@@ -527,7 +543,7 @@ The same pattern is available for nullable values such as `outerPadding`, size c
527
543
528
544
### Configure automatic scrolling
529
545
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.
531
547
532
548
```kotlin
533
549
val scrollState = rememberScrollState()
@@ -547,7 +563,7 @@ Tune or disable scrolling for an individual step:
547
563
GuideKitStep(
548
564
targetBounds = lowerCardBounds,
549
565
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.",
551
567
autoScroll =GuideKitAutoScrollConfig(
552
568
enabled =true,
553
569
minTopVisibleDistance =56.dp,
@@ -566,7 +582,7 @@ Use `GuideKitAutoScrollConfig(enabled = false)` for fixed targets such as a floa
566
582
567
583
### Configure navigation and callbacks
568
584
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.
570
586
571
587
```kotlin
572
588
GuideKit(
@@ -606,7 +622,7 @@ GuideKit(
606
622
|`onSkipped`|`null`| Shows the close button and runs when the user skips. `null` removes skip. |
607
623
|`onFinished`| Required | Runs when the primary button is pressed on the final step. |
608
624
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.
610
626
611
627
---
612
628
@@ -621,7 +637,7 @@ Users can move back to the previous step by swiping the instruction card to the
621
637
| Instruction cards | Show titles, descriptions, highlighted text, buttons, and progress. |
622
638
| Auto-scroll | Automatically scroll to keep targets visible and clear of the card. |
623
639
| 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. |
625
641
| Callbacks | React to step changes, skipped tours, and completed tours. |
626
642
| Compose Multiplatform | Shared Kotlin API for Android and iOS Compose apps. |
627
643
@@ -655,7 +671,7 @@ Users can move back to the previous step by swiping the instruction card to the
655
671
656
672
## Contributing
657
673
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.
659
675
660
676
Before opening a pull request:
661
677
@@ -671,5 +687,5 @@ Before opening a pull request:
671
687
MIT License. See [`LICENSE`](LICENSE).
672
688
673
689
<palign="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.
0 commit comments