docs: add ecosystem section with FileKit and spell-check guides

Author: kdroidFilter

docs/ecosystem/file-dialog.md

@@ -0,0 +1,48 @@
+# File Dialog
+
+Nucleus does not ship a file/folder picker module. The Compose Multiplatform ecosystem already has an excellent native solution.
+
+## Recommended: FileKit
+
+[**FileKit**](https://github.com/vinceglb/FileKit) by [@vinceglb](https://github.com/vinceglb) — native file pickers and file operations for Compose Multiplatform, including JVM Desktop.
+
+```kotlin
+dependencies {
+    implementation("io.github.vinceglb:filekit-compose:<version>")
+}
+```
+
+```kotlin
+val launcher = rememberFilePickerLauncher(
+    type = PickerType.File(extensions = listOf("png", "jpg")),
+    title = "Pick an image",
+) { file ->
+    // file: PlatformFile?
+}
+
+Button(onClick = { launcher.launch() }) {
+    Text("Pick image")
+}
+```
+
+### What it covers
+
+- Native open / save / folder pickers on macOS (`NSOpenPanel` / `NSSavePanel`), Windows (`IFileOpenDialog` / `IFileSaveDialog`), and Linux (xdg-desktop-portal `FileChooser` with fallback to GTK / zenity)
+- File type filters with descriptions
+- Single-file, multi-file, folder, and save modes
+- Compose-friendly API with `rememberFilePickerLauncher`
+- Cross-platform `PlatformFile` abstraction with read / write / metadata helpers
+
+### Why Nucleus doesn't ship this
+
+FileKit already covers the full surface natively, has active maintenance, and integrates cleanly with Compose state. Reimplementing it inside Nucleus would duplicate effort with no benefit.
+
+### GraalVM native image — zero config
+
+The Nucleus Gradle plugin ships **preloaded reachability metadata for FileKit** as part of its [library metadata bundle](../graalvm/automatic-metadata.md). The metadata is conditionally included only when `io.github.vinceglb.filekit` is present on your runtime classpath, and covers:
+
+- macOS Foundation proxy + callback types (`FoundationLibrary`, `ID`, runnable callbacks)
+- Windows JNA COM bindings (`FileDialog`, `FileOpenDialog`, `FileSaveDialog`, `ShellItem`, `Shell32`, `COMDLG_FILTERSPEC`, `PROPERTYKEY`, …)
+- XDG desktop-portal D-Bus proxy (`FileChooserDbusInterface`) for Linux
+
+So if you package with the Nucleus plugin and target `native-image`, FileKit works out of the box — no manual entries in `reachability-metadata.json`, no tracing-agent run required.

docs/ecosystem/spell-check.md

@@ -0,0 +1,31 @@
+# Spell Check
+
+Nucleus does not ship a spell-checking module. The ecosystem already has a native cross-platform solution for Kotlin.
+
+## Recommended: PlatformSpellCheckerKt
+
+[**PlatformSpellCheckerKt**](https://github.com/Wavesonics/PlatformSpellCheckerKt) by [@Wavesonics](https://github.com/Wavesonics) — a Kotlin Multiplatform wrapper over the native OS spell-check engines.
+
+```kotlin
+dependencies {
+    implementation("com.darkrockstudios:platform-spellchecker:<version>")
+}
+```
+
+```kotlin
+val checker = PlatformSpellChecker()
+
+val misspellings = checker.check("This is a sentance with errors")
+// → [Misspelling(word = "sentance", suggestions = ["sentence", ...])]
+```
+
+### What it covers
+
+- macOS — `NSSpellChecker` (the same engine as TextEdit and the system text fields)
+- Windows — Windows Spell Check API (`ISpellChecker`, available since Windows 8)
+- Linux — `enchant` / `hunspell`
+- Suggestions, language detection, and custom dictionary support
+
+### Why Nucleus doesn't ship this
+
+Spell checking is a deep, locale-heavy domain that benefits from a focused, well-tested library. PlatformSpellCheckerKt already wraps the right native engines and has no JVM-specific limitations that Nucleus would need to work around.

mkdocs.yml

@@ -117,6 +117,9 @@ nav:
               - Native HTTP: runtime/native-http.md
   - Comparison:
       - Packaging: comparison/packaging.md
+  - Ecosystem:
+      - File Dialog: ecosystem/file-dialog.md
+      - Spell Check: ecosystem/spell-check.md
   - Migration: migration.md
   - Changelog: changelog.md
   - LLM Documentation: llm.md