Georgia Tech Scheduler lets you find the schedule that fits you best among all the possible combinations of courses.
This work is a derivative of the original and spectacular GT Scheduler project created by Jinseo Park. The original work and all modifications are licensed under the AGPL v3.0 license.
Copyright (c) 2020 Jinseo Park ([email protected])
Copyright (c) 2020 the Bits of Good "GT Scheduler" team
The app is a React single-page application (SPA) (built using create-react-app) that forms the frontend website users interact with when they go to https://gt-scheduler.org/. It is written in TypeScript (a typed superset of JavaScript), and uses SCSS for styling (a superset of CSS that supports advanced features).
To implement its goal of facilitating schedule creation and class exploration, GT Scheduler stores all data locally in cookies. Then, it sources any relevant data at runtime from a variety of sources, such as:
- The list of terms (strings like
202008, which corresponds to Fall 2020) that have been scraped by the Crawler application: https://gt-scheduler.github.io/crawler/index.json - The data for a single term, which is the full output of the Crawler application in a single JSON file: https://gt-scheduler.github.io/crawler/202008.json
- Seating information for a single section, which is requested on demand and sent through our CORS proxy in the Backend application to Oscar (Georgia Tech's registration management system): https://gt-scheduler.azurewebsites.net/proxy/class_section?term=202008&crn=87086
- Course/instructor GPA information, which is fetched from Course Critique's API: https://c4citk6s9k.execute-api.us-east-1.amazonaws.com/test/data/course?courseID=CS%201331
Once features are merged into the main branch, they are automatically deployed to the gh-pages branch using a GitHub Action workflow. This branch is set up to serve traffic to the public site, https://gt-scheduler.org/, using the GitHub Pages service.
The website uses Google Analytics for aggregate analytics and information about how many people are using the app. It also utilizes Sentry for automatic error reporting.
- Node.js (any recent version will probably work)
- Installation of the
yarnpackage manager version 1 (support for version 2 is untested)
After cloning the repository to your local computer, run the following command in the repo folder:
yarn install
This may take a couple minutes and will create a new folder called node_modules with all of the dependencies installed within. This only needs to be run once.
Then, to start a local development version of the frontend app, run:
yarn start
The app should then be viewable at http://localhost:3000, which you can open a new browser tab to view.
With that, you're able to make changes to the code and have them be re-built and viewable after a short delay in the same tab. This is the main workflow for adding new features or fixing bugs and testing them in the actual app.
Warning
When running the development server (and when building the site), a large number of warnings may appear in the console that look something like:
WARNING in ./node_modules/parse5/dist/common/token.js Module Warning (from ./node_modules/source-map-loader/dist/cjs.js): Failed to parse source map from '.../website/node_modules/parse5/dist/common/token.js.map' file: Error: ENOENT: no such file or directory, open '.../website/node_modules/parse5/dist/common/token.js.map' @ ./node_modules/parse5/dist/index.js 13:0-44 14:0-27 @ ...These can be safely ignored.
They are due to a combination of misconfiguration in a few transitive dependencies (such as
parse5,/@firebase/auth, andexponential-backoff) and the overzealousness ofcreate-react-app's default configuration in reporting non-issues.See facebook/create-react-app#11767 for more details.
yarn run secrets:linux- obtain app secrets for Linux and MacOS; ask Engineering Manager for passwordyarn run secrets:windows- obtain app secrets for Windows; ask Engineering Manager for password
The project uses pre-commit hooks using Husky and lint-staged to run linting (via ESLint) and formatting (via Prettier). These can be run manually from the command line to format/lint the code on-demand, using the following commands:
yarn run lint- runs ESLint and reports all linting errors without fixing themyarn run lint:fix- runs ESLint and reports all linting errors, attempting to fix any auto-fixable onesyarn run format- runs Prettier and automatically formats the entire codebaseyarn run format:check- runs Prettier and reports formatting errors without fixing them
The GT Scheduler project welcomes (and encourages) contributions from the community. Regular development is performed by the project owners (Jason Park and Bits of Good), but we still encourage others to work on adding new features or fixing existing bugs and make the registration process better for the Georgia Tech community.
More information on how to contribute can be found in the contributing guide.