update: ksp-multiplatform.md by budindepunk · Pull Request #5584 · JetBrains/kotlin-web-site

Caro Silva Rode (budindepunk) · 2026-06-01T11:32:10Z

KEDOC-134

Jakob Schneider (jaschdoc)

hfmehmed, any comments on this? :)

hfmehmed

Apart from the 2 comments i left, all good. 🟢

Aleksey Zamulla (zamulla)

Thanks! There's a couple of questions I had that may need answering in the doc.

update: new structure

Aleksey Zamulla (zamulla)

Generally LGTM, added a couple of polishing suggestions.

Aleksey Zamulla (zamulla)

Awesome, thanks! One final nit but it's done 👌

Andrey Polyakov (koshachy) · 2026-07-08T07:33:58Z


-For a quick start, see a [sample Kotlin Multiplatform project](https://github.com/google/ksp/tree/main/examples/multiplatform) 
-defining a KSP processor.
+Here you can learn how to use Kotlin Symbol Processing (KSP) in a Kotlin Multiplatform project. For a quick start, see 


Suggested change

Here you can learn how to use Kotlin Symbol Processing (KSP) in a Kotlin Multiplatform project. For a quick start, see

Here you'll learn how to use Kotlin Symbol Processing (KSP) in a Kotlin Multiplatform project. For a quick start, see

Andrey Polyakov (koshachy) · 2026-07-08T07:36:27Z

-is used to specify which compilation targets need symbol processing, before compilation.
+## Add KSP to a multiplatform project
+
+In the client module's `build.gradle.kts` file, assign a processor to each target that needs symbol processing in the 


What is a client module? 🤔

I'm not sure that we use this term anywhere, maybe I'm wrong?

Why do we use "assign" as a word here? Isn't it just adding a dependency?
Have we ever used "assign" to explain something in the KSP?

Andrey Polyakov (koshachy) · 2026-07-08T07:49:31Z

+add("ksp<Target>", <processor>)
+```
+
+`<Target>` is one of the targets used in your multiplatform project. For a full list of targets, see 


For a full list of target — could be a tip, no?
It is not that important rn since we expect that person knows about targets already

Andrey Polyakov (koshachy) · 2026-07-08T07:50:52Z

+add("ksp<Target>", <processor>)
+```
+
+`<Target>` is one of the targets used in your multiplatform project. For a full list of targets, see 


You can place both Target and Processor in a list, so the info about them would be structured.

Andrey Polyakov (koshachy) · 2026-07-08T07:51:53Z

+    add("kspJvm", "androidx.room:room-compiler:2.6.1")
+    ```
+
+A single target can have multiple processors:


Don't you want to put these different build set ups into separte subsections?

Andrey Polyakov (koshachy) · 2026-07-08T07:53:00Z

+
+## Find KSP configuration names
+
+KSP configuration names depend on the source set names generated by the Kotlin plugin. To view the complete 


What is the Kotlin plugin? Is it KGP (Kotlin Gradle Plugin)? Or Kotlin IntelliJ Plugin? Or Kotlin Multiplatfrom Plugin?

Andrey Polyakov (koshachy) · 2026-07-08T07:53:52Z

+
+Look for the configuration names that correspond to your target source sets.
+
+> Since KSP 2, the catch-all `ksp(...)` configuration is deprecated. Configure each target explicitly to avoid running 


WDYT about making this one a warning instead of note? Will it work?

Andrey Polyakov (koshachy) · 2026-07-08T07:54:58Z

-So is symbol processing. A symbol processing task is created whenever there is a Kotlin compilation task and a
-corresponding `ksp<Target>` or `ksp<SourceSet>` configuration is specified.
+In a multiplatform project, Kotlin creates a separate [compilation](https://kotlinlang.org/docs/multiplatform/multiplatform-advanced-project-structure.html#compilations) 
+for each target and source set, such as `main` and`test`. For every eligible Kotlin compilation task, KSP creates a 


What is eligible Kotlin compilation task?

Can we just omit it?

Andrey Polyakov (koshachy) · 2026-07-08T07:58:57Z

-and 3 symbol processing tasks: common/metadata, JVM main, Linux x64 test.
+* JVM
+* JS
+* Linux X64


Shouldn't we write the target names as one word?

Andrey Polyakov (koshachy) · 2026-07-08T08:10:24Z


-For example, in the above `build.gradle.kts`, there are 4 compilation tasks: common/metadata, JVM main, Linux x64 main, Linux x64 test,
-and 3 symbol processing tasks: common/metadata, JVM main, Linux x64 test.
+* JVM


What do you think to move the info about main and test before this list, maybe rephrase, and in the list mention it in the way:

For the JVM target jvmMain and jvmTest

...

Carolina Silva Rode added 3 commits May 27, 2026 14:09

ksp for kmp init

73396ad

add groovy build script

f52b5df

improve compilation and processing section

59c5f34

Caro Silva Rode (budindepunk) changed the title ~~update: ksp for multiplatform docs~~ update: ksp-multiplatform.md Jun 1, 2026

small fix

d7da5ca

Jakob Schneider (jaschdoc) approved these changes Jun 3, 2026

View reviewed changes

hfmehmed reviewed Jun 15, 2026

View reviewed changes

Comment thread docs/topics/ksp/ksp-multiplatform.md Outdated

hfmehmed reviewed Jun 15, 2026

View reviewed changes

Comment thread docs/topics/ksp/ksp-multiplatform.md Outdated

hfmehmed reviewed Jun 15, 2026

View reviewed changes

fix: dev review

5eec5fc

Caro Silva Rode (budindepunk) marked this pull request as ready for review June 16, 2026 06:57

Caro Silva Rode (budindepunk) requested a review from a team as a code owner June 16, 2026 06:57

Márton Braun (zsmb13) reviewed Jun 18, 2026

View reviewed changes

Comment thread docs/topics/ksp/ksp-multiplatform.md Outdated

Comment thread docs/topics/ksp/ksp-multiplatform.md Outdated

Comment thread docs/topics/ksp/ksp-multiplatform.md Outdated

Comment thread docs/topics/ksp/ksp-multiplatform.md Outdated

Carolina Silva Rode and others added 3 commits June 18, 2026 12:18

fix: Marton review

ad5727e

fix: Marton review

9531cae

Merge branch 'master' into ksp-multiplatform-docs

23c70c4

Aleksey Zamulla (zamulla) reviewed Jun 22, 2026

View reviewed changes

Carolina Silva Rode added 5 commits June 23, 2026 09:16

fix: tw review

6e6de18

fix: tw review

6f5be47

changed example code format

b5b0edc

Merge branch 'ksp-multiplatform-docs-2' into ksp-multiplatform-docs

bfc2cdb

update: new structure

fix: add groovy

ac6da33

Caro Silva Rode (budindepunk) requested a review from Aleksey Zamulla (zamulla) June 23, 2026 14:13

Aleksey Zamulla (zamulla) reviewed Jun 25, 2026

View reviewed changes

Comment thread docs/topics/ksp/ksp-multiplatform.md Outdated

Comment thread docs/topics/ksp/ksp-multiplatform.md Outdated

Comment thread docs/topics/ksp/ksp-multiplatform.md Outdated

fix: twr review

9c15f72

Caro Silva Rode (budindepunk) requested a review from Aleksey Zamulla (zamulla) June 29, 2026 09:03

Aleksey Zamulla (zamulla) reviewed Jun 29, 2026

View reviewed changes

Comment thread docs/topics/ksp/ksp-multiplatform.md Outdated

Aleksey Zamulla (zamulla) approved these changes Jun 29, 2026

View reviewed changes

Carolina Silva Rode and others added 2 commits June 29, 2026 11:21

fix: twr review

d2b0548

Merge branch 'master' into ksp-multiplatform-docs

4dad27e

Andrey Polyakov (koshachy) self-assigned this Jun 29, 2026

Andrey Polyakov (koshachy) requested changes Jul 8, 2026

View reviewed changes

	Here you can learn how to use Kotlin Symbol Processing (KSP) in a Kotlin Multiplatform project. For a quick start, see
	Here you'll learn how to use Kotlin Symbol Processing (KSP) in a Kotlin Multiplatform project. For a quick start, see


		## Find KSP configuration names

		KSP configuration names depend on the source set names generated by the Kotlin plugin. To view the complete


		Look for the configuration names that correspond to your target source sets.

		> Since KSP 2, the catch-all `ksp(...)` configuration is deprecated. Configure each target explicitly to avoid running

Uh oh!

Conversation

Caro Silva Rode (budindepunk) commented Jun 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Jakob Schneider (jaschdoc) left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

hfmehmed left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Aleksey Zamulla (zamulla) left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Aleksey Zamulla (zamulla) left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Aleksey Zamulla (zamulla) left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Caro Silva Rode (budindepunk) commented Jun 1, 2026 •

edited

Loading