From d22f2f86431c9a08fd95e76964c073cc4afc76f0 Mon Sep 17 00:00:00 2001
From: Ivan Mendez <ivanmw97@gmail.com>
Date: Mon, 9 Feb 2026 13:55:11 +0000
Subject: [PATCH 1/2] chore: rename package to kompkit-core and update all
 references

---
 README.md               |  2 +-
 docs/getting-started.md |  2 +-
 docs/recipes.md         | 22 +++++++++++-----------
 docs/web.md             | 16 ++++++++--------
 lerna.json              |  4 ++--
 package-lock.json       | 13 +++++++------
 package.json            |  2 +-
 7 files changed, 31 insertions(+), 30 deletions(-)

diff --git a/README.md b/README.md
index c826e69..ffd2e5e 100644
--- a/README.md
+++ b/README.md
@@ -114,7 +114,7 @@ Once installed, you can import and use KompKit utilities:
 **TypeScript/JavaScript:**
 
 ```typescript
-import { debounce, isEmail, formatCurrency } from "@kompkit/core";
+import { debounce, isEmail, formatCurrency } from "kompkit-core";
 
 const search = debounce((query: string) => {
   console.log("Searching:", query);
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 4415637..33caa7d 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -9,7 +9,7 @@ Status: `V0.2.0-alpha`.
 ### Web (React/Vue)
 
 ```bash
-npm i @kompkit/core
+npm i kompkit-core
 ```
 
 ### Android (Gradle)
diff --git a/docs/recipes.md b/docs/recipes.md
index 17f4a1e..75e0bef 100644
--- a/docs/recipes.md
+++ b/docs/recipes.md
@@ -6,7 +6,7 @@ Real-world examples using KompKit Core utilities.
 
 ```tsx
 import { useState, useEffect } from "react";
-import { debounce } from "@kompkit/core";
+import { debounce } from "kompkit-core";
 
 function SearchComponent() {
   const [query, setQuery] = useState("");
@@ -160,7 +160,7 @@ class _SearchScreenState extends State<SearchScreen> {
 
 ```tsx
 import { useState } from "react";
-import { formatCurrency } from "@kompkit/core";
+import { formatCurrency } from "kompkit-core";
 
 function PriceDisplay({ amount }: { amount: number }) {
   const [locale, setLocale] = useState<"en-US" | "es-ES" | "ja-JP">("en-US");
@@ -191,7 +191,7 @@ function PriceDisplay({ amount }: { amount: number }) {
 
 ```tsx
 import { useState } from "react";
-import { isEmail } from "@kompkit/core";
+import { isEmail } from "kompkit-core";
 
 function ContactForm() {
   const [email, setEmail] = useState("");
@@ -231,22 +231,22 @@ import 'package:kompkit_core/kompkit_core.dart';
 
 class PriceDisplay extends StatefulWidget {
   final double amount;
-  
+
   const PriceDisplay({Key? key, required this.amount}) : super(key: key);
-  
+
   @override
   _PriceDisplayState createState() => _PriceDisplayState();
 }
 
 class _PriceDisplayState extends State<PriceDisplay> {
   String _selectedLocale = 'en_US';
-  
+
   final Map<String, Map<String, String>> _localeConfig = {
     'en_US': {'currency': 'USD', 'locale': 'en_US'},
     'es_ES': {'currency': 'EUR', 'locale': 'es_ES'},
     'ja_JP': {'currency': 'JPY', 'locale': 'ja_JP'},
   };
-  
+
   @override
   Widget build(BuildContext context) {
     final config = _localeConfig[_selectedLocale]!;
@@ -255,7 +255,7 @@ class _PriceDisplayState extends State<PriceDisplay> {
       currency: config['currency']!,
       locale: config['locale']!,
     );
-    
+
     return Column(
       children: [
         Text(
@@ -297,7 +297,7 @@ class ContactForm extends StatefulWidget {
 class _ContactFormState extends State<ContactForm> {
   final TextEditingController _emailController = TextEditingController();
   final GlobalKey<FormState> _formKey = GlobalKey<FormState>();
-  
+
   void _handleSubmit() {
     if (_formKey.currentState!.validate()) {
       // Submit form
@@ -307,7 +307,7 @@ class _ContactFormState extends State<ContactForm> {
       );
     }
   }
-  
+
   String? _validateEmail(String? value) {
     if (value == null || value.isEmpty) {
       return 'Email is required';
@@ -317,7 +317,7 @@ class _ContactFormState extends State<ContactForm> {
     }
     return null;
   }
-  
+
   @override
   Widget build(BuildContext context) {
     return Scaffold(
diff --git a/docs/web.md b/docs/web.md
index bfaa9ce..b815d1f 100644
--- a/docs/web.md
+++ b/docs/web.md
@@ -7,7 +7,7 @@ Status: `V0.2.0-alpha`.
 ## Installation
 
 ```bash
-npm i @kompkit/core
+npm i kompkit-core
 ```
 
 ## Imports
@@ -15,13 +15,13 @@ npm i @kompkit/core
 ESM:
 
 ```ts
-import { debounce, isEmail, formatCurrency } from "@kompkit/core";
+import { debounce, isEmail, formatCurrency } from "kompkit-core";
 ```
 
 CommonJS:
 
 ```js
-const { debounce, isEmail, formatCurrency } = require("@kompkit/core");
+const { debounce, isEmail, formatCurrency } = require("kompkit-core");
 ```
 
 ## Usage examples
@@ -29,7 +29,7 @@ const { debounce, isEmail, formatCurrency } = require("@kompkit/core");
 ### debounce
 
 ```ts
-import { debounce } from "@kompkit/core";
+import { debounce } from "kompkit-core";
 
 const onType = debounce((value: string) => {
   console.log("Search:", value);
@@ -43,7 +43,7 @@ onType("kompkit"); // only this call will execute after ~300ms
 ### isEmail
 
 ```ts
-import { isEmail } from "@kompkit/core";
+import { isEmail } from "kompkit-core";
 
 isEmail("test@example.com"); // true
 isEmail("invalid@"); // false
@@ -52,7 +52,7 @@ isEmail("invalid@"); // false
 ### formatCurrency
 
 ```ts
-import { formatCurrency } from "@kompkit/core";
+import { formatCurrency } from "kompkit-core";
 
 formatCurrency(1234.56); // "1.234,56 €" (es-ES by default)
 formatCurrency(1234.56, "USD", "en-US"); // "$1,234.56"
@@ -62,7 +62,7 @@ formatCurrency(1234.56, "USD", "en-US"); // "$1,234.56"
 
 ```tsx
 import { useState } from "react";
-import { debounce } from "@kompkit/core";
+import { debounce } from "kompkit-core";
 
 export function SearchBox() {
   const [value, setValue] = useState("");
@@ -85,7 +85,7 @@ export function SearchBox() {
 ```vue
 <script setup lang="ts">
 import { ref } from "vue";
-import { debounce } from "@kompkit/core";
+import { debounce } from "kompkit-core";
 
 const value = ref("");
 const run = debounce((v: string) => console.log("search", v), 250);
diff --git a/lerna.json b/lerna.json
index 4b32673..0bee1f7 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
-  "version": "0.1.0",
+  "version": "0.2.0-alpha.0",
   "npmClient": "npm",
   "packages": ["packages/core/web"],
   "command": {
@@ -8,4 +8,4 @@
       "message": "chore(release): publish %s"
     }
   }
-}
\ No newline at end of file
+}
diff --git a/package-lock.json b/package-lock.json
index e90395c..3a26aae 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -694,10 +694,6 @@
         "@jridgewell/sourcemap-codec": "^1.4.14"
       }
     },
-    "node_modules/@kompkit/core": {
-      "resolved": "packages/core/web",
-      "link": true
-    },
     "node_modules/@lerna/create": {
       "version": "8.2.4",
       "dev": true,
@@ -4685,6 +4681,10 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/kompkit-core": {
+      "resolved": "packages/core/web",
+      "link": true
+    },
     "node_modules/lerna": {
       "version": "8.2.4",
       "dev": true,
@@ -8968,8 +8968,9 @@
       }
     },
     "packages/core/web": {
-      "name": "@kompkit/core",
-      "version": "0.2.0-alpha",
+      "name": "kompkit-core",
+      "version": "0.2.0-alpha.0",
+      "license": "MIT",
       "devDependencies": {
         "tsup": "^8.5.0",
         "typedoc": "^0.28.16",
diff --git a/package.json b/package.json
index 5d61270..dec9a09 100644
--- a/package.json
+++ b/package.json
@@ -11,7 +11,7 @@
     "build:web": "npm --prefix packages/core/web run build",
     "build:android": "cd packages/core/android && ./gradlew build",
     "build:flutter": "cd packages/core/flutter && flutter packages get",
-    "test:web": "lerna run test --scope=@kompkit/core",
+    "test:web": "lerna run test --scope=kompkit-core",
     "test:android": "cd packages/core/android && ./gradlew test",
     "test:flutter": "cd packages/core/flutter && flutter test",
     "test": "npm run test:web && npm run test:android && npm run test:flutter",

From 1bfe367162691b21194efc9b084760c75fc45225 Mon Sep 17 00:00:00 2001
From: Ivan Mendez <ivanmw97@gmail.com>
Date: Mon, 9 Feb 2026 14:01:48 +0000
Subject: [PATCH 2/2] docs: update install instructions with published npm and
 pub.dev packages

---
 README.md                       | 57 +++++++++++++--------------------
 docs/android.md                 | 13 ++++++--
 docs/flutter.md                 |  8 ++---
 docs/getting-started.md         | 37 +++++++++++++--------
 packages/core/flutter/README.md |  7 ++--
 5 files changed, 64 insertions(+), 58 deletions(-)

diff --git a/README.md b/README.md
index ffd2e5e..7a85a41 100644
--- a/README.md
+++ b/README.md
@@ -53,60 +53,47 @@ KompKit provides essential utility functions that work seamlessly across Web (Ty
 
 ### Installation
 
-> **Note**: Alpha packages are not yet published to registries. Clone the repository for local development.
-
-#### Web Development
+#### Web (npm)
 
 ```bash
-# Clone the repository
-git clone https://github.com/Kompkit/KompKit.git
-cd KompKit
+npm i kompkit-core
+```
+
+> Published on [npmjs.com/package/kompkit-core](https://www.npmjs.com/package/kompkit-core)
 
-# Install dependencies
-npm install
+#### Flutter / Dart (pub.dev)
 
-# Build the web package
-npm run build
+Add to your `pubspec.yaml`:
 
-# Run tests
-npm run test:web
+```yaml
+dependencies:
+  kompkit_core: ^0.2.0-alpha.0
 ```
 
-#### Android Development
+Then run:
 
 ```bash
-# Clone the repository
-git clone https://github.com/Kompkit/KompKit.git
+flutter pub get
+```
+
+> Published on [pub.dev/packages/kompkit_core](https://pub.dev/packages/kompkit_core)
+
+#### Android (Kotlin) — Local only
 
-# Include in your Android project's settings.gradle.kts
+> **Note**: The Android/Kotlin package is not yet published to Maven. Use a local project reference for now.
+
+```kotlin
+// settings.gradle.kts
 include(":kompkit-core")
 project(":kompkit-core").projectDir = file("path/to/KompKit/packages/core/android")
 
-# Add to your app's build.gradle.kts
+// app/build.gradle.kts
 dependencies {
     implementation(project(":kompkit-core"))
     implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.10.2")
 }
 ```
 
-#### Flutter Development
-
-```bash
-# Clone the repository
-git clone https://github.com/Kompkit/KompKit.git
-
-# Add to your Flutter project's pubspec.yaml
-dependencies:
-  kompkit_core:
-    path: path/to/KompKit/packages/core/flutter
-
-# Get dependencies
-flutter pub get
-
-# Run tests
-flutter test
-```
-
 ### Quick Start
 
 Once installed, you can import and use KompKit utilities:
diff --git a/docs/android.md b/docs/android.md
index b49a958..0f5d953 100644
--- a/docs/android.md
+++ b/docs/android.md
@@ -6,11 +6,20 @@ Status: `V0.2.0-alpha`.
 
 ## Installation
 
-Add the dependency to your module `build.gradle.kts`:
+> **Note**: The Android/Kotlin package is not yet published to Maven. Use a local project reference for now.
+
+Add the project reference to your `settings.gradle.kts`:
+
+```kotlin
+include(":kompkit-core")
+project(":kompkit-core").projectDir = file("path/to/KompKit/packages/core/android")
+```
+
+Then add the dependency to your module `build.gradle.kts`:
 
 ```kotlin
 dependencies {
-    implementation("com.kompkit:core:<version>")
+    implementation(project(":kompkit-core"))
     implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.2")
 }
 ```
diff --git a/docs/flutter.md b/docs/flutter.md
index 01460f1..e871ebf 100644
--- a/docs/flutter.md
+++ b/docs/flutter.md
@@ -12,8 +12,7 @@ Add KompKit Core to your `pubspec.yaml`:
 
 ```yaml
 dependencies:
-  kompkit_core:
-    path: path/to/KompKit/packages/core/flutter
+  kompkit_core: ^0.2.0-alpha.0
 ```
 
 Then run:
@@ -22,14 +21,15 @@ Then run:
 flutter pub get
 ```
 
+> Published on [pub.dev/packages/kompkit_core](https://pub.dev/packages/kompkit_core)
+
 ### Dart Projects
 
 For server-side Dart projects, add to your `pubspec.yaml`:
 
 ```yaml
 dependencies:
-  kompkit_core:
-    path: path/to/KompKit/packages/core/flutter
+  kompkit_core: ^0.2.0-alpha.0
 ```
 
 Then run:
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 33caa7d..2cf035b 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -6,31 +6,40 @@ Status: `V0.2.0-alpha`.
 
 ## Install
 
-### Web (React/Vue)
+### Web (npm)
 
 ```bash
 npm i kompkit-core
 ```
 
-### Android (Gradle)
+> [npmjs.com/package/kompkit-core](https://www.npmjs.com/package/kompkit-core)
 
-Add the dependency to your module build file:
+### Flutter / Dart (pub.dev)
 
-```kotlin
-dependencies {
-    implementation("com.kompkit:core:<version>")
-    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.2")
-}
+Add to your `pubspec.yaml`:
+
+```yaml
+dependencies:
+  kompkit_core: ^0.2.0-alpha.0
+```
+
+Then run:
+
+```bash
+flutter pub get
 ```
 
-### Flutter (pubspec.yaml)
+> [pub.dev/packages/kompkit_core](https://pub.dev/packages/kompkit_core)
 
-Add the dependency to your pubspec.yaml:
+### Android (Gradle) — Local only
 
-```yaml
-dependencies:
-  kompkit_core:
-    path: path/to/KompKit/packages/core/flutter
+> Not yet published to Maven. Use a local project reference for now.
+
+```kotlin
+dependencies {
+    implementation(project(":kompkit-core"))
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.2")
+}
 ```
 
 ## Build and test locally
diff --git a/packages/core/flutter/README.md b/packages/core/flutter/README.md
index 5cdf745..9b9462a 100644
--- a/packages/core/flutter/README.md
+++ b/packages/core/flutter/README.md
@@ -8,17 +8,18 @@ Add to your `pubspec.yaml`:
 
 ```yaml
 dependencies:
-  kompkit_core:
-    path: path/to/KompKit/packages/core/flutter
+  kompkit_core: ^0.2.0-alpha.0
 ```
 
+> Published on [pub.dev/packages/kompkit_core](https://pub.dev/packages/kompkit_core)
+
 Import and use:
 
 ```dart
 import 'package:kompkit_core/kompkit_core.dart';
 
 // Debounce function calls
-final search = debounce<String>((query) => print('Searching: $query'), 
+final search = debounce<String>((query) => print('Searching: $query'),
                                 const Duration(milliseconds: 300));
 
 // Validate emails