react-native-vconsole 0.0.1 → 0.3.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 davis
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,17 +1,47 @@
 # react-native-vconsole
 
-## Getting started
+vconsole
 
-`$ npm install react-native-vconsole --save`
+## Installation
 
-### Mostly automatic installation
-
-`$ react-native link react-native-vconsole`
+```sh
+npm install react-native-vconsole
+```
 
 ## Usage
-```javascript
-import ReactNativeVconsole from 'react-native-vconsole';
 
-// TODO: What to do with the module?
-ReactNativeVconsole;
+
+```tsx
+import { VConsole } from 'react-native-vconsole';
+
+export default function App() {
+  return (
+    <>
+      {/* your app content */}
+      <VConsole enable={true} filter={['localhost:8081']} />
+    </>
+  );
+}
 ```
+
+## Features
+
+- Draggable floating button (`vConsole`) with screen-boundary constraints.
+- Bottom sheet panel (2/3 screen height) with `Log / Network / System / App` tabs.
+- Log tab captures `console.log/info/warn/error` without breaking original console behavior.
+- Network tab captures `XMLHttpRequest` requests/responses without breaking original request behavior.
+- System/App tabs read info from native module bridges (`NativeModules.Vconsole`).
+
+![snapshot](./docs/snapshot/Simulator%20Screenshot%20-%20iPhone%2017%20Pro.png)
+
+## Contributing
+
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/Vconsole.podspec

@@ -0,0 +1,25 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "Vconsole"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/davistsin/react-native-vconsole.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm}"
+
+# Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
+# See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
+if respond_to?(:install_modules_dependencies, true)
+  install_modules_dependencies(s)
+else
+  s.dependency "React-Core"
+end
+end

package/android/build.gradle

@@ -1,149 +1,81 @@
-// android/build.gradle
-
-// based on:
-//
-// * https://github.com/facebook/react-native/blob/0.60-stable/template/android/build.gradle
-//   original location:
-//   - https://github.com/facebook/react-native/blob/0.58-stable/local-cli/templates/HelloWorld/android/build.gradle
-//
-// * https://github.com/facebook/react-native/blob/0.60-stable/template/android/app/build.gradle
-//   original location:
-//   - https://github.com/facebook/react-native/blob/0.58-stable/local-cli/templates/HelloWorld/android/app/build.gradle
-
-def DEFAULT_COMPILE_SDK_VERSION = 28
-def DEFAULT_BUILD_TOOLS_VERSION = '28.0.3'
-def DEFAULT_MIN_SDK_VERSION = 16
-def DEFAULT_TARGET_SDK_VERSION = 28
-
-def safeExtGet(prop, fallback) {
-    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['Vconsole_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
 }
 
-apply plugin: 'com.android.library'
-apply plugin: 'maven'
 
-buildscript {
-    // The Android Gradle plugin is only required when opening the android folder stand-alone.
-    // This avoids unnecessary downloads and potential conflicts when the library is included as a
-    // module dependency in an application project.
-    // ref: https://docs.gradle.org/current/userguide/tutorial_using_tasks.html#sec:build_script_external_dependencies
-    if (project == rootProject) {
-        repositories {
-            google()
-            jcenter()
-        }
-        dependencies {
-            classpath 'com.android.tools.build:gradle:3.4.1'
-        }
-    }
-}
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
 
-apply plugin: 'com.android.library'
-apply plugin: 'maven'
 
-android {
-    compileSdkVersion safeExtGet('compileSdkVersion', DEFAULT_COMPILE_SDK_VERSION)
-    buildToolsVersion safeExtGet('buildToolsVersion', DEFAULT_BUILD_TOOLS_VERSION)
-    defaultConfig {
-        minSdkVersion safeExtGet('minSdkVersion', DEFAULT_MIN_SDK_VERSION)
-        targetSdkVersion safeExtGet('targetSdkVersion', DEFAULT_TARGET_SDK_VERSION)
-        versionCode 1
-        versionName "1.0"
-    }
-    lintOptions {
-        abortOnError false
-    }
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["Vconsole_" + name]).toInteger()
 }
 
-repositories {
-    // ref: https://www.baeldung.com/maven-local-repository
-    mavenLocal()
-    maven {
-        // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
-        url "$rootDir/../node_modules/react-native/android"
-    }
-    maven {
-        // Android JSC is installed from npm
-        url "$rootDir/../node_modules/jsc-android/dist"
-    }
-    google()
-    jcenter()
-}
+def supportsNamespace() {
+  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
+  def major = parsed[0].toInteger()
+  def minor = parsed[1].toInteger()
 
-dependencies {
-    //noinspection GradleDynamicVersion
-    implementation 'com.facebook.react:react-native:+'  // From node_modules
+  // Namespace support was added in 7.3.0
+  return (major == 7 && minor >= 3) || major >= 8
 }
 
-def configureReactNativePom(def pom) {
-    def packageJson = new groovy.json.JsonSlurper().parseText(file('../package.json').text)
-
-    pom.project {
-        name packageJson.title
-        artifactId packageJson.name
-        version = packageJson.version
-        group = "wiki.qdc.rn.vconsole"
-        description packageJson.description
-        url packageJson.repository.baseUrl
-
-        licenses {
-            license {
-                name packageJson.license
-                url packageJson.repository.baseUrl + '/blob/master/' + packageJson.licenseFilename
-                distribution 'repo'
-            }
-        }
-
-        developers {
-            developer {
-                id packageJson.author.username
-                name packageJson.author.name
-            }
-        }
-    }
-}
+android {
+  if (supportsNamespace()) {
+    namespace "com.vconsole"
 
-afterEvaluate { project ->
-    // some Gradle build hooks ref:
-    // https://www.oreilly.com/library/view/gradle-beyond-the/9781449373801/ch03.html
-    task androidJavadoc(type: Javadoc) {
-        source = android.sourceSets.main.java.srcDirs
-        classpath += files(android.bootClasspath)
-        classpath += files(project.getConfigurations().getByName('compile').asList())
-        include '**/*.java'
+    sourceSets {
+      main {
+        manifest.srcFile "src/main/AndroidManifestNew.xml"
+      }
     }
+  }
 
-    task androidJavadocJar(type: Jar, dependsOn: androidJavadoc) {
-        classifier = 'javadoc'
-        from androidJavadoc.destinationDir
-    }
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
 
-    task androidSourcesJar(type: Jar) {
-        classifier = 'sources'
-        from android.sourceSets.main.java.srcDirs
-        include '**/*.java'
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
     }
+  }
 
-    android.libraryVariants.all { variant ->
-        def name = variant.name.capitalize()
-        def javaCompileTask = variant.javaCompileProvider.get()
+  lintOptions {
+    disable "GradleCompatible"
+  }
 
-        task "jar${name}"(type: Jar, dependsOn: javaCompileTask) {
-            from javaCompileTask.destinationDir
-        }
-    }
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
 
-    artifacts {
-        archives androidSourcesJar
-        archives androidJavadocJar
-    }
+repositories {
+  mavenCentral()
+  google()
+}
 
-    task installArchives(type: Upload) {
-        configuration = configurations.archives
-        repositories.mavenDeployer {
-            // Deploy to react-native-event-bridge/maven, ready to publish to npm
-            repository url: "file://${projectDir}/../android/maven"
-            configureReactNativePom pom
-        }
-    }
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
 }
+

package/android/gradle.properties

@@ -0,0 +1,5 @@
+Vconsole_kotlinVersion=2.0.21
+Vconsole_minSdkVersion=24
+Vconsole_targetSdkVersion=34
+Vconsole_compileSdkVersion=35
+Vconsole_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -1,4 +1,3 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
-          package="wiki.qdc.rn.vconsole">
-
+          package="com.vconsole">
 </manifest>

package/android/src/main/AndroidManifestNew.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/vconsole/VconsoleModule.kt

@@ -0,0 +1,80 @@
+package com.vconsole
+
+import android.app.ActivityManager
+import android.content.Context
+import android.net.ConnectivityManager
+import android.net.NetworkCapabilities
+import android.os.Build
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+
+class VconsoleModule(reactContext: ReactApplicationContext) :
+  ReactContextBaseJavaModule(reactContext) {
+
+  override fun getName(): String {
+    return NAME
+  }
+
+  // Example method
+  // See https://reactnative.dev/docs/native-modules-android
+  @ReactMethod
+  fun multiply(a: Double, b: Double, promise: Promise) {
+    promise.resolve(a * b)
+  }
+
+  @ReactMethod
+  fun getSystemInfo(promise: Promise) {
+    try {
+      val activityManager =
+        reactApplicationContext.getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
+      val memoryInfo = ActivityManager.MemoryInfo()
+      activityManager.getMemoryInfo(memoryInfo)
+
+      val connectivityManager =
+        reactApplicationContext.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
+      val network = connectivityManager.activeNetwork
+      val capabilities = connectivityManager.getNetworkCapabilities(network)
+
+      val networkType = when {
+        capabilities == null -> "none"
+        capabilities.hasTransport(NetworkCapabilities.TRANSPORT_WIFI) -> "wifi"
+        capabilities.hasTransport(NetworkCapabilities.TRANSPORT_CELLULAR) -> "cellular"
+        capabilities.hasTransport(NetworkCapabilities.TRANSPORT_ETHERNET) -> "ethernet"
+        else -> "unknown"
+      }
+
+      val map = Arguments.createMap()
+      map.putString("manufacturer", Build.MANUFACTURER ?: "")
+      map.putString("model", Build.MODEL ?: "")
+      map.putString("osVersion", Build.VERSION.RELEASE ?: "")
+      map.putString("networkType", networkType)
+      map.putBoolean("isNetworkReachable", capabilities != null)
+      map.putDouble("totalMemory", memoryInfo.totalMem.toDouble())
+      map.putDouble("availableMemory", memoryInfo.availMem.toDouble())
+      promise.resolve(map)
+    } catch (error: Exception) {
+      promise.reject("SYSTEM_INFO_ERROR", error)
+    }
+  }
+
+  @ReactMethod
+  fun getAppInfo(promise: Promise) {
+    try {
+      val packageInfo =
+        reactApplicationContext.packageManager.getPackageInfo(reactApplicationContext.packageName, 0)
+      val map = Arguments.createMap()
+      map.putString("appVersion", packageInfo.versionName ?: "")
+      map.putString("buildNumber", packageInfo.longVersionCode.toString())
+      promise.resolve(map)
+    } catch (error: Exception) {
+      promise.reject("APP_INFO_ERROR", error)
+    }
+  }
+
+  companion object {
+    const val NAME = "Vconsole"
+  }
+}

package/android/src/main/java/com/vconsole/VconsolePackage.kt

@@ -0,0 +1,17 @@
+package com.vconsole
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+
+class VconsolePackage : ReactPackage {
+  override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+    return listOf(VconsoleModule(reactContext))
+  }
+
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+    return emptyList()
+  }
+}

package/ios/Vconsole.h

@@ -0,0 +1,6 @@
+
+#import <React/RCTBridgeModule.h>
+
+@interface Vconsole : NSObject <RCTBridgeModule>
+
+@end

package/ios/Vconsole.mm

@@ -0,0 +1,64 @@
+#import "Vconsole.h"
+#import <UIKit/UIKit.h>
+
+@implementation Vconsole
+RCT_EXPORT_MODULE()
+
+// Example method
+// See // https://reactnative.dev/docs/native-modules-ios
+RCT_EXPORT_METHOD(multiply:(double)a
+                  b:(double)b
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+{
+    NSNumber *result = @(a * b);
+
+    resolve(result);
+}
+
+RCT_EXPORT_METHOD(getSystemInfo:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+{
+    @try {
+        UIDevice *device = [UIDevice currentDevice];
+        NSProcessInfo *processInfo = [NSProcessInfo processInfo];
+        double totalMemory = (double)processInfo.physicalMemory;
+
+        NSDictionary *payload = @{
+            @"manufacturer": @"Apple",
+            @"model": device.model ?: @"",
+            @"osVersion": device.systemVersion ?: @"",
+            @"networkType": @"unknown",
+            @"isNetworkReachable": @(NO),
+            @"totalMemory": @(totalMemory),
+            @"availableMemory": @(0)
+        };
+
+        resolve(payload);
+    } @catch (NSException *exception) {
+        reject(@"SYSTEM_INFO_ERROR", exception.reason, nil);
+    }
+}
+
+RCT_EXPORT_METHOD(getAppInfo:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+{
+    @try {
+        NSDictionary *infoDictionary =
+            [[NSBundle mainBundle] infoDictionary];
+        NSString *version =
+            [infoDictionary objectForKey:@"CFBundleShortVersionString"] ?: @"";
+        NSString *buildNumber =
+            [infoDictionary objectForKey:@"CFBundleVersion"] ?: @"";
+
+        NSDictionary *payload = @{
+            @"appVersion": version,
+            @"buildNumber": buildNumber
+        };
+        resolve(payload);
+    } @catch (NSException *exception) {
+        reject(@"APP_INFO_ERROR", exception.reason, nil);
+    }
+}
+
+@end