Welcome to Foodexplorer v1.7!
This tool is a playful interface to find out about random foods, collected in your very own forgotten cabinets. Future iterations aim to add features such as custom products, custom cabinets, product lookup, meal logging, and macronutrient ratio calculations for the user.
The quickest way to get started is to open it on Repl.it! Because repl.it uses a modified fork which may be several commits behind
master it is considered a beta implementation. Repl.it-specific modifications include: using
bundler/inline to route gem dependencies, a different
gemfile.lock, as well as a
.replit file to specify what happens when you hit the
Eventually, foodexplorer will be a fully-fledged Ruby gem. At the moment, installation of the project can be performed locally with the following steps:
- Navigate to the repo on GitHub at https://github.com/twwright/foodexplorer
- Click the green Clone or Download button and copy the remote URL
git clonethen paste the copied URL into your terminal
- Change directory using
cd foodexplorerin the terminal to open the Foodexplorer directory
- Install dependencies with
To run Foodexplorer from your command line, just enter
cd bin && ruby start into your shell!
From there, you can explore the kitchen of your dreams, full of a random assortment of your (possibly) favorite food items! Complete with photos, macronutrient information, and a helpful follow-up link to learn more.
After checking out the repo, run
bin/setup to install dependencies. You can also run
bin/console for an interactive prompt that will allow you to experiment.
Bug reports and pull requests are welcome on GitHub at https://github.com/twwright/foodexplorer. Check out the Issues section for ways you could contribute to new features! This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
The project is available as open source under the terms of the MIT License.
Code of Conduct
Everyone interacting in the Foodexplorer codebase, issue trackers, and chat is expected to follow the code of conduct.