/react-express-js-upstars

This project is to build a student volunteer content management system using react.js as front-end and express.js as backend for the beneficiary upstars.

Primary LanguageJavaScript

React-Express-upstars

UPStars

This project is to build a student volunteer content management system using react.js as front-end and express.js as backend for the beneficiary UPStars.

Overview

This system is built using express.js as an API provider. The APIs are consumed by react.js to display. The database used is MongoDB.

Documentation

Getting Started

  1. Install Node >= v8.10.x
  2. npm install
  3. Install MongoDB (v3.4 only)

Start running

Type these commands into the shell:

  1. mongod
  2. nodemon server/
  3. npm start

Directory

Directory Uses
/src React.js stuff
/server Express.js stuff
/server/controllers All the application backend logic
/server/models Schemas and database operations
/dump A mongoDB template pre-created for testing purposes

Resources

All API documentation is in the wiki.

Testing

All tests could be ran manually by following the steps in the testing guide

Troubleshoot

bash: nodemon: command not found
Try using:
$ ./node_modules/.bin/nodemon server/
Or use:
$ export PATH=$PATH:`pwd`/node_modules/.bin/
$ nodemon server/
Or finally install nodemon as a global package (which is recommended by nodemon docs):
$ npm i nodemon -g

If you face issues of React Scripts not compiling and gives error on dynamic imports:

> Module parse failed: Unexpected token. You may need an appropriate loader to handle this file type.
Try:
$ npm i --save-dev acorn-dynamic-import@3

Issue of duplicate or conflicting dependencies such as:

> There might be a problem with the project dependency tree. It is likely not a bug in Create React App, but something you need to fix locally.
Try:
Adding SKIP_PREFLIGHT_CHECK=true into .env or .env.development file (of which the .env.development file is committed in the project)

Contributing

This repository is where we do development and there are many ways you can participate in the project, for example:

Licence

Copyright © R3:C0D3 | Ulu Pandan Stars. All rights reserved.

Currently we do not have a plan to assign any open-source licence. However, you are still free to use the code to develop and contribute freely as long as the code is public.