Congratulations, your Luminus site is ready!

This page will help guide you through the first steps of building your site.

Why are you seeing this page?

The home-routes handler in the guestbook.routes.home namespace defines the route that invokes the home-page function whenever an HTTP request is made to the / URI using the GET method.

(defn home-routes []
  [""
   {:middleware [middleware/wrap-csrf
                 middleware/wrap-formats]}
   ["/" {:get home-page}]
   ["/about" {:get about-page}]])

The home-page function will in turn call the guestbook.layout/render function to render the HTML content:

(defn home-page [request]
  (layout/render
    request 
    "home.html" {:docs (-> "docs/docs.md" io/resource slurp)}))

The render function will render the home.html template found in the resources/html folder using a parameter map containing the :docs key. This key points to the contents of the resources/docs/docs.md file containing these instructions.

The HTML templates are written using Selmer templating engine.

<div class="content">
  {{docs|markdown}}
</div>

learn more about HTML templating »

Organizing the routes

The routes are aggregated and wrapped with middleware in the guestbook.handler namespace:

(mount/defstate app-routes
  :start
  (ring/ring-handler
    (ring/router
      [(home-routes)])
    (ring/routes
      (ring/create-resource-handler
        {:path "/"})
      (wrap-content-type
        (wrap-webjars (constantly nil)))
      (ring/create-default-handler
        {:not-found
         (constantly (error-page {:status 404, :title "404 - Page not found"}))
         :method-not-allowed
         (constantly (error-page {:status 405, :title "405 - Not allowed"}))
         :not-acceptable
         (constantly (error-page {:status 406, :title "406 - Not acceptable"}))}))))

The app definition groups all the routes in the application into a single handler. A default route group is added to handle the 404 case.

learn more about routing »

The home-routes are wrapped with two middleware functions. The first enables CSRF protection. The second takes care of serializing and deserializing various encoding formats, such as JSON.

Managing your middleware

Request middleware functions are located under the guestbook.middleware namespace.

This namespace is reserved for any custom middleware for the application. Some default middleware is already defined here. The middleware is assembled in the wrap-base function.

Middleware used for development is placed in the guestbook.dev-middleware namespace found in the env/dev/clj/ source path.

learn more about middleware »

Need some help?

Visit the official documentation for examples on how to accomplish common tasks with Luminus. The #luminus channel on the Clojurians Slack and Google Group are both great places to seek help and discuss projects with other users.