An open API service indexing awesome lists of open source software.

https://github.com/ubclaunchpad/microvan

Online auctions for a trucking company in the Philippines
https://github.com/ubclaunchpad/microvan

aws django javascript python react

Last synced: about 1 year ago
JSON representation

Online auctions for a trucking company in the Philippines

Awesome Lists containing this project

README

          

# Microvan Inc.





Logo

Microvan Inc.

Table of Contents




  1. About The Project



  2. Getting Started


  3. Deployment

  4. Contributing

## About The Project

Microvan Inc. focuses on the importation, trade and sale of second-hand construction and industrial machinery, trucks and vehicles in the Philippines. Previously, Microvan Inc. would do in-person auctions every two months. However, due to the pandemic, many of their competitors have shifted to online auctions and Microvan Inc. needs a new auction site to ensure they aren't left behind.

### Built With

* React, Javascript - Frontend
* Django, Python - Backend
* PostgreSQL - Database
* AWS - Hosting

## Getting Started

To get a local copy up and running follow these simple steps.

### Prerequisites

* [NodeJS/npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
* [Python/pip](https://packaging.python.org/en/latest/tutorials/installing-packages/)
* [pipenv](https://pipenv.pypa.io/en/latest/installation/)

### Installation
#### Django Backend

1. `cd` into backend folder
2. Make a copy of sample.env, rename it to .env, and fill out the environment variables.
3. run `pipenv install` to install dependencies
4. run `pipenv shell` to enter virtual environment
5. run `pipenv run start`
6. Backend will be running on `localhost:8000`

#### React Frontend

1. `cd` into frontend folder
2. run `npm install` to install dependencies
3. Make a copy of sample.env, rename it to .env, and fill out the environment variables.
4. run `npm start`
5. Frontend will be running on `localhost:3000`

## Deployment

TODO

## Contributing

Contributions are what make the community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.

1. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
2. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
3. Push to the Branch (`git push origin feature/AmazingFeature`)
4. Open a Pull Request