Desant /dɛsɑːnt/ is a Polish word for military landing operations aimed at a bringing the landing force usually via landing craft to a shore or to land with the purpose of power projection ashore by forces coming usually from ships and also aircraft and able to fight.
Desant is an open source, neat landing page application. It's simple to use, customize and extend to your needs. There's an awesome admin area too - it will give you all the information and statistics you need.
You can check online demo of the admin on here.
admin with password
There's a public Vagrant box configured to run with Desant. You can hop into the project qucikly by running:
$ gem install vagrant # if not installed yet $ vagrant up $ vagrant ssh vagrant@vagrant:~$ cd desantapp
Now just go and perform installation and setup steps described below.
First of all, install all the dependencies using Bundler:
Desant uses MySQL as backend, so you should have this database installed
and running. If you have it then copy
.env - this file contains i.a.
database configuration and admin setup:
$ cp .env.sample .env
Admin area uses very simple, single user authentication. Now generate password hash for your password:
$ rake password_hash PASS=yoursecretpass Your password hash: $2a$10$9r64bxHKi3wxFwKDbjZYWOj4M26xp0RM0maoGeRo0JPy6Cg5OrzBC
Copy generated hash and assign it to
edit database configuration and other settings.
Last thing to do is to run create databases and run migrations:
$ foreman run rake db:create $ foreman run rake db:migrate
As you can se, we must use
foreman run command from now on - it's because
all the stuff which is affected by the database requires its configuration
to be loaded. Foreman automatically loads configuration from the
Now you should be able to start the application, we must use Foreman here as well.
$ foreman start
If everything went fine, you should go to
http://localhost:5000/ and see
a demo landing page! Use
http://localhost:5000/admin/ to access admin
To run RSpec unit tests use the following rake task:
$ foreman run rake spec
$ foreman run rake spec:jasmine
You can also run all the specs together:
$ foreman run rake spec:all
For development purposes you can populate dummy data using following rake task:
$ foreman run rake db:populate
Desant is not a Rails app, it's an experiment with full stack, single page application in Backbone.js managed by Sinatra backend. Here's the directory structure explained:
Project is booted with
boot.rb configuration file. All the apps (components)
are routed in config.ru, with standard Rack::Router.
The main goal of the experiment was to provide system for easy and robust work on Backbone.js application and reusable backend elements. It's also aims to get rid of stupid Rails' assumptions that action = page, and models are used both in forms and presentations. In Desant, models are separated from forms and presenters. Model takes care about business logic, when forms handle input and presenters output. More sophisticated operations are handled with services. This design makes the stuff easy to test and reuse across the projects.
Copyright (C) 2012 by Chris Kowalik a.k.a nu7hatch email@example.com
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.