Skip to content

Latest commit

 

History

History
65 lines (45 loc) · 3.63 KB

README.md

File metadata and controls

65 lines (45 loc) · 3.63 KB

Foodsoft

Build Status Coverage Status Docs Status Code Climate Docker Status Documentation

Web-based software to manage a non-profit food coop (product catalog, ordering, accounting, job scheduling).

A food cooperative is a group of people that buy food from suppliers of their own choosing. A collective do-it-yourself supermarket. Members order their products online and collect them on a specified day. And all put in a bit of work to make that possible. Foodsoft facilitates the process.

If you're a food coop considering to use foodsoft, please have a look at the wiki page for foodcoops. When you'd like to experiment with or develop foodsoft, you can read how to set it up on your own computer.

More information about using this software and contributing can be found on the wiki.

Developing

Get foodsoft running locally, then visit our Developing Guidelines page on the wiki.

Get a foodsoft dev-environment running in the browser with Gitpod

Open in Gitpod

Follow these instructions to complete setup from within the Gitpod workspace.

Deploying

Setup foodsoft to run in production, or join an existing hosting platform.

License

Foodsoft is licensed under the AGPL license (version 3 or later). Practically this means that you are free to use, adapt and redistribute the software, as long as you publish any changes you make to the code.

For private use, there are no restrictions, but if you give others access to Foodsoft (like running it open to the internet), you must also make your changes available under the same license. This can be as easy as forking the project on Github and pushing your changes. You are not required to integrate your changes back into the main Foodsoft version (but if you're up for it that would be very welcome).

To make it a little easier, configuration files are exempt, so you can just install and configure Foodsoft without having to publish your changes. These files are marked as public domain in the file header.

If you have any remaining questions, please open an issue or contact the mailing list.

Please see LICENSE for the full and authoritative text. Some bundled third-party components have other licenses.

Thanks to Icons8 for letting us use their icons.