/pedestal

The Pedestal web application framework

Primary LanguageClojure

Pedestal Build Status

Pedestal is a web application framework written in Clojure that aims to bring both the language and its principles (Simplicity, Power and Focus) to client and server-side development.

Getting started

Starting a new project

Use leiningen (2.2.0+) to create a new Pedestal application or service. This will automatically pull templates from http://clojars.org

# To create a new client-side application:
lein new pedestal-app the-next-big-thing

# To create a new service:
lein new pedestal-service the-next-big-server-side-thing

See documentation for information on Pedestal concepts and advice on getting started.

Digging deeper

Roadmap

Our primary focus for the near future is Pedestal documentation, sample applications and improving general ease of use.

Documentation

  • Pedestal documentation: overview of Pedestal concepts and advice on getting started.
  • API Docs: generate literate-programming-style API docs by following the "What about API Documentation?" instructions in the Pedestal Overview.

Supported Platforms

At present Pedestal supports OSX and Linux environments. At this time we do not support using Pedestal on a Windows environment.

Some good news: We will still gladly accept pull requests extending our Windows support

The bad news: We will not invest significant amounts of time into diagnosing or correcting Windows issues.

Find out more

Contributing

See CONTRIBUTING.md for details on contributing to Pedestal.

Installing Libraries

To install Pedestal library components in your local Maven repository run lein sub install from a local checkout of this repository.

WARNING: Until 0.3.0 is released, this repository contains code/changes that does not match resources like the docs, tutorial or otherwise.


License

Copyright 2013 Relevance, Inc.

The use and distribution terms for this software are covered by the Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-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.

You must not remove this notice, or any other, from this software.