8000 GitHub - forkful/forkful: Cook. Modify. Repeat.
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

forkful/forkful

Repository files navigation

Forkful

Version control for recipes.

Build Status

Forkful Brand

Forkful lets chefs track previous iterations of recipes by allowing them view a recipe's version history. By "forking" an existing recipe, chefs can copy and edit the list of ingredients and steps. If a recipe is missing, they can create their own and allow others to modify it. Forkful is a great way for chefs to collaborate on and improve a recipe.

See the app live at forkful.io and get started!

Table of Contents

  1. Overview
  1. Requirements
  2. Development
  1. Production
  1. Team
  2. Contributing
  3. Attribution

Overview

Usage

Technologies

This app is written completely in ECMAScript 2015 (ES6).

  • Client: React, Redux, React Router, SCSS
  • Server: Node, Express
  • Database: PostgreSQL
  • Testing: Mocha, Chai, Karma, Enzyme
  • Build: webpack
  • Deployment: TravisCI, Heroku

Architecture

Architecture Diagram

Schema Design

Requirements

  • Node 5.8.0
  • PostgreSQL 9.5.1

Development

Keys

You'll need API keys for Google Plus and Filestack. Create files in server/keys/ called googleAuth.js and filePicker.js following the format of the example files.

Forkful uses session-based authentication, so you'll need to set cookie and session secrets in server/keys/expressSecrets.js. An example is provided for you.

Installing Dependencies

From within the root directory:

npm install -g webpack nodemon
npm install

Running Locally

Make sure you have PostgreSQL running and that the database has been initialized. Set up your database by running the following inside your root directory:

npm run db-setup

Then, run the development server with:

npm run dev-start

Navigate to localhost:8080 in your browser.

Testing

To run all tests:

npm test

To run only the client-side tests:

npm run test:client

To run only the server-side tests:

npm run test:server

Roadmap

What are we working on now? View the project roadmap here.

Production

Running in Production

Make sure you have PostgreSQL running and that the database has been initialized. If the database has not been initialized, run:

npm run db-setup

Then, from within the root directory:

npm install
npm start

The app will run on the port defined in process.env.PORT or default to port 8080.

Team

Contributing

We'd love for others to contribute and make Forkful better! Please refer to CONTRIBUTING.md for contribution guidelines.

Attribution

The amazing icons in this application were from The Noun Project. We used icons from these designers:

And of course, we couldn't have built this app without the wonderful recipes from Yummly and their awesome API.

About

Cook. Modify. Repeat.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  
0