Jasmeet1709 / guess-quote

This application is a collaborative project made by the Google Udacity Mobile Web Specialist Scholars.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

GUESS THE QUOTE

It is a fun quiz game which is a progressive web app(PWA). Built during Collaborative Projects in Google Udacity Mobile Web Specialist Scholarship.This project is built to dive further deep into PWA and learn about caching music and animations using service worker.

Table Of Contents

  1. Features Wishlist
  2. Design Specs
  3. Requirements for Development
  4. Setup for Development
  5. Technology Stack
  6. Contributing Guidelines

Features Wishlist

  • Login/SignUp
  • A complete PWA for both web and mobile users
  • GUI Animations(Using Greensock)
  • TextToSpeech while reading the quote
  • Share your score on Social Media (like Facebook for now)

Design Specs

Requirements for Development

  • Node — Preferred 8.11.1 LTS
  • npm — Preferred 5.8.0
  • Git

Setup for Development

Refer this link for setup illustration with examples and images

  • Fork the repository by clicking on the fork button on the top of the page. This will create a copy of this repository in your account.
  • Click on clone or download and copy the url from your forked repo
  • Open a terminal(CLI) and run the following commands:
   git clone https://github.com/<your-github-username>/guess-quote.git
   cd guess-quote
   npm run setup
   cp env.example .env
   npm start
[OPTIONAL] Setup Upstreams

Note: An upstream repository is the original UdacityMobileWebScholarship repository.

Once you have forked as directed in the previous section, you would not be following changes made here, in the original repository.

What you can do is:

  • cd to the directory of the forked repo you cloned above.
  • Run a command to add upstreams
 git remote add upstream https://github.com/UdacityMobileWebScholarship/guess-quote.git

 git fetch upstream
 git checkout -b upstream/master
 git pull upstream master

To return to your branch on your fork

  • Run
git checkout master

Next steps

You are all good to start contributing. You might however want to make sure you periodically update the origin/master branch which is from your fork, with the content from upstream/master which is this repository's dev branch.

Why? Because, Just before you submit Pull requests, or before you even change a feature, you Need to ensure you have all the latest changes from upstream.

This is a healthy habit to inculcate, and would ease out headaches later.

Also, Before you do the above , and begin coding something new, or modifying existing stuff, make sure you have merged.

the simplest is a fast forward merge

git merge upstream/master But merges are complicated. Please do read official documentation on merge. Understand how they work. And then proceed to a PR.

Discussion

Technology Stack

Contributing Guidelines

Contributions are always welcome. We are using Git Branching Model for production and development purposes.You can read more about it hear A successful Git branching model.Basically what this means is

  • develop : This branch reflects a state with the latest delivered DEVELOPMENT changes for the next release
  • master : This branch reflects the PRODUCTION READY STATE

For more details regarding contributing refer CONTRIBUTING.md

License

MIT License

About

This application is a collaborative project made by the Google Udacity Mobile Web Specialist Scholars.

License:MIT License


Languages

Language:JavaScript 82.0%Language:CSS 9.8%Language:HTML 8.2%