Lucie - Console Application Framework


Lucie is a terminal application development framework written in Ruby. The aim of the framework is to make the terminal application development faster and easier with providing generators, plugins, components. With specifying a common framework, easier to share workflow management solutions among companies worldwide or creating application that doesn't require graphical user interface.


Lucie based on Model, View, Contoller (MVC) design pattern. Using this principle data can be totally separated from business logic and from its representation. Models represent object that need to be permanent, controllers implement business logic and views help in representing models using templates to generate files or output.

When a Lucie based application is executed, first it dispatches the request and finds the appropriate controller using the first command line attribute. If a second attribute is also defined, it calls the action on the controller with the same name as the attribute, otherwise it calls the index method. Each other attribute is stored in a params instance variable. Mandatory and optional parameters can be defined in controller if some additional information are required by the action.

Controller implements the business logic, using models and templates for data source and representation. Model uses database to store and fetch data.


Lucie provides gem lucie-bin to initialize an application. First you will need to install this on your system.

gem install lucie-bin

You can create a new project with command lucie now.

lucie new my_application

You can try out your new application with running its executable file:

./my_application/bin/my_application --help

Directory structure

/app/controllers Controllers for business logic
/app/modelsModels which store permanent information
/app/templatesTemplate files for file generation
/configConfiguration files
/libLibraries for shared resource
/binExecutable file of the application

The project is under development. More information is coming soon.

Code status

Code Climate

Code Climate

Coverage Status


If you want to join to the project, first drop me a mail to [email protected] about your ideas. After just

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Bitdeli Badge