Skip to content

A grocery shopping full stack application built with React and Express

License

Notifications You must be signed in to change notification settings

Rancidcake/grocerrific

 
 

Repository files navigation


Grocerrific

What is Grocerrific?

Grocerrific is a grocery shopping full stack application.

Codebase

This project is built using ReactJs library to build the user interface, apllication state management with Redux as the predictable state container, MongoDB is our database of choice powered by Express for both data persistence and serving static content.

Technologies

  • ReactJS: React is a declarative, efficient, and flexible JavaScript library for building user interfaces. It lets you compose complex UIs from small and isolated pieces of code called “components”.
  • Redux: Redux is a predictable state container for JavaScript apps.
  • Webpack: Webpack is a static module bundler for modern JavaScript applications.
  • Express: Express is a minimal and flexible Node.js web application framework that provides a robust set of features for web and mobile applications.
  • MongooseJS: Mongoose provides a straight-forward, schema-based solution to model your application data. It includes built-in type casting, validation, query building, business logic hooks and more, out of the box.
  • Axios: Promise based HTTP client for the browser and node.js
  • Nodemon: Nodemon is a utility that will monitor for any changes in your source and automatically restart your server.
  • React-Toastify: A Javascript library for non-blocking notifications.
  • Jest: Jest is a complete and ready to set-up JavaScript testing solution.
  • Babel: Babel is a toolchain that is mainly used to convert ECMAScript 2015+ code into a backwards compatible version of JavaScript in current and older browsers or environments.
  • React-Router-Dom: DOM bindings for React Router: a collection of navigational components that compose declaratively with your application.

Getting Started

This section provides a quick start guide.

Prerequisites

  • NodeJs: NodeJs is a JavaScript run-time environment that uses an event-driven, non-blocking I/O model that makes it lightweight and efficient.
  • Yarn: Yarn is a package manager for your code. It allows you to use and share code with other developers from around the world. Yarn does this quickly, securely, and reliably so you don’t ever have to worry.
  • MongoDB: MongoDB is a document database with the scalability and flexibility that you want with the querying and indexing that you need. MongoDB stores data in flexible, JSON-like documents, meaning fields can vary from document to document and data structure can be changed over time

Installation

  1. Make sure all prerequisites are installed
  2. Ensure that the MongoDB service is running on your machine
  3. Clone the repository, i.e git clone https://github.com/monsieurkayode/grocerrific.git
  4. Cd into the project directory using cd grocerrific/
  5. Reference the env.sample file to create a .env file to setup environment variables
  6. yarn

Build

To build and run the application

  yarn build:dev
  yarn start:dev
  Open http://localhost:5000 in your browser

Starting the application

  yarn dev
  Open http://localhost:8080 in your browser

License

MIT

About

A grocery shopping full stack application built with React and Express

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 84.2%
  • SCSS 15.2%
  • HTML 0.6%