Skip to content
This repository has been archived by the owner on Sep 28, 2023. It is now read-only.

boiler is an application that helps you to generate a project's boilerplate very easily. You don't need to waste your first hours of development in setting up the project. It gives you the first setup of your project so that you can focus on writing your codes.

License

descholar-ceo/boiler

Repository files navigation

boiler

Maintainability Build Status Coverage Status Join the chat at https://gitter.im/boiler-community/community

boiler is an application that helps you to generate a project's boilerplate very easily. You don't need to waste your first hours of development in setting up the project. It gives you the first setup of your project so that you can focus on writing your codes.

Why do we need boiler?

  • I have noticed that when you start working on a new project, it can take you between 4 - 8 hours setting up the project boilerplate, (project skeleton), depending on the technologies you are going to use. So, that's why I developed this tool that will save you time.

  • Even though some frameworks like Ruby on Rails or Express.js have their commands to initialize a project, but I found them as not complete, because there are some cases where you need to use some more technologies than what you are given by running those commands, so this tool will save you in that case as well. It will do everything for you.

How to use it?

Note: Before using it, please make sure that you read all pre-requisites and your system adhere to them

Pre-requisites

For ruby projects

  • Ruby should be installed already on your computer
  • Bundler
For Ruby on Rails project

To get your project initiated, you should have the following tools already installed on your computer:

  • Ruby (Installed and working well)
  • Ruby on rails (Installed and working well)
  • Yarn
  • Bundler
  • And checkout the database of your choice requirements below 👇 👇 👇
NOTE: DATABASES REQUIREMENTS
  1. MySQL: requires you to have pre-installed libmysqlclient-dev, on your system, if you are not sure run sudo apt-get install libmysqlclient-dev which will install it if you don't have it or update it if the version you have is obsolete

  2. Oracle: requires you to have ruby-oci8 installed, and to install it, requires you to have oracle environment installed properly on your computer

  3. Frontbase: requires you to be a MacOS user

  4. ibm_db: requires you to have db2 server installed on your computer

  5. Sqlserver: requires you to have pre-installed freeTDS on your system, if you are not sure run sudo apt-get install freetds-dev which will install it if you don't have it or update it if the version you have is obsolete

  6. jdbcmysql, jdbcsqlite3, jdbcpostgresql,: are for use with JRuby only

Installation 🔌

  • Click here and download a zip file
  • Extract it wherever you wish
  • Open terminal in the extracted folder, and run ./install.sh
  • Close your current terminal and open another one and run boiler 👉 👉 👉 there you go!

How to get a help? 🙏

Please join our community on Gitter and post any question you have about this project.

Built with

Golang

Languages and systems

  1. The current version v1.0.0 can generate:

    • Basic ruby Projects
    • Ruby on Rails Projects
    • ⚠️ Other languages are coming soon in later versions
  2. The current version v1.0.0 support linux systems (Ubuntu/debian) based OS that use Bash as their command line shell. 👉 We welcome whoever who can add some other system support, your contributions are welcomed!

Contributions

Please follow this contribution guide

About

boiler is an application that helps you to generate a project's boilerplate very easily. You don't need to waste your first hours of development in setting up the project. It gives you the first setup of your project so that you can focus on writing your codes.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published