LogKat

1.0.0indexed

Unified cross-platform logging solution simplifies message logging for Android and iOS with a single API, featuring color-coded log levels and platform-specific outputs for efficient debugging.

AndroidNative·prashant17d97/LogKat

Stars

—

Used by

dependents

—

Health

/ 100

LogKat - KMP Log Library

The LogKat is a Kotlin Multiplatform (KMP) library that provides a unified solution for logging across Android and iOS platforms. This library simplifies cross-platform logging by eliminating the need for separate platform-specific code. With a single API, you can log messages that will appear in Android's Logcat or iOS's console, depending on the platform your app is running on.

Key Features

Cross-Platform Logging: Supports logging on both Android and iOS with no extra setup.
Unified API: One simple API for logging across both platforms.
Color-Coded Output: Logs are color-coded based on severity (Info, Debug, Warning, Verbose, Error) for easy identification.
Platform-Specific Output:
- On Android, logs are sent to Logcat.
- On iOS, logs appear in the console (stdout), ideal for debugging.

Why Use LogKat?

Developers using Kotlin Multiplatform (KMP) often write separate logging logic for Android and iOS. This library eliminates that complexity by providing a single-line logging solution that works for both platforms. Here's why LogKat makes sense for your project:

Consistency Across Platforms: No need to handle platform-specific log methods—use one consistent function.
Increased Productivity: Spend less time on platform-specific logging code.
Ease of Integration: Just add the library and start logging.

iOS Logging Example

Here’s a sample of the log output in the iOS terminal console:

Android Logging Example

Here’s a sample of the log output in Android Logcat:

Installation

To use LogKat, add the following dependency in your Kotlin Multiplatform project:

Gradle Setup

dependencies {
    implementation("io.github.prashant17d97:logkat:1.0.0")
}

Ensure your project is retrieving dependencies from Maven Central:

repositories {
    mavenCentral()
}

How to Use

The library provides a simple API that handles platform-specific logging:

import io.github.prashant17d97.logkat.LogKat

LogKat.i("TestLogKat", "This is an informational message")
LogKat.d("TestLogKat", "Debugging message for developers")
LogKat.w("TestLogKat", "Warning: Something might be wrong!")
LogKat.v("TestLogKat", "Verbose message for detailed logging")
LogKat.e("TestLogKat", "Error occurred! Please investigate.")

Example Output

Android (Logcat):

iOS (Console):

Supported Log Levels

The following log levels are supported, and each is color-coded:

INFO (Green)
DEBUG (Blue)
WARN (Yellow)
VERBOSE (Purple)
ERROR (Red)

How It Works

LogKat abstracts platform-specific logging:

On Android, logs are sent to Logcat.
On iOS, logs appear in the system console (stdout).

This means you use one line of code for both platforms without any additional platform checks or specific code.

Get in Touch & Collaboration

If you have any questions or would like to collaborate, feel free to reach out!

Email: prashantsinghsca@gmail.com
LinkedIn: Prashant Kumar Singh
Twitter: @prashant17d97

Contributions to the project are always welcome! Feel free to open issues or submit pull requests on GitHub.

License

This library is distributed under the MIT License. You are free to use, modify, and distribute it under the terms of this license.

Related libraries

Surfaced from shared tags and platforms — no rankings paid for.

kotlin-logging★ 3.1k

oshaiLightweight logging framework offering a performant logging facade with lazy-eval string logging, exception handling, and fluent logging style. Simplifies logger initialization and supports various SLF4J implementations.Shared: logging

Kermit★ 1.0k

touchlabOffers structured logging with configurable log levels, tagging, and output destinations. Supports logging to console, file, and custom destinations with flexible configuration options.Shared: logging

Napier★ 996

aakiraLogger library supports multiple platforms, displaying logs on each platform's native viewer. Features include customizable log levels, throwable logging, and integration with Crashlytics.Shared: logging

klogging★ 245

kloggingFlexible logging library designed for creating structured log events, leveraging coroutines for asynchronous event dispatch, and supporting high-resolution timestamps. Includes adapters for SLF4J, Spring Boot, and Hexagon frameworks.Shared: logging

stream-log★ 143

GetStreamLightweight, extensible logger library for managing, printing, and persisting runtime log messages. Supports platform-specific loggers, composite loggers, and validators for customized logging behavior.Shared: logging

wire-avs★ 142

wireappReal-time audio, video and signaling stack with WebRTC integration, CLI client (zcall), build tooling, static libraries and standards-compliant features like trickle-ICE, STUN consent freshness, data channels.Shared: logging