Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mauricioszabo/castra-users-example


https://github.com/mauricioszabo/castra-users-example

Last synced: about 4 hours ago
JSON representation

Awesome Lists containing this project

README

        

# Hoplon Example

A [Hoplon][4] project with [Castra][2] designed to test capabilities of Castra,
Javelin, and Hoplon.

## Dependencies

- java 1.7+
- [boot][1]

## Usage
### Development
1. Install boot. This is as simple as following instructions on
boot page (https://github.com/boot-clj/boot). You **do not need** clojure, nor any
other dependency - only Java 1.7 and boot.
1. Create database with `boot createdb`. It'll download all dependencies, clojure and
clojurescript, then it will create a database with some seeds for you.
1. Start the `dev` task. In a terminal run:
```bash
$ boot dev
```
This will give you a Hoplon development setup with:
- auto compilation on file changes
- audible warning for compilation success or failures
- auto reload the html page on changes
- Clojurescript REPL

1. Go to [http://localhost:8000][3] in your browser. You should see "Hello,
Hoplon and Castra!" with random numbers that are generated on the server and
transmited to the client. But you should change that to what you want.

1. If you edit and save a file, the task will recompile the code and reload the
browser to show the updated version.

### Production
1. Run the `prod` task. In a terminal run:
```bash
$ boot prod
```
2. The compiled files will be on the `target/` directory. This will use
advanced compilation and prerender the html.

### Deployment

You can easily deploy this application for free to [Heroku][5].

1. Get a Heroku account and install the [Heroku toolbelt][6]
1. Create an application in the Heroku dashboard
1. Build a WAR file with `boot make-war`
1. Follow [these instructions][7] to deploy the WAR to Heroku using the `heroku` tool.

## License

Creative Commons 4.0 SA 2015, Maurício Eduardo Chicupo Szabo.

[1]: http://boot-clj.com
[2]: https://github.com/hoplon/castra
[3]: http://localhost:8000
[4]: https://hoplon.io
[5]: https://www.heroku.com/
[6]: https://toolbelt.heroku.com/
[7]: https://devcenter.heroku.com/articles/war-deployment#deployment-with-the-heroku-toolbelt