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

https://github.com/omkz/mbangoo

Mbangoo is an open-source e-commerce solution based on Ruby on Rails 7.
https://github.com/omkz/mbangoo

hotwire hotwire-stimulus hotwire-turbo postgresql ruby ruby-on-rails tailwindcss

Last synced: 3 months ago
JSON representation

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

Awesome Lists containing this project

README

          

# Mbango!

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

[View Demo](https://mbangoo-69md.onrender.com/)

![Screenshot](https://raw.githubusercontent.com/omkz/mbangoo/master/public/screenshot.png)
## Tech Stack

- Ruby 3.2.x
- Ruby on Rails 7.x
- PostgreSQL 12.x
- Tailwind CSS v3.X
- Hotwire
- Stripe
- Gem:
- [devise](https://github.com/plataformatec/devise) | Authentication
- [pg](https://github.com/ged/ruby-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](https://rbenv.org) is recommended.
* [**RubyGems**](http://rubygems.org/)
* **Bundler**: `gem install bundler`
* [**Git**](http://help.github.com/git-installation-redirect)
* **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:

```bash
git clone git://github.com/omkz/mbangoo.git
cd mbangoo
```

2. Install the required gems by running the following command in the project root directory:

```bash
bundle install
```

3. Setup the database:

```bash
bundle exec rails db:setup
```

4. Start the development server:

```bash
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](LICENSE) for details.