diff --git a/docs/images/reference/running-kotlin-js/js-set-up-project.svg b/docs/images/reference/running-kotlin-js/js-set-up-project.svg
new file mode 100644
index 00000000000..8169655f134
--- /dev/null
+++ b/docs/images/reference/running-kotlin-js/js-set-up-project.svg
@@ -0,0 +1,12 @@
+
diff --git a/docs/kr.tree b/docs/kr.tree
index 69d96076e4d..cd6305d4648 100644
--- a/docs/kr.tree
+++ b/docs/kr.tree
@@ -225,8 +225,10 @@
+
-
+
+
diff --git a/docs/topics/js-frameworks.md b/docs/topics/js-frameworks.md
new file mode 100644
index 00000000000..d9a9a4cda0a
--- /dev/null
+++ b/docs/topics/js-frameworks.md
@@ -0,0 +1,78 @@
+[//]: # (title: Kotlin/JS frameworks)
+
+Take advantage of available Kotlin/JavaScript frameworks that simplify web development.
+These frameworks provide ready-to-use components, routing, state management, and other tools for building modern web applications.
+
+Here are some Kotlin/JS web frameworks from the community:
+
+## Kobweb
+
+[Kobweb](https://kobweb.varabyte.com/) is a Kotlin framework for creating websites and web applications with [Compose HTML](https://github.com/JetBrains/compose-multiplatform?tab=readme-ov-file#compose-html). It
+supports live-reloading for fast development. Inspired by [Next.js](https://nextjs.org/), Kobweb promotes a standard structure for adding widgets, layouts,
+and pages.
+
+Out of the box, Kobweb provides page routing, light/dark mode, CSS styling, Markdown support, backend APIs, and more.
+It also includes [Silk](https://silk-ui.netlify.app/), a UI library with a set of versatile widgets for modern UIs.
+
+Kobweb also supports site export by generating page snapshots
+for SEO and automatic search indexing. Additionally, it enables the creation of DOM-based UIs that efficiently update in response to state changes.
+
+For documentation and examples, see the [Kobweb docs](https://kobweb.varabyte.com/docs/getting-started/what-is-kobweb) site.
+
+For updates and discussions about the framework, join the [#kobweb](https://kotlinlang.slack.com/archives/C04RTD72RQ8) and
+[#compose-web](https://kotlinlang.slack.com/archives/C01F2HV7868) channels in the [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up).
+
+## Kilua
+
+[Kilua](https://kilua.dev/) is a composable web framework built on the [Compose Runtime](https://developer.android.com/jetpack/androidx/releases/compose-runtime) and
+is similar to the [compose-html](https://github.com/JetBrains/compose-multiplatform#compose-html)
+library. Unlike compose-html, Kilua supports both Kotlin/Wasm and Kotlin/JS targets.
+
+Kilua provides a modular API to create declarative UI components and manage their state.
+It also includes a set of
+ready-to-use components for common web application use cases.
+
+Kilua is a successor to the [KVision](https://kvision.io) framework. Kilua is designed to be
+familiar to both Compose users (`@Composable` functions, state management, coroutines/flow integration) and
+KVision users (component-based API that allows some imperative interaction with the UI components).
+
+For documentation and examples, see the [Kilua repository](https://github.com/rjaros/kilua?tab=readme-ov-file#building-and-running-the-examples) on GitHub.
+
+For updates and discussions about the framework, join the [#kilua](https://kotlinlang.slack.com/archives/C06UAH52PA7) channel in the Kotlin Slack.
+
+## KVision
+
+[KVision](https://kvision.io) is an object-oriented web framework for building Kotlin/JS applications with ready-to-use UI components.
+These components can be building blocks for your application's user interface.
+
+With this framework, you can use both reactive and imperative programming models to build your frontend. You can also
+integrate it with your server-side applications by using connectors for Ktor, Spring Boot, and other frameworks.
+In addition, you can share code using [Kotlin Multiplatform](https://www.jetbrains.com/help/kotlin-multiplatform-dev/get-started.html).
+
+For documentation, tutorials, and examples, see the [KVision docs](https://kvision.io/#docs) site.
+
+For updates and discussions about the framework, join the [#kvision](https://kotlinlang.slack.com/messages/kvision) and
+[#javascript](https://kotlinlang.slack.com/archives/C0B8L3U69) channels in the [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up).
+
+## fritz2
+
+[fritz2](https://www.fritz2.dev) is a standalone framework for building reactive web user interfaces. It provides its own type-safe DSL for building
+and rendering HTML elements, and uses Kotlin's coroutines and flows to define components and their data bindings.
+
+Out of the box, fritz2 offers state management, validation, routing, and more. It also integrates with Kotlin Multiplatform projects.
+
+For documentation, tutorials, and examples, see the [fritz2 docs](https://www.fritz2.dev/docs/) site.
+
+For updates and discussions about the framework, join the [#fritz2](https://kotlinlang.slack.com/messages/fritz2) and
+[#javascript](https://kotlinlang.slack.com/archives/C0B8L3U69) channels in the [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up).
+
+## Doodle
+
+[Doodle](https://nacular.github.io/doodle/) is a vector-based UI framework for Kotlin/JS. Doodle applications use the browser's graphics capabilities to draw
+user interfaces instead of relying on DOM, CSS, or JavaScript. This approach gives you control
+over the rendering of arbitrary UI elements, vector shapes, gradients, and custom visualizations.
+
+For documentation, tutorials, and examples, see the [Doodle docs](https://nacular.github.io/doodle/docs/introduction/) site.
+
+For updates and discussions about the framework, join the [#doodle](https://kotlinlang.slack.com/messages/doodle) and
+[#javascript](https://kotlinlang.slack.com/archives/C0B8L3U69) channels in the [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up).
\ No newline at end of file
diff --git a/docs/topics/js/js-overview.md b/docs/topics/js/js-overview.md
index 9f98aa9d4d2..306b45a13ea 100644
--- a/docs/topics/js/js-overview.md
+++ b/docs/topics/js/js-overview.md
@@ -1,86 +1,118 @@
-[//]: # (title: Kotlin for JavaScript)
+[//]: # (title: Kotlin/JavaScript)
-Kotlin/JS provides the ability to transpile your Kotlin code, the Kotlin standard library, and any compatible dependencies
-to JavaScript. The current implementation of Kotlin/JS targets [ES5](https://www.ecma-international.org/ecma-262/5.1/).
+Kotlin/JavaScript (Kotlin/JS) lets you transpile your Kotlin code, the Kotlin standard library, and any compatible dependencies
+to JavaScript. This way, your Kotlin applications can run in any environment that supports JavaScript.
-The recommended way to use Kotlin/JS is via the `kotlin.multiplatform` Gradle plugin. It lets you easily set up and control
-Kotlin projects targeting JavaScript in one place. This includes essential functionality
-such as controlling the bundling of your application, adding JavaScript dependencies directly from npm, and more.
-To get an overview of the available options, check out [Set up a Kotlin/JS project](js-project-setup.md).
+Use Kotlin/JS through the [Kotlin Multiplatform Gradle plugin](https://www.jetbrains.com/help/kotlin-multiplatform-dev/multiplatform-dsl-reference.html) (`kotlin.multiplatform`) to configure and manage
+Kotlin projects targeting JavaScript from a single place.
-## Kotlin/JS IR compiler
+The Kotlin Multiplatform Gradle plugin gives you access to features
+such as controlling your application's bundling and adding JavaScript dependencies directly from npm.
+To get an overview of the available configuration options, see [Set up a Kotlin/JS project](js-project-setup.md).
-The [Kotlin/JS IR compiler](js-ir-compiler.md) comes with a number of improvements over the old default compiler.
-For example, it reduces the size of generated executables
-via dead code elimination and provides smoother interoperability with the JavaScript ecosystem and its tooling.
+> The current implementation of Kotlin/JS targets the [ES5](https://www.ecma-international.org/ecma-262/5.1/) and [ES2015](https://262.ecma-international.org/6.0/) standards.
+>
+{style="tip"}
-> The old compiler has been deprecated since the Kotlin 1.8.0 release.
->
-{style="note"}
-By generating TypeScript declaration files (`d.ts`) from Kotlin code, the IR compiler makes it easier to create "hybrid"
-applications that mix TypeScript and Kotlin code and to leverage code-sharing functionality using Kotlin Multiplatform.
+## Use cases for Kotlin/JS
-To learn more about the available features in the Kotlin/JS IR compiler and how to try it for your project, visit the
-[Kotlin/JS IR compiler documentation page](js-ir-compiler.md) and the [migration guide](js-ir-migration.md).
+Here are some common ways to use Kotlin/JS:
-## Kotlin/JS frameworks
+* **Sharing common logic between frontend and JVM backend**
+
+ If your backend is written in Kotlin or another JVM-compatible language,
+ you can share common code between your web application and the backend.
+ This includes data-transfer objects (DTOs), validation and authentication rules, abstractions for REST API endpoints, and more.
+
+* **Sharing common logic between Android, iOS, and web clients**
-Modern web development benefits significantly from frameworks that simplify building web applications.
-Here are a few examples of popular web frameworks for Kotlin/JS written by different authors:
+ You can share business logic between your web interface and mobile applications for Android and iOS,
+ while keeping native user interfaces. This avoids duplicating common functionality such as REST API abstractions,
+ user authentication, form validation,
+ and domain models.
-### Kobweb
+* **Building frontend web applications using Kotlin/JS**
-_Kobweb_ is an opinionated Kotlin framework for creating websites and web apps. It leverages [Compose HTML](https://github.com/JetBrains/compose-multiplatform?tab=readme-ov-file#compose-html) and
-live-reloading for fast development. Inspired by [Next.js](https://nextjs.org/), Kobweb promotes a standard structure for adding widgets, layouts,
-and pages.
+ Use Kotlin to develop traditional web frontends while integrating with existing tools and libraries:
-Out of the box, Kobweb provides page routing, light/dark mode, CSS styling, Markdown support, backend APIs, and more features.
-It also includes a UI library called Silk, a set of versatile widgets for modern UIs.
+ * If you are familiar with Android development, you can build web applications with
+ Compose-based frameworks like [Kobweb](https://kobweb.varabyte.com/) or [Kilua](https://kilua.dev/).
+ * Build fully type-safe React applications with Kotlin/JS using the [Kotlin wrappers for common JavaScript libraries](https://github.com/JetBrains/kotlin-wrappers)
+ provided by JetBrains. The Kotlin wrappers (`kotlin-wrappers`) offer abstractions and integrations for React and other JavaScript frameworks.
+
+ These wrappers also support complementary libraries, like
+ [React Redux](https://react-redux.js.org/), [React Router](https://reactrouter.com/), and [styled-components](https://styled-components.com/).
+ You can also use third-party React components and component libraries through interoperability with the JavaScript ecosystem.
+
+ * Use [Kotlin/JS frameworks](js-frameworks.md),
+ which integrate with the Kotlin ecosystem and support concise and expressive code.
-Kobweb also supports site export, generating page snapshots
-for SEO and automatic search indexing. Additionally, Kobweb makes it easy to create DOM-based UIs that efficiently update in response to state changes.
+* **Building multiplatform applications that support older browsers**
-Visit the [Kobweb site](https://kobweb.varabyte.com/) for documentation and examples.
+ With Compose Multiplatform, you can use Kotlin to build applications and reuse mobile and desktop user interfaces in your web projects.
+ While [Kotlin/Wasm](wasm-overview.md) is the primary target for this purpose, you can extend support to older browsers by also targeting Kotlin/JS.
-For updates and discussions about the framework, join the [#kobweb](https://kotlinlang.slack.com/archives/C04RTD72RQ8) and
-[#compose-web](https://kotlinlang.slack.com/archives/C01F2HV7868) channels in the [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up).
+* **Building server-side and serverless applications using Kotlin/JS**
-### KVision
+ The Node.js target in Kotlin/JS lets you create applications for server-side or serverless environments on a JavaScript
+ runtime. This offers a fast startup and low memory usage. The [`kotlinx-nodejs`](https://github.com/Kotlin/kotlinx-nodejs) library
+ provides type-safe access to the [Node.js API](https://nodejs.org/docs/latest/api/) from Kotlin.
-_KVision_ is an object-oriented web framework that makes it possible to write applications in Kotlin/JS with ready-to-use components
-that can be used as building blocks for your application's user interface. You can use both reactive and imperative programming
-models to build your frontend, use connectors for Ktor, Spring Boot, and other frameworks to integrate it with your server-side
-applications, and share code using [Kotlin Multiplatform](https://www.jetbrains.com/help/kotlin-multiplatform-dev/get-started.html).
+Depending on your use case, Kotlin/JS projects can use compatible libraries from the Kotlin ecosystem and
+third-party libraries from the JavaScript and TypeScript ecosystems.
-Visit the [KVision site](https://kvision.io) for documentation, tutorials, and examples.
+To use third-party libraries from your Kotlin code, you can create your own type-safe wrappers or use community-maintained wrappers.
+Additionally, you can use the Kotlin/JS [dynamic type](dynamic-type.md), which lets you skip strict typing and library wrappers, at the cost of type safety.
-For updates and discussions about the framework, join the [#kvision](https://kotlinlang.slack.com/messages/kvision) and
-[#javascript](https://kotlinlang.slack.com/archives/C0B8L3U69) channels in the [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up).
+Kotlin/JS is also compatible with the most common module systems: [ESM](https://tc39.es/ecma262/#sec-modules), [CommonJS](https://nodejs.org/api/modules.html#modules-commonjs-modules),
+[UMD](https://github.com/umdjs/umd), and [AMD](https://github.com/amdjs/amdjs-api).
+This allows you to [produce and consume modules](js-modules.md) and integrate with the JavaScript ecosystem in a structured manner.
-### fritz2
+### Share your use cases
-_fritz2_ is a standalone framework for building reactive web user interfaces. It provides its own type-safe DSL for building
-and rendering HTML elements, and it makes use of Kotlin's coroutines and flows to express components and their data bindings.
-It provides state management, validation, routing, and more out of the box, and integrates with Kotlin Multiplatform projects.
+The list in [Use cases for Kotlin/JS](#use-cases-for-kotlin-js) isn't exhaustive. Feel free to experiment with different approaches
+and find the best fit for your project.
-Visit the [fritz2 site](https://www.fritz2.dev) for documentation, tutorials, and examples.
+Share your use cases, experiences, and questions with the Kotlin/JS community in the [#javascript](https://kotlinlang.slack.com/archives/C0B8L3U69) channel on [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up).
-For updates and discussions about the framework, join the [#fritz2](https://kotlinlang.slack.com/messages/fritz2) and
-[#javascript](https://kotlinlang.slack.com/archives/C0B8L3U69) channels in the [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up).
+## Get started with Kotlin/JS
-### Doodle
+Explore the fundamentals and initial steps to start working with Kotlin/JS:
-_Doodle_ is a vector-based UI framework for Kotlin/JS. Doodle applications use the browser's graphics capabilities to draw
-user interfaces instead of relying on DOM, CSS, or Javascript. By using this approach, Doodle gives you precise control
-over the rendering of arbitrary UI elements, vector shapes, gradients, and custom visualizations.
+* If you're new to Kotlin, start by reviewing the [basic syntax](basic-syntax.md) and exploring the [Kotlin tour](kotlin-tour-welcome.md).
+* Check out the list of [Kotlin/JS sample projects](#sample-projects-for-kotlin-js) for inspiration. These samples contain
+ useful code snippets and patterns that can help you get started with your projects.
+* If you’re new to Kotlin/JS, start with the setup guide before exploring more advanced topics:
-Visit the [Doodle site](https://nacular.github.io/doodle/) for documentation, tutorials, and examples.
+
-For updates and discussions about the framework, join the [#doodle](https://kotlinlang.slack.com/messages/doodle) and
-[#javascript](https://kotlinlang.slack.com/archives/C0B8L3U69) channels in the [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up).
+## Sample projects for Kotlin/JS
+
+The following table lists a set of sample projects demonstrating various Kotlin/JS use cases, architectures, and code-sharing strategies:
+
+| Project | Description |
+|-----------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| [Petclinic with common code between Spring and Angular](https://github.com/Kotlin/kmp-spring-petclinic/#readme) | Demonstrates how to avoid code duplication in enterprise applications by sharing data-transfer objects, validation and authentication rules, and abstractions for REST API endpoints. The code is shared between a [Spring Boot](https://spring.io/projects/spring-boot) backend and a [Angular](https://angular.dev/) frontend. |
+| [Fullstack Conference CMS](https://github.com/Kotlin/kmp-fullstack-conference-cms/#readme) | Showcases multiple code-sharing approaches, ranging from the simplest to all-in code sharing between [Ktor](https://ktor.io/), [Jetpack Compose](https://developer.android.com/compose), and [Vue.js](https://vuejs.org/) applications. |
+| [Todo App on a Compose-HTML-based Kobweb framework](https://github.com/varabyte/kobweb-templates/tree/main/examples/todo/#readme) | Shows how to create a to-do list application by reusing an approach familiar to Android developers. It builds a client UI application powered by the [Kobweb framework](https://kobweb.varabyte.com/). |
+| [Simple logic sharing between Android, iOS, and web](https://github.com/Kotlin/kmp-logic-sharing-simple-example/#readme) | Contains a template for building a project with common logic in Kotlin, which is consumed in platform-native UI applications on Android ([Jetpack Compose](https://developer.android.com/compose)), iOS ([SwiftUI](https://developer.apple.com/tutorials/swiftui/)), and web ([React](https://react.dev/)). |
+| [Full-stack collaborative to-do list](https://github.com/kotlin-hands-on/jvm-js-fullstack/#readme) | Shows how to create a to-do list application for collaborative work using Kotlin Multiplatform with JS and JVM targets. It uses [Ktor](https://ktor.io/) for the backend, and Kotlin/JS with React for the frontend. |
+
+## Kotlin/JS frameworks
+
+Kotlin/JS frameworks simplify web development by providing ready-to-use components, routing, state management, and other tools for building modern web applications.
+
+[Check the available frameworks for Kotlin/JS written by different authors](js-frameworks.md).
## Join the Kotlin/JS community
You can join the [#javascript](https://kotlinlang.slack.com/archives/C0B8L3U69) channel in the official [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up)
-to chat with the community and the team.
+to chat with the community and the Kotlin/JS team.
+
+## What's next
+
+* [Set up a Kotlin/JS project](js-project-setup.md)
+* [Run Kotlin/JS projects](running-kotlin-js.md)
+* [Debug Kotlin/JS code](js-debugging.md)
+* [Run tests in Kotlin/JS](js-running-tests.md)
diff --git a/docs/topics/js/js-project-setup.md b/docs/topics/js/js-project-setup.md
index 9ed20bd556c..e0356582b83 100644
--- a/docs/topics/js/js-project-setup.md
+++ b/docs/topics/js/js-project-setup.md
@@ -917,11 +917,11 @@ kotlin {
## Module name
To adjust the name for the JavaScript _module_ (which is generated in `build/js/packages/myModuleName`), including
-the corresponding `.js` and `.d.ts` files, use the `moduleName` option:
+the corresponding `.js` and `.d.ts` files, use the `outputModuleName` option:
```groovy
js {
- moduleName = "myModuleName"
+ outputModuleName = "myModuleName"
}
```
-For updates and discussions about the framework, join the [#doodle](https://kotlinlang.slack.com/messages/doodle) and
-[#javascript](https://kotlinlang.slack.com/archives/C0B8L3U69) channels in the [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up).
+## Sample projects for Kotlin/JS
+
+The following table lists a set of sample projects demonstrating various Kotlin/JS use cases, architectures, and code-sharing strategies:
+
+| Project | Description |
+|-----------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| [Petclinic with common code between Spring and Angular](https://github.com/Kotlin/kmp-spring-petclinic/#readme) | Demonstrates how to avoid code duplication in enterprise applications by sharing data-transfer objects, validation and authentication rules, and abstractions for REST API endpoints. The code is shared between a [Spring Boot](https://spring.io/projects/spring-boot) backend and a [Angular](https://angular.dev/) frontend. |
+| [Fullstack Conference CMS](https://github.com/Kotlin/kmp-fullstack-conference-cms/#readme) | Showcases multiple code-sharing approaches, ranging from the simplest to all-in code sharing between [Ktor](https://ktor.io/), [Jetpack Compose](https://developer.android.com/compose), and [Vue.js](https://vuejs.org/) applications. |
+| [Todo App on a Compose-HTML-based Kobweb framework](https://github.com/varabyte/kobweb-templates/tree/main/examples/todo/#readme) | Shows how to create a to-do list application by reusing an approach familiar to Android developers. It builds a client UI application powered by the [Kobweb framework](https://kobweb.varabyte.com/). |
+| [Simple logic sharing between Android, iOS, and web](https://github.com/Kotlin/kmp-logic-sharing-simple-example/#readme) | Contains a template for building a project with common logic in Kotlin, which is consumed in platform-native UI applications on Android ([Jetpack Compose](https://developer.android.com/compose)), iOS ([SwiftUI](https://developer.apple.com/tutorials/swiftui/)), and web ([React](https://react.dev/)). |
+| [Full-stack collaborative to-do list](https://github.com/kotlin-hands-on/jvm-js-fullstack/#readme) | Shows how to create a to-do list application for collaborative work using Kotlin Multiplatform with JS and JVM targets. It uses [Ktor](https://ktor.io/) for the backend, and Kotlin/JS with React for the frontend. |
+
+## Kotlin/JS frameworks
+
+Kotlin/JS frameworks simplify web development by providing ready-to-use components, routing, state management, and other tools for building modern web applications.
+
+[Check the available frameworks for Kotlin/JS written by different authors](js-frameworks.md).
## Join the Kotlin/JS community
You can join the [#javascript](https://kotlinlang.slack.com/archives/C0B8L3U69) channel in the official [Kotlin Slack](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up)
-to chat with the community and the team.
+to chat with the community and the Kotlin/JS team.
+
+## What's next
+
+* [Set up a Kotlin/JS project](js-project-setup.md)
+* [Run Kotlin/JS projects](running-kotlin-js.md)
+* [Debug Kotlin/JS code](js-debugging.md)
+* [Run tests in Kotlin/JS](js-running-tests.md)
diff --git a/docs/topics/js/js-project-setup.md b/docs/topics/js/js-project-setup.md
index 9ed20bd556c..e0356582b83 100644
--- a/docs/topics/js/js-project-setup.md
+++ b/docs/topics/js/js-project-setup.md
@@ -917,11 +917,11 @@ kotlin {
## Module name
To adjust the name for the JavaScript _module_ (which is generated in `build/js/packages/myModuleName`), including
-the corresponding `.js` and `.d.ts` files, use the `moduleName` option:
+the corresponding `.js` and `.d.ts` files, use the `outputModuleName` option:
```groovy
js {
- moduleName = "myModuleName"
+ outputModuleName = "myModuleName"
}
```