Repolode
cortinico

cortinico/kotlin-android-template

A GitHub template for starting Android/Kotlin projects with static analysis, CI via GitHub Actions, and Maven Central publishing already configured.

Stars
1,916
Forks
268
Open issues
12
Last commit
10 days ago

What is it?

kotlin-android-template is a GitHub template repository that generates a new Android project written entirely in Kotlin. Using the template creates a fresh repo with a working Gradle build, so developers can start writing code instead of wiring up tooling.

The template ships four sample modules: an Android app, an Android library, a pure Kotlin library, and a Jetpack Compose activity. Builds use the Gradle Kotlin DSL with the Plugin DSL and a Gradle Version Catalog, and dependency versions are managed through buildSrc. Detekt and ktlint are configured for static analysis, and Espresso, instrumentation and JUnit tests are included as examples.

CI runs on GitHub Actions and checks the Gradle wrapper, runs build and check tasks on pull requests, and publishes snapshot and release artifacts. Publishing to Maven Central is set up through repository secrets, and JitPack is supported as an alternative.

Key features

  • 01Kotlin-only project template with four sample modules, including Jetpack Compose.
  • 02Gradle Kotlin DSL build with a Version Catalog and buildSrc-managed dependencies.
  • 03Static analysis with detekt and ktlint.
  • 04CI workflows on GitHub Actions for pre-merge checks and publishing.
  • 05Publishing setup for Maven Central, with JitPack support.
  • 06Sample Espresso, instrumentation and JUnit tests.

Use cases

  • Starting a new Android app that needs linting and CI from day one.
  • Creating an Android or Kotlin library to publish to Maven Central.
  • Learning a modern Android setup with Gradle Kotlin DSL and Jetpack Compose.

Quick start

  1. 1

    Click the Use this template button on GitHub to create your own repo

  2. 2

    Update the App ID, AndroidManifest and package names as described in How to use

  3. 3

    Turn on Read and Write permissions for GitHub Actions in your repository settings so CI runs

Things to know

  • Publishing to Maven Central requires configuring Sonatype accounts and GPG signing keys.

In collections

Topics

FAQ

What is kotlin-android-template?
A GitHub template for starting Android/Kotlin projects with static analysis, CI via GitHub Actions, and Maven Central publishing already configured. kotlin-android-template is a GitHub template repository that generates a new Android project written entirely in Kotlin. Using the template creates a fresh repo with a working Gradle build, so developers can start writing code instead of wiring up tooling.
Is kotlin-android-template free to use? What license does it have?
kotlin-android-template is open source under the MIT license. Check the license terms before using it in commercial products.
Is kotlin-android-template still maintained?
Actively maintained. The last commit to kotlin-android-template was on Oct 28, 2026.
What can I use kotlin-android-template for?
Starting a new Android app that needs linting and CI from day one. Creating an Android or Kotlin library to publish to Maven Central. Learning a modern Android setup with Gradle Kotlin DSL and Jetpack Compose.
How do I install kotlin-android-template?
Click the Use this template button on GitHub to create your own repo Update the App ID, AndroidManifest and package names as described in How to use Turn on Read and Write permissions for GitHub Actions in your repository settings so CI runs
Where can I get kotlin-android-template?
The source code and installation instructions are on GitHub: https://github.com/cortinico/kotlin-android-template

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects