Giter VIP home page Giter VIP logo

post-it's Introduction

Maintainability Build Status Coverage Status

PostIt App

Introduction

PostIt is a simple application that allows friends and colleagues create groups for notifications. This way one person can post notifications to everyone by sending a message once. The application allows people create accounts, create groups and add registered users to the groups, and then send messages out to these groups whenever they want.

API Documentation

The documentation for the Postit API can be found here PostIt API Docs

Features

Based on project requirement, the features covered for the endpoints are:

  • Create accounts
  • Create groups and add users to groups
  • Post messages to created groups
  • Email notifications for urgent and critical messages.

Dependencies

To install Postit, you will need the following:

  • Node
  • PostgreSQL
  • Other dependencies required are listed in the package.json file. Use npm install on the command line
  • Environment variables are defined in a .env file. You can find a .sample.env file in the repository root to guide you on setting up your .env file.

Installation

The steps outline will provide a walkthrough on how to install the app on your local machine

  • Clone this repository
  • From the terminal, change directory to postit app folder
  • Ensure that you are on the develop branch. If on any other branch, run git checkout develop on the terminal.
  • Run npm install from your terminal in your project directory to install all dependencies
  • Then run the app with the command npm start

Usage

To test out the endpoints, follow the following steps

Limitations

  • Currently, authenticated users can only create a group but cannot delete a group created.
  • Users added to a group cannot be removed.
  • Read messages by users are not being archived.
  • Real-time in-app notification for message posted to a group was not handled.

Frequently Asked Questions

  • What is postIt app all about? postIt app is a simple application that allows friends and colleagues create groups for notifications purpose. With this app, members in a group can interact with each other by posting their messages in the group.
  • What are the steps on how to use the app? First, Sign up by creating a new account Once account is created, proceed to create a group and add your prefered users to the group you created Then you can post message to the group you created for all members of the group.

How to contribute

Contributions are welcome and appreciated

  • Fork this repository
  • Open a terminal and execute the following command to make a local copy $ git clone [email protected]:your-username/Postit-Raphael-Etim
  • Run cd Postit-Raphael-Etim to navigate into the folder
  • Make your contributions to your local repo
  • Add a connection to the original repo using $ git remote add repo_nickname git://github.com/ludralph/Postit-Raphael-Etim.git. Note: repo_nickname is a nickname you choose
  • Run git $ remote -v to verify that the connection is established
  • Make your contributions to your local copy of the project
  • Run $ git add filename, git commit -m "commit message" to add and commit your contributions
  • Run $ git push origin proposed-feature-name to push your changes to your copy of the repository
  • If you feel you've made a contribution that will improve the project, raise a Pull Request against develop branch.
  • Be descriptive enough about your contributions so other contributors will understand what you've done

Pull Requests should:

  • Contain code written in ES6 for Javascript files.
  • Lint and adhere to the Airbnb javascript style guide.
  • Ensure test cases are written for the feature being developed

License

This project is available for use and modification under the ISC License. See the LICENSE file for more details.

The DEV Team

  • Raphael Etim

post-it's People

Contributors

ludralph avatar snyk-bot avatar

Watchers

James Cloos avatar  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.