You just found the Drop App (first version of Boxwise - an web-app, which makes it easy for organisations to source, store and distribute donated goods to people in need in a fair and dignified way.
We developed it for Drop In The Ocean - a Norwegian NGO who is working in three refugee camps throughout Greece. Our second user is Intervolve who is using Drop App in the Koutsochero camp in Larissa, Greece.
You will not find a lot of documentation. Installing, running and customizing it will be pretty much straight forward for a developer with knowledge of PHP and Mysql.
We consider Drop App our MVP or proof of concept. Based on our experience, we want to start the development of our next version - a web-app where any NGO only need to register and which is running on a single central server. Hopefully, we will also solve the issue of offline usage.
To support the development of the new version we started a crowdfunding campaign!
Write or call Hans (hans@boxwise.co & +4917652181647) if you want to be part of our next step.
To service the current version which is still running in three refugee camps throughout Greece. This repository makes it easy for us to work together with a bigger team even if we're not all on the same location.
-
You first need to install 'compose' (we suggest making it available globally)
curl -s https://getcomposer.org/installer | php` mv composer.phar /usr/local/bin/composer` -
You can install the required dependencies then using
composer install -
To configure the app, copy
/config.php.defaultand remove the.defaultin the filename. The default configuration does not need to change if you are using Docker (see below). -
To run the application, we assume you have Docker installed. You can then run:
docker-compose up -
To initialize the database for the first time, you should run:
vendor/bin/phinx migrate -e development vendor/bin/phinx seed:run -e developmentThe first command creates the schema, the second command seeds the database with some dummy data
Once the docker containers are running the app is accessible at http://localhost:8100/
After this you should be able to login to the app using email address: some.admin@boxwise.co with password: admin
If you want to connect to the MySQL server from your host machine, you can do this using
docker exec -it dropapp_mysql_db_1 mysql -uroot -p
If you want to reset it, you should stop docker, delete the files in /.docker/data/mysql and call docker-compose up again.
We're using (Phinx)[https://phinx.org/] and (phinx-migrations-generator)[https://github.com/odan/phinx-migrations-generator] to manage database migrations. Running
vendor/bin/phinx-migrations generate
Will generate a new migration based on the diff of /db/migrations/schema.php.
You gotta be awesome and kind
Right now best talk to Hans!
See the LICENSE file for license rights and limitations (MIT).