/mbangoo

Mbangoo is an open-source e-commerce solution based on Ruby on Rails 7.

Primary LanguageRubyOtherNOASSERTION

Mbango!

Mbango is an open-source e-commerce solution based on Ruby on Rails 7.

Screenshot

Tech Stack

  • Ruby 3.2.x
  • Ruby on Rails 7.x
  • PostgreSQL 12.x
  • Tailwind CSS v3.X
  • Hotwire
  • Stripe
  • Gem:
    • devise | Authentication
    • pg | PostgreSQL library for Ruby

Installation

Requirements

Before you get started, the following needs to be installed:

  • Ruby. Version 3.2.0 is currently used and I don't guarantee everything works with other versions. If you need multiple versions of Ruby, rbenv is recommended.
  • RubyGems
  • Bundler: gem install bundler
  • Git
  • A database. Only PostgreSQL 12.15 has been tested, so we give no guarantees that other databases (e.g. MySQL) work. If you're using OS X and have Homebrew installed, install it with brew install postgresql

Setting up the development environment

  1. Get the code. Clone this git repository:
git clone git://github.com/omkz/mbangoo.git
cd mbangoo
  1. Install the required gems by running the following command in the project root directory:
bundle install
  1. Setup the database:
bundle exec rails db:setup
  1. Start the development server:
bin/dev

If you want to contribute

The best way to contribute is to do one of the following :

  • Creating tests
  • Refactoring
  • Coding features
  • Correcting logged issues
  • Correcting my English! (I'm an Indonesian, so don't hesitate to fix my sentences or whole paragraphs.)

License

Mbangoo is open source under the MIT license. See LICENSE for details.