Giter VIP home page Giter VIP logo

breads-client's Introduction

Keep track of what you read online, and see what your friends are reading. See breads-server for back end code.

Breads User Profile

Features

  • Save articles you've read online
  • See a summary and simple stats of your reading activity
  • Tag and favorite articles
  • Follow friends to see what they've read, favorited, and tagged
  • Global feed to see what is being read by everyone on Breads
  • Search for articles and users

Near Future

  • Save other media content like videos, PDFs, and podcasts
  • Browser extension
  • RSS Feed
  • Pocket-like read later feature
  • Newsletter that summarizes trends, your friend's readings, etc.

Table of Contents

Installing

After you have forked the project and downloaded the code, install the necessary dependencies using npm or yarn.

To install the packages through npm, run the command npm install

To install the packages through yarn, run the command yarn add

NOTE: In the rest of the documentation, you will come across npm being used for running commands. To use yarn in place of npm for the commands, simply substitute npm for yarn. Example, npm start as yarn start. For more help, checkout migrating from npm.

Running

NOTE: The backend code should be running in order for the front end to behave correctly. See Breads API.

Make sure the necessary dependencies are installed, add environment variables, and type the command npm start

Environment Variables

Axios
REACT_APP_AXIOS_URL - backend url (i.e. - 'http://localhost:8080/api')

Testing

Before committing your changes, run the command npm test

Tests are not up to date. (This would be a great way to contribute!)

Deploying

After confirming the tests have passed - see above

  1. Keep your fork in sync with this repository (how to merge conflicts):
# Add a new remote upstream repository
git remote add upstream https://github.com/zero-to-mastery/breads-client.git

# Sync your fork
git fetch upstream
git checkout master
git merge upstream/master
  1. Push changes to your repo:

git push origin master

  1. In your repo GitHub page, create a pull request to the development branch. This will allow us to see changes in a staging environment before merging to master.

  2. If everything runs correctly, your pull request will be merged into master.

Technologies

Near Future

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.