Git Product home page Git Product logo

guess-quote's Introduction

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

guess-quote's People

Contributors

ayushdev avatar twishasaraiya avatar varundevpro avatar suhasbansude avatar skarthikeyan96 avatar anantoghosh avatar aromar avatar ashwani99 avatar deveshjadon98 avatar sounak07 avatar skyshader avatar ishank-s avatar optimistanoop avatar naveens239 avatar gpalsingh avatar danivijay avatar anurag-majumdar avatar jatin11gidwani avatar manajitpal avatar retrocausal avatar drenther avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.