acikmrv/luminus-template

a template project for the Luminus framework

Luminus-Template

A Leiningen template for projects using Luminus.

The template initializes a base Luminus application.

Requirements

Luminus requires Leiningen version 2.x

Usage

The Luminus template ships out of the box with your latest Leiningen. Run the following command to create a new Luminus project which uses the default profile template:

lein new luminus <your project name>

However, if you would like to attach further functionality to your template you can append profile hints for these extended features:

• +cljs adds ClojureScript support to the project along with an example
• +h2 adds db.core namespace and H2 database dependencies
• +postgres adds db.core namespace and add PostreSQL database dependencies
• +mysql adds db.core namespace and add MySQL/MariaDB database dependencies
• +site registration/authentication, uses +h2 by default
• +dailycred combined with +site it uses DailyCred to authenticate
• +http-kit adds the fast HTTP Kit web server to the project
• +cucumber adds support for browser based UI testing with Cucumber and clj-webdriver
• +mongodb adds support for MongoDB using the Monger library

To add a profile simply pass it as an argument after your application name, e.g.:

lein new luminus myapp +cljs

You can also mix multiple profiles when creating the application, e.g.:

lein new luminus myapp +site +postgres

To build as a executable Java ARchive (JAR) standalone, run the following command:

lein ring uberjar

To run the resulting standalone executable .jar file, do as you would with any other:

user$ java -jar target/myapp-0.1.0-SNAPSHOT-standalone.jar

2012-12-15 19:17:23.471:INFO:oejs.Server:jetty-7.x.y-SNAPSHOT
2012-12-15 19:17:23.512:INFO:oejs.AbstractConnector:Started
[email protected]:3000
Server started on port [ 3000 ].
You can view the site at http://localhost:3000

To build a WAR (or Web application ARchive) file run:

lein ring uberwar

You can then easily deploy the resulting WAR to Tomcat or any other Java application server.

License

Copyright © 2012 Yogthos

Distributed under the MIT License.