Linguine is a Kotlin-based Gradle plugin that simplifies localization in multiplatform, Android, or JVM projects by automatically converting JSON localization files into Kotlin code. It keeps localized strings type-safe and integrated into your build process, reducing boilerplate.

• JSON Localization Support
  Converts JSON localization files into Kotlin object structures with type-safe string accessors using configurable delimiters.

• Automatic Package Naming
  Builds the Kotlin package name from the generated file’s location relative to sourceRootPath, keeping your codebase organized.

• Configurable Naming
  Customize key delimiters and the suffix used for generated file and object names via outputSuffix (e.g. Strings, L10n).

• Incremental Build Support
  Processes only changed files, speeding up builds.

• Multiplatform Compatible
  Works with Kotlin Multiplatform, Android, and JVM projects.

Add this to your module-level build.gradle.kts:

plugins {
    id("com.qinshift.linguine") version "x.y.z"
}

linguine {
    inputFilePath = "localization-data/en/strings.json"
    outputFilePath = "src/commonMain/kotlin/com/example/app/localisation/en"
    sourceRootPath = "src/commonMain/kotlin"
    outputSuffix = "Strings"
    majorDelimiter = "__"
    minorDelimiter = "_"
}

The package name is computed from the relative path between sourceRootPath and outputFilePath.

Example:

linguine {
    inputFilePath = "localization-data/en/strings.json"
    outputFilePath = "src/commonMain/kotlin/com/example/app/localisation/en"
    sourceRootPath = "src/commonMain/kotlin"
}

➡️ Package name:

package com.example.app.localisation.en

If the relative path is empty or invalid, it falls back to:

package presentation

{
  "home__welcome_message": "Welcome Home!"
}

Assuming:

outputSuffix = "Strings"

Generated file:

package com.example.app.localisation.en

import com.qinshift.linguine.linguineruntime.presentation.Localiser.localise

object HomeStrings {
    val welcomeMessage: String = localise("home__welcome_message")
}

val msg = HomeStrings.welcomeMessage

The plugin registers a generateStrings task and wires it into the build.

Run the full build:

./gradlew build

Or, run string generation directly:

./gradlew generateStrings

If you set buildTaskName, that task will depend on generateStrings; otherwise all compile* tasks will.

See license.md.