diff --git a/ftplugin/kotlin.vim b/ftplugin/kotlin.vim
new file mode 100644
index 00000000..111e61a9
--- /dev/null
+++ b/ftplugin/kotlin.vim
@@ -0,0 +1,138 @@
+let s:save_cpo = &cpoptions
+set cpoptions&vim
+
+let b:doge_patterns = []
+
+" Matches the following pattern:
+"   <param-name>: <param-type>
+"
+" Matches the following scenarios:
+"
+"   (map: MutableMap<String, Any?>, str: String.() -> Unit)
+"
+"   (str: String.() -> Unit, map: MutableMap<String, Any?>)
+"
+"   (map: MutableMap<String, <T>>, str: String.() -> Unit)
+"
+"   (map: MutableMap, str: String)
+"
+"   (onetime: Boolean = true, callback: () -> Unit)
+let s:parameters_match_pattern = '\m\%(\%(var\|val\)\s\+\)\?\([[:alnum:]_]\+\)\%(\s*:\s*\%([[:alnum:]_]\+\)\?\%(<[[:alnum:][:space:]_,<>:?]\+>\|[^,]\+\)\?\)\?'
+
+" ==============================================================================
+" Matches regular functions, class methods and extension functions.
+" ==============================================================================
+"
+" Matches the following scenarios:
+"
+"   fun MutableList<Int>.swap<Int>(index1: Int, index2: Int) {
+"
+"   fun listenForPackageChanges(onetime: Boolean = true, callback: () -> Unit) = object : BroadcastReceiver() {}
+"
+"   inline fun <reified T : Enum<T>> printAllValues() {}
+"
+"   fun <T> id(x: T): T = x
+"
+"   fun readOut(group: Group<out Animal>) {}
+"
+"   fun readIn(group: Group<in Nothing>) {}
+"
+"   fun acceptAnyList(list: List<Any?>) {}
+"
+"   inline fun <reified T: Any> Gson.fromJson(json: JsonElement): T = this.fromJson(json, T::class.java)
+"
+"   open fun f() { println("Foo.f()") }
+call add(b:doge_patterns, {
+\  'match': '\m^\%(\%(public\|protected\|private\|final\|inline\|abstract\|override\|operator\|open\|data\)\s\+\)*fun\s\+\%([^(]\+\)\s*(\(.\{-}\))\%(\s*:\s*[[:alnum:]_:\.]\+\%(<[[:alnum:][:space:]_,<>:?]\+>\)\??\?\)\?\s*[={]',
+\  'match_group_names': ['parameters'],
+\  'parameters': {
+\    'match': s:parameters_match_pattern,
+\    'match_group_names': ['name'],
+\    'format': ['@param', '{name}', 'TODO'],
+\  },
+\  'comment': {
+\    'insert': 'above',
+\    'template': [
+\      '/**',
+\      ' * TODO',
+\      ' * {parameters}',
+\      ' * @return TODO',
+\      ' */',
+\    ],
+\  },
+\})
+
+" ==============================================================================
+" Matches classes.
+" ==============================================================================
+"
+" Matches the following scenarios:
+"
+"   class Outer {}
+"
+"   inner class Inner {}
+"
+"   data class User(val name: String, val age: Int) {}
+"
+"   enum class Color(val rgb: Int) {}
+"
+"   class Person constructor(firstName: String) {}
+"
+"   class C private constructor(a: Int) {}
+"
+"   class Person(firstName: String) {}
+"
+"   class MyView : View {}
+"
+"   inline class Name(val s: String) {}
+"
+"   abstract class Vehicle(val name: String, val color: String, val weight: Double) {}
+call add(b:doge_patterns, {
+\  'match': '\m^\%(\%(inner\|inline\|data\|enum\|open\|abstract\|sealed\)\s\+\)*class\s\+\%([[:alnum:]_]\+\%(<[[:alnum:][:space:]_,<>:?]\+>\)\?\)\s*\%(\%(public\|private\|protected\)\s*\)\?\%(constructor\s*\)\?(\(.\{-}\))',
+\  'match_group_names': ['parameters'],
+\  'parameters': {
+\    'match': s:parameters_match_pattern,
+\    'match_group_names': ['name'],
+\    'format': ['@param', '{name}', 'TODO'],
+\  },
+\  'comment': {
+\    'insert': 'above',
+\    'template': [
+\      '/**',
+\      ' * TODO',
+\      ' * {parameters}',
+\      ' * @return TODO',
+\      ' */',
+\    ],
+\  },
+\})
+
+" ==============================================================================
+" Matches constructors inside a class.
+" ==============================================================================
+"
+" Matches the following scenarios:
+"
+"   constructor(parent: Person) {}
+call add(b:doge_patterns, {
+\  'match': '\m^\%(\%(public\|private\|protected\)\s\+\)\?constructor\s*(\(.\{-}\))',
+\  'match_group_names': ['parameters'],
+\  'parameters': {
+\    'match': s:parameters_match_pattern,
+\    'match_group_names': ['name'],
+\    'format': ['@param', '{name}', 'TODO'],
+\  },
+\  'comment': {
+\    'insert': 'above',
+\    'template': [
+\      '/**',
+\      ' * TODO',
+\      ' * {parameters}',
+\      ' * @return TODO',
+\      ' */',
+\    ],
+\  },
+\})
+
+let &cpoptions = s:save_cpo
+unlet s:save_cpo
diff --git a/playground/test.kt b/playground/test.kt
new file mode 100644
index 00000000..bc009efa
--- /dev/null
+++ b/playground/test.kt
@@ -0,0 +1,538 @@
+/**
+ * This file contains test scenarios and their expected results. You should be
+ * able to generate the examples below.
+ */
+
+ // Variable types
+ // - var
+ // - val (read-only)
+
+// =============================================================================
+// Functions
+// =============================================================================
+/**
+ * TODO
+ * @param a TODO
+ * @param b TODO
+ * @return TODO
+ */
+fun sum(a: Int, b: Int): Int {
+  return a + b
+}
+
+/**
+ * TODO
+ * @param a TODO
+ * @param b TODO
+ * @return TODO
+ */
+fun sum(a: Int, b: Int) = a + b
+
+/**
+ * TODO
+ * @param a TODO
+ * @param b TODO
+ * @return TODO
+ */
+fun printSum(a: Int, b: Int) {
+  println("sum of $a and $b is ${a + b}")
+}
+
+/**
+ * TODO
+ * @param map TODO
+ * @param str TODO
+ * @return TODO
+ */
+fun parseInt(map: MutableMap<String, Any?>, str: String): Int? {}
+
+/**
+ * TODO
+ * @param map TODO
+ * @param str TODO
+ * @return TODO
+ */
+fun parseInt(map: MutableMap<String, Any?>, str: String<String, <T>>): Int? {}
+
+/**
+ * TODO
+ * @param str TODO
+ * @param map TODO
+ * @return TODO
+ */
+fun parseInt(str: String<String, <T>>, map: MutableMap<String, Any?>): Int? {}
+
+/**
+ * TODO
+ * @param map TODO
+ * @param str TODO
+ * @return TODO
+ */
+fun parseInt(map: MutableMap<String, Any?>, str: String.() -> Unit): Int? {}
+
+/**
+ * TODO
+ * @param str TODO
+ * @param map TODO
+ * @return TODO
+ */
+fun parseInt(str: String.() -> Unit, map: MutableMap<String, Any?>) {}
+
+/**
+ * TODO
+ * @param json TODO
+ * @return TODO
+ */
+inline fun Gson.fromJson(json: JsonElement): T {}
+
+/**
+ * TODO
+ * @param json TODO
+ * @return TODO
+ */
+inline fun <reified T: Any> Gson.fromJson(json: JsonElement): T = this.fromJson(json, T::class.java) {}
+
+/**
+ * TODO
+ * @param onetime TODO
+ * @param callback TODO
+ * @return TODO
+ */
+fun listenForPackageChanges(onetime: Boolean = true, callback: () -> Unit): Int? = object : BroadcastReceiver() {
+
+/**
+ * TODO
+ * @return TODO
+ */
+inline fun <reified T : Enum<T>> printAllValues() {
+  print(enumValues<T>().joinToString { it.name })
+}
+
+/**
+ * TODO
+ * @param x TODO
+ * @return TODO
+ */
+fun <T> id(x: T): T = x
+
+/**
+ * TODO
+ * @param i TODO
+ * @return TODO
+ */
+open data fun asNullable(i: Foo?) {}
+
+/**
+ * TODO
+ * @param x TODO
+ * @return TODO
+ */
+fun demo(x: Comparable<Number>) {}
+
+/**
+ * TODO
+ * @param group TODO
+ * @param user TODO
+ * @param test TODO
+ * @return TODO
+ */
+fun readStar(group: Group<*>, user: User<*>, test: Boolean) {}
+
+/**
+ * TODO
+ * @param group TODO
+ * @return TODO
+ */
+fun readOut(group: Group<out Animal>) {}
+
+/**
+ * TODO
+ * @param group TODO
+ * @return TODO
+ */
+fun readIn(group: Group<in Nothing>) {}
+
+/**
+ * TODO
+ * @param list TODO
+ * @return TODO
+ */
+fun acceptAnyList(list: List<Any?>) {}
+
+/**
+ * TODO
+ * @param from TODO
+ * @param to TODO
+ * @return TODO
+ */
+fun copy(from: Array<Any>, to: Array<Any>) {}
+
+// =============================================================================
+// Functions: visibility modifiers
+// =============================================================================
+// Options: public | protected | private | inline 
+
+/**
+ * TODO
+ * @param list TODO
+ * @return TODO
+ */
+private fun foo(list: List<Any?>) {}
+
+// =============================================================================
+// Extension Functions
+// =============================================================================
+/**
+ * TODO
+ * @param index1 TODO
+ * @param index2 TODO
+ * @return TODO
+ */
+fun <T> MutableList<Int>.swap(index1: Int, index2: Int) {}
+
+/**
+ * TODO
+ * @param index1 TODO
+ * @param index2 TODO
+ * @return TODO
+ */
+fun MutableList<Int>.swap(index1: Int, index2: Int) {}
+
+/**
+ * TODO
+ * @param index1 TODO
+ * @param index2 TODO
+ * @return TODO
+ */
+fun <T> MutableList.swap(index1: Int, index2: Int) {}
+
+/**
+ * TODO
+ * @param index1 TODO
+ * @param index2 TODO
+ * @return TODO
+ */
+fun MutableList.swap(index1: Int, index2: Int) {}
+
+/**
+ * TODO
+ * @param index1 TODO
+ * @param index2 TODO
+ * @return TODO
+ */
+fun swap(index1: Int, index2: Int) {}
+
+/**
+ * TODO
+ * @param index1 TODO
+ * @param index2 TODO
+ * @return TODO
+ */
+fun <T> MutableList<T>.swap(index1: Int, index2: Int) {}
+
+/**
+ * TODO
+ * @return TODO
+ */
+fun Any?.toString(): String {
+  if (this == null) return "null"
+  // after the null check, 'this' is autocast to a non-null type, so the toString() below
+  // resolves to the member function of the Any class
+  return toString()
+}
+
+// =============================================================================
+// Classes: Implementation by Delegation
+// =============================================================================
+/**
+ * TODO
+ * @param b TODO
+ * @return TODO
+ */
+class Derived(b: Base) : Base by b
+
+class Delegate {
+  /**
+   * TODO
+   * @param thisRef TODO
+   * @param property TODO
+   * @return TODO
+   */
+  operator fun getValue(thisRef: Any?, property: KProperty<*>): String {
+    return "$thisRef, thank you for delegating '${property.name}' to me!"
+  }
+
+  /**
+   * TODO
+   * @param thisRef TODO
+   * @param property TODO
+   * @param value TODO
+   * @return TODO
+   */
+  operator fun setValue(thisRef: Any?, property: KProperty<*>, value: String) {
+    println("$value has been assigned to '${property.name}' in $thisRef.")
+  }
+}
+
+/**
+ * TODO
+ * @param map TODO
+ * @return TODO
+ */
+class MutableUser(val map: MutableMap<String, Any?>) {
+  var name: String by map
+  var age: Int     by map
+}
+
+class ResourceDelegate<T> : ReadOnlyProperty<MyUI, T> {
+  override fun getValue(thisRef: MyUI, property: KProperty<*>): T { ... }
+}
+
+/**
+ * TODO
+ * @param id TODO
+ * @return TODO
+ */
+class ResourceLoader<T>(id: ResourceID<T>) {
+  operator fun provideDelegate(
+      thisRef: MyUI,
+      prop: KProperty<*>
+  ): ReadOnlyProperty<MyUI, T> {
+    checkProperty(thisRef, prop.name)
+    // create delegate
+    return ResourceDelegate()
+
+  }
+
+  private fun checkProperty(thisRef: MyUI, name: String) { ... }
+}
+
+class MyUI {
+  fun <T> bindResource(id: ResourceID<T>): ResourceLoader<T> { ... }
+
+  val image by bindResource(ResourceID.image_id)
+  val text by bindResource(ResourceID.text_id)
+}
+
+
+// =============================================================================
+// Classes: Companion Object Extensions
+// =============================================================================
+class MyClass {
+  companion object { }  // will be called "Companion"
+}
+
+/**
+ * TODO
+ * @return TODO
+ */
+fun MyClass.Companion.foo() { ... }
+
+// =============================================================================
+// Inline classes
+// =============================================================================
+/**
+ * TODO
+ * @param s TODO
+ * @return TODO
+ */
+inline class Name(val s: String) {
+  val length: Int
+  get() = s.length
+
+  fun greet() {
+    println("Hello, $s")
+  }
+}
+
+// =============================================================================
+// Data classes
+// =============================================================================
+/**
+ * TODO
+ * @param name TODO
+ * @param age TODO
+ * @return TODO
+ */
+data class User(val name: String, val age: Int)
+
+// =============================================================================
+// Inner classes
+// =============================================================================
+class Outer {
+  private val bar: Int = 1
+  inner class Inner {
+    fun foo() = bar
+  }
+}
+
+// =============================================================================
+// Enum classes
+// =============================================================================
+/**
+ * TODO
+ * @param rgb TODO
+ * @return TODO
+ */
+enum class Color(val rgb: Int) {
+  RED(0xFF0000),
+  GREEN(0x00FF00),
+  BLUE(0x0000FF)
+}
+
+enum class RGB { RED, GREEN, BLUE }
+
+// =============================================================================
+// Classes: primary constructors
+// =============================================================================
+/**
+ * TODO
+ * @param firstName TODO
+ * @return TODO
+ */
+class Person constructor(firstName: String) { ... }
+
+/**
+ * TODO
+ * @param a TODO
+ * @return TODO
+ */
+class C private constructor(a: Int) { ... }
+
+/**
+ * TODO
+ * @param firstName TODO
+ * @return TODO
+ */
+class Person(firstName: String) { ... }
+
+// =============================================================================
+// Classes: secondary constructors
+// =============================================================================
+class Person {
+  /**
+   * TODO
+   * @param parent TODO
+   * @return TODO
+   */
+  constructor(parent: Person) {
+    parent.children.add(this)
+  }
+}
+
+class Person(val name: String) {
+  /**
+   * TODO
+   * @param name TODO
+   * @param parent TODO
+   * @return TODO
+   */
+  constructor(name: String, parent: Person) : this(name) {
+    parent.children.add(this)
+  }
+}
+
+// =============================================================================
+// Classes: inheritance
+// =============================================================================
+class MyView : View {
+  /**
+   * TODO
+   * @param ctx TODO
+   * @return TODO
+   */
+  protected constructor(ctx: Context) : super(ctx)
+
+  constructor(ctx: Context, attrs: AttributeSet) : super(ctx, attrs)
+}
+
+// =============================================================================
+// Abstract classes & methods
+// =============================================================================
+/**
+ * TODO
+ * @param name TODO
+ * @param color TODO
+ * @param weight TODO
+ * @return TODO
+ */
+abstract class Vehicle(val name: String, val color: String, val weight: Double) {
+  /**
+   * TODO
+   * @param t TODO
+   * @param u TODO
+   * @return TODO
+   */
+  abstract fun signal(t: Int, u: Int) = apply(t, u)
+}
+
+// =============================================================================
+// Classes: methods
+// =============================================================================
+class Bar2 : Foo {
+  /**
+   * TODO
+   * @return TODO
+   */
+  override fun v() {}
+
+  final override fun v() {}
+}
+
+open class Base {
+  open fun v() { ... }
+  fun nv() { ... }
+}
+/**
+ * TODO
+ * @return TODO
+ */
+class Derived() : Base() {
+  override fun v() { ... }
+}
+
+open class Foo {
+  open fun f() { println("Foo.f()") }
+  open val x: Int get() = 1
+}
+
+class Bar : Foo() {
+  override fun f() {
+    super.f()
+    println("Bar.f()")
+  }
+
+  override val x: Int get() = super.x + 1
+}
+
+// =============================================================================
+// Classes: interfaces
+// =============================================================================
+interface A {
+  fun foo() { print("A") }
+  fun bar()
+}
+
+interface B {
+  fun foo() { print("B") }
+  fun bar() { print("bar") }
+}
+
+class D : A, B {
+  /**
+   * TODO
+   * @return TODO
+   */
+  override fun foo() {
+    super<A>.foo()
+    super<B>.foo()
+  }
+
+  /**
+   * TODO
+   * @return TODO
+   */
+  override fun bar() {
+    super<B>.bar()
+  }
+}