Luminus-Template

A Leiningen template for projects using Luminus.

The template initializes a base Luminus application.

Requirements

Luminus requires Leiningen version 2.5.3+

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:

alternative servers

• +aleph adds the Aleph server
• +http-kit adds the fast HTTP Kit web server to the project
• +immutant adds the immutant web server to the project. Note: this project is no longer funded/maintained
• +jetty adds the jetty web server to the project

The default server is ring-undertow

databases

• +h2 adds db.core namespace and H2 database dependencies
• +postgres adds db.core namespace and PostreSQL database dependencies
• +mysql adds db.core namespace and MySQL/MariaDB database dependencies
• +mongodb adds support for MongoDB using the Monger library
• +datomic adds support for the Datomic database
• +sqlite adds support for the SQLite database

service API

• +graphql adds GraphQL support using Lacinia
• +swagger adds support for Swagger-UI
• +service removes static assets and the layout, adds Swagger support

ClojureScript

• +cljs adds ClojureScript support to the project
• +reagent adds ClojureScript support with Reagent to the project along with an example
• +re-frame adds ClojureScript support with re-frame to the project along with an example
• +kee-frame adds kee-frame to the project
• +shadow-cljs adds shadow-cljs support to the project, replacing the default cljsbuild and figwheel setup

misc

• +boot causes the project to run with Boot instead of Leiningen
• +auth adds Buddy dependency and authentication middleware
• +auth-jwe adds Buddy dependency with the JWE backend
• +oauth adds OAuth dependency
• +hoplon adds ClojureScript support with Hoplon to the project
• +cucumber adds support for browser based UI testing with Cucumber and clj-webdriver
• +sassc adds support for SASS/SCSS files using SassC command line compiler
• +war adds support of building WAR archives for deployment to servers such as Apache Tomcat (should NOT be used for Immutant apps running on WildFly)
• +site creates template for site using the specified database (H2 by default) and ClojureScript
• +kibit adds lein-kibit plugin
• +servlet adds middleware for handling Servlet context
• +basic generates a bare bones luminus project

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 +auth +postgres

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

lein uberjar

Or if using the +boot profile:

boot uberjar

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

user$ java -jar target/myapp.jar
15-Sep-14 16:06:21 APc47d.4f39.65e6.uhn.ca INFO [myapp.handler] -
-=[myapp started successfully]=-
16:06:21.685 INFO  [org.projectodd.wunderboss.web.Web] (main) Registered web context /
15-Sep-14 16:06:21 APc47d.4f39.65e6.uhn.ca INFO [myapp.core] - server started on port: 3002

Performance Testing

The app can be stress tested by running the Apache benchmark command:

ab -c 10 -n 1000 http://127.0.0.1:3000/

The memory and CPU usage can be inspected by running either jconsole or jvisualvm and attaching them to a running Luminus server.

Other Templates

• chestnut
• duct
• fulcro-template
• pedestal
• reagent-template
• re-frame-template
• reagent-figwheel
• reagent-seed
• vase

There is also a public comparison chart of the common templates.

License

Copyright © 2016 Dmitri Sotnikov

Distributed under the MIT License.