Gruhb

ci-badge

Table of contents

Overview

Gruhb is a web application that provides available food vendors and menu items for UH Manoa.

Visit our GitHub Organization here.

The goals of the project are:

As stated as the first goal of the project, the system will provide an easy-to-use tool for anyone who finds themselves on the UH Manoa campus and need to find a place to eat.

Deployed Website

Visit our deployed website here!

Build Process

Milestone 1 (DONE):

Visit the Milestone 1 project board here.

Milestone 2 (DONE):

Visit the Milestone 2 project board here.

Milestone 3 (DONE):

Visit the Milestone 3 project board here.

User Guide

This section provides a walkthrough of the user interface for Gruhb.

Landing Page

The landing page is presented to users when they visit the top-level URL to the site. We based our design and layout on Yelp’s home page.

Log In, Sign Up, and Sign Out Page

The user will be able to “Login”, “Sign Up”, or “Sign Out” on the top right corner of the page. All three pages generally follow the same design.

Log In

Sign Up

Sign Out

Home Page (Vendors, Profile, Favorites)

The user home page of Gruhb will allow the user to access the vendors feed (seen right when the user logs in), profile page, and favorites page. Due to personal time contraints, this page is not yet finalized. In the final version, we will have a feed of vendor cards that users can click on to view more details.

Vendor

After a user clicks on a vendor card from the user’s home page feed, the Vendor page will be displayed and the details of the vendors like the hours, menu, cuisine etc. will be shown to the user.

Part 1

Part 2

Part 3

Add Vendor

The Add Vendor page allows the user to add a new vendor to the website if there is a newly open vendor on campus.

Part 1

Part 2

Edit Vendor

The Edit Vendor page allows the user to edit an exisiting vendor’s information.

Part 1

Part 2

About Us

The About Us page provides a brief biography for each team member.

As part of Milestone 3, we made styling changes to the footer and made it match to the styling of the Nav Bar.

Nav Bar :

Footer :

Developer Guide

First, install Meteor.

Second, go to https://github.com/ics-software-engineering/meteor-application-template-react, and click the “Use this template” button. Complete the dialog box to create a new repository that you own that is initialized with this template’s files.

Third, go to your newly created repository, and click the “Clone or download” button to download your new GitHub repo to your local file system. Using GitHub Desktop is a great choice if you use MacOS or Windows.

Fourth, cd into the app/ directory of your local copy of the repo, and install third party libraries with:

$ meteor npm install

Running the system

Once the libraries are installed, you can run the application by invoking the “start” script in the package.json file:

$ meteor npm run start

The first time you run the app, it will create some default users and data. Here is the output:

meteor npm run start

> meteor-application-template-react@ start /Users/philipjohnson/github/ics-software-engineering/meteor-application-template-react/app
> meteor --no-release-check --settings ../config/settings.development.json

[[[[[ ~/github/ics-software-engineering/meteor-application-template-react/app ]]]]]

=> Started proxy.
=> Started MongoDB.
I20180227-13:33:02.716(-10)? Creating the default user(s)
I20180227-13:33:02.742(-10)?   Creating user admin@foo.com.
I20180227-13:33:02.743(-10)?   Creating user john@foo.com.
I20180227-13:33:02.743(-10)? Creating default data.
I20180227-13:33:02.743(-10)?   Adding: Basket (john@foo.com)
I20180227-13:33:02.743(-10)?   Adding: Bicycle (john@foo.com)
I20180227-13:33:02.743(-10)?   Adding: Banana (admin@foo.com)
I20180227-13:33:02.744(-10)?   Adding: Boogie Board (admin@foo.com)
=> Started your app.

=> App running at: http://localhost:3000/

Note regarding “bcrypt warning”:

You will also get the following message when you run this application:

Note: you are using a pure-JavaScript implementation of bcrypt.
While this implementation will work correctly, it is known to be
approximately three times slower than the native implementation.
In order to use the native implementation instead, run

  meteor npm install --save bcrypt

in the root directory of your application.

On some operating systems (particularly Windows), installing bcrypt is much more difficult than implied by the above message. Bcrypt is only used in Meteor for password checking, so the performance implications are negligible until your site has very high traffic. You can safely ignore this warning without any problems during initial stages of development.

Note regarding “MongoError: not master and slaveOk=false”:

Intermittently, you may see the following error message in the console when the system starts up:

MongoError: not master and slaveOk=false
     at queryCallback (/Users/philipjohnson/.meteor/packages/npm-mongo/.3.1.1.1mmptof.qcqo++os+web.browser+web.browser.legacy+web.cordova/npm/node_modules/mongodb-core/lib/cursor.js:248:25)
     at /Users/philipjohnson/.meteor/packages/npm-mongo/.3.1.1.1mmptof.qcqo++os+web.browser+web.browser.legacy+web.cordova/npm/node_modules/mongodb-core/lib/connection/pool.js:532:18
     at _combinedTickCallback (internal/process/next_tick.js:131:7)
     at process._tickDomainCallback (internal/process/next_tick.js:218:9)

This message will not cause any problems for you and it is possibly related to a race condition between the development instance of Mongo and Meteor. The console will still display App running at: http://localhost:3000/ and no problems occur during run time.

Viewing the running app

If no errors appear when attempting to run the app, the template application will appear at http://localhost:3000. You can login using the credentials in settings.development.json, or you can register a new account.

ESLint

You can verify that the code obeys our coding standards by running ESLint over the code in the imports/ directory with:

meteor npm run lint

Community Feedback

  1. Have a map.
  2. Have a feature that tells you which vendors are closest to you.
  3. More features.
  4. Implement money usage.
  5. User reviews i.e. “Food Item: Food Item Review”.
  6. Front page needs more functionality.
  7. Whole application is bare.

The Team

Jackie Wong

I am currently enrolled in his third year at the University of Hawaii at Manoa and pursuing a Bachelor of Science in Computer Science. I plan to get into software development or engineering, and full-stack web development. You can learn more about me here!

Samuel Han

I am currently in my senior year at the University of Hawaii at Manoa and am double majoring in Biology and Computer Science. I am planning on getting into mobile development. You can learn more about me here!

Adrian Tam

I am currently enrolled at the University of Hawaii at Manoa and am majoring in Computer Science. You can learn more about me here!