Skip to content

PlanMyMods/web-frontend

Repository files navigation

Contributors Forks Stargazers Issues


Logo

BeforeClass

In this project, we aim to build a web-based application for SMU students to be able to plan their school modules and have a clear visual to their planned timetable and graduation journey. An all-in-one university focused web-based application for students, by students.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

Product Screen Shot


Product Screenshot

(back to top)

Built With

(back to top)

Getting Started

Run the following command to setup and run a local copy of the project.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

  • npm
    npm install npm@latest -g

Installation

  1. Clone the project
git clone https://github.com/SMU-IS216G6T10/smumods-frontend.git
  1. Create a .env file from the sample

    !! Remember to update the values in the env file with the right values!

cp ./.env.sample ./.env
  1. Install dependencies
npm ci
# launch development environment
npm run dev

(back to top)

Deployment

This project is deployed automatically via Netlify with hooks listening on push to the main branch and every pull request.

To mimic a production deployment, run:

Prerequisite

  1. install serve, a static site, single page application server
npm install -g serve

Mimicking production on local

  1. Build the app
npm run build
  1. Serve the app on a mimicked production environment

    -s flag means to serve it in Single-Page Application mode which deals with the routing problem below

serve -s dist

Deploying on external servers

CORS

If your static frontend is deployed to a different domain from your backend API, you will need to properly configure CORS

Contact

David Lin - david.lin.2021@smu.edu.sg

Project Link: https://github.com/SMU-IS216G6T10/smumods-frontend

(back to top)

Acknowledgments

IS216 G6 Team 10

(back to top)

About

Open-sourced University Module Planning Tool for SMU Students (Singapore)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published