Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Clojure Shell
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


A Leiningen template for standalone koan projects based on the Clojure Koan Engine.


Add the needed plugins to your ~/.lein/profile.clj file

{:user {:plugins [[koan-template "0.1.2"]]}}

Now you can create a new project using the leiningen template:

lein new koan <your-project-name>
cd <your-project-name>
chmod +x script/*

Run lein koan run to see the included example koan. The README of the resulting project will contain everything your users need to know to run the koans.

Customizing your new project

All new projects will require the following steps:

  • add custom dependencies to project.clj. (Clojure defaults to 1.3.0, but feel free to roll back to 1.2.1 if your library needs it.)
  • Delete the example koan at src/koans/example_koan.clj (or add to it!)
  • Add APIs and other namespaces to the Dojo, as discussed on the dojo wiki page.
  • Write some more koans using the instructions at the koan-engine github page.
  • Add proper solutions to resources/koans.clj
  • Customize

And that's it! The template handles all structure, leaving you to craft puzzles and delight users. Once you've got lein koan test passing again, make your code available to the world and await your students.

Standalone Distribution

koan-template includes the lein-koan plugin by default, as this tends to be the most familiar way for users to get up and running. If you're interested in reaching users without leiningen (as with clojure-koans), it can make sense to bundle a release version by running


This command creates a zipfile with all dependencies suitable for standalone distribution. The following scripts are included in the template for non-leiningen users on Mac/*nix:


And on Windows:



Koan-template rides on lein-newnew by Raynes, a young jedi who you've almost certainly heard of.


The use and distribution terms for this software are covered by the Eclipse Public License 1.0 ( which can be found in the file epl-v10.html at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license.

Something went wrong with that request. Please try again.