[[https://raw.githubusercontent.com/clojure-android/neko/master/doc/big_logo.png]]
[[https://travis-ci.org/clojure-android/neko/][https://travis-ci.org/clojure-android/neko.svg?branch=master]] [[https://coveralls.io/r/clojure-android/neko][https://coveralls.io/repos/clojure-android/neko/badge.svg?branch=master]] [[http://jarkeeper.com/clojure-android/neko][http://jarkeeper.com/clojure-android/neko/status.png]]
Neko is a toolkit designed to make Android development using Clojure easier and more fun. It provides different facilities that wrap Android's Java API and are more idiomatic to use from Clojure. Neko does not try to wrap every API class or method, as they are always accessible to a developer through interop. Instead Neko only offers substitutes to Java API where it really simplifies the development and gives better understanding of the code.
Neko is developed under [[http://clojure-android.info/][Clojure-Android initiative]].
** Installation
Add the following line to the dependencies of your Clojure/Android project:
[[https://clojars.org/neko][https://clojars.org/neko/latest-version.svg]]
If you use [[https://github.com/clojure-android/lein-droid][lein-droid]] to create and build your project (which you should), the Neko dependency will already be there.
** Documentation
For your first dive into Clojure on Android development, see this [[https://github.com/clojure-android/lein-droid/wiki/Tutorial][Tutorial]].
For detailed information on available features and utilities, please consult the [[https://github.com/alexander-yakushev/neko/wiki][wiki]].
Marginalia docs are available [[http://clojure-android.github.io/neko/][here]].
** Building Neko
If you want to modify/extend Neko source code and then use it in your applications, you can build it yourself. Use =lein droid jar= in neko's directory to create a JAR file which then can be pushed to Clojars under your name or installed into a local Maven repo.
Make sure that =:target-version= defined in =project.clj= matches the Android SDK version you have installed.
If you have problems building Neko, try running =lein clean= first. Also you can use =DEBUG=1 lein droid jar= for additional build information.
** Acknowledgments
Neko was originally written by [[https://github.com/sattvik][Daniel Solano Gómez]]. This version is a fork by Alexander Yakushev as part of Google Summer of Code 2012/2013 participation project.
I thank Remco van 't Veer for his [[https://github.com/remvee/clj-android][clj-android]] library which was one of the pioneer attempts to bring Clojure to Android development. Some features in my Neko fork are inspired by ideas from his project.
I also thank all the [[https://github.com/alexander-yakushev/neko/graphs/contributors][contributors]] to Neko.
Cat icon used in the logo is designed by [[http://www.freepik.com/][Freepik]] from Flaticon.com.
** Legal information
Copyright © 2011-2013 Sattvik Software & Technology Resources, Ltd. Co., 2012-2015 Alexander Yakushev
All rights reserved.
Licensed under Eclipse Public License v1.0. See [[https://github.com/alexander-yakushev/neko/blob/master/LICENSE][LICENSE]].