Skip to content

A modern, fully-featured, and highly portable eCommerce site built with the MERN stack.

License

Notifications You must be signed in to change notification settings

connoro7/exportdefault.shop

Repository files navigation

exportdefault.shop

A modern, fully-featured eCommerce platform built with MERN.

Getting Started

This project brings together everything you need for a fully-featured, fully custom, eCommerce site: product exploration and searching, product pages, carousels, and pagination, as well as authenticated sign-on and user accounts stored in a managed database, an admin dashboards to manage users/customers, products, and order details. The exportdefault.shop platform also has a product rating and review system, shopping carts, an integrated ordering system that handles marking orders as shipped/delivered, as well as the entire checkout process including shipping selection, payment options (credit/debit card processing, and Paypal integration).

The technologies included in this project include (but not limited to):

  • React (with functional components and hooks)
  • React router
  • React-Bootstrap
  • State management via Redux (actions, reducers)
  • Redux-mananaged componenents (useDispatch, useSelector)
  • Express back-end server
    • Express Async Handler
  • Live MongoDB integration, and Mongoose ODM
  • JWT authentication
  • Fully custom authentication middleware
  • Fully custom error handlers
  • Paypal API integration
  • Project deployment pipeline, via Heroku

Prerequisites & Installation

  1. Clone repo to project directory
  2. Navigate to ./frontend and install packages via $ npm i
  3. Navigate to base project directory and install packages via $ npm i
  4. Create your development .env file, containing:
  • PORT for desired port to host development server
  • NODE_ENV set to DEVELOPMENT (or PRODUCTION)
  • MONGO_URI or equivalent NoSQL database URI
  • JWT_SECRET for handling authentication tokens
  • PAYPAL_SANDBOX_XXX accounts, for testing Paypal integration
  1. Start the server in development mode by running npm run dev in the base project directory.
  2. Wait for React to open the application or naviagate to localhost:3000

In development mode, this application requires concurrently and nodemon for development npm scripts.

API

exportdefault.shop has a RESTful API architecture. The frontend and backend communicate via HTTP methods and JSON data, while the backend communicates with the MongoDB database via Mongoose.

Complete API descriptions, tests, and documentation can be found in exportdefault.paw

/api
├── orders
│   ├── _id        //Perform actions on a single order, by ID
│   └── myorders   //Perform actions on a single user's orders
├── products
│   └── _id        //Perform actions on a single product, by ID
└── users
    ├── _id        //Perform actions on a single user, by ID
    ├── login      //Login routes
    └── profile    //User actions
//Please see exportdefault.paw for complete API documentation and API testing

Testing

  • Please see the API documentation for tests. Currently, API tests are integrated into the documentation.

Deployment

  • This application is deployed via Heroku.

Built With

Contributing

Versioning

  • This project uses semantic versioning. Please see SemVer for more information on the SemVer spec.

Authors

  • Connor Dillon - Developer - connoro7
  • See also the list of contributors who participated in this project.

License

  • This project is licensed under the MIT License.

Acknowledgments