Barhive is an open source project that implements a simple to use distributed point-of-sales (POS) system. This system is fit to be used by small hospitality industry businesses who wan't to adopt a modern sales process without investing in a physical POS system. Barhive is designed to run on any smartphone, table, or laptop.
The aim of the project is to enable business owners all over the world to digitize their bussiness without the upfront investment.
Barhive is an Open Source Project built in Larvel. So the requirements are the following
It is also necessary to have MySql data base
The application is installed like any other Laravel application. It requires composer and npm to be installed.
# Clone the git repository
git clone https://github.com/bobluppes/barhive.git
cd ./barhive
# Install dependencies
composer install
composer update
npm install
# Build sources
npm run dev
Next, the environment variables need to be set. An example configuration can be found in barhive/.env.example
, you can simply copy this file to barhive/.env
and edit the variables accordingly. The most important settings are the database settings:
DB_DATABASE=[your_database_name]
DB_USERNAME=[database_username]
DB_PASSWORD=[database_password]
As a last step, artisan is used to get the application up and running.
# Set the application key
php artisan key:generate
# Migrate tables and seed
php artisan migrate
php artisan db:seed
# Serve the application on 127.0.0.1:8000
php artisan serve
For any support with Barhive, you can open an issue on the issue tracker or reach out to me on my github email!
- Receipt system
- Payment gateway
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Preferably, pull requests are related to features in the roadmap above or issues in the issue tracker. If a feature on the roadmap has a project board associated, it is added behind the feature in parentheses. See these pages for more information about the planned feature.
Please make sure to update tests as appropriate.