A website for Online Master's of Science (OMS) course reviews at Georgia Tech.
- Production - https://omshub.org
- Storybook - https://storybook.omshub.org
- OMS Computer Science (OMSCS) - https://omscs.gatech.edu
- OMS Cybersecurity (OMSCY) - https://pe.gatech.edu/degrees/cybersecurity
- OMS Analytics (OMSA) - https://pe.gatech.edu/degrees/analytics
- How to Write a Git Commit Message - https://cbea.ms/git-commit
This project includes a .devcontainers configuration that can be used by VSCode to create a one-click development environment with Docker. The Docker container includes all of the dependencies you need to get started, forwards the NextJS and Storybook ports to your local machine, and mounts the repository into the container so changes persist outside of Docker.
To get started:
- Install the Remote - Containers VSCode extension.
- Open the repository with VSCode. You should see a prompt on the bottom left of the screen to open the project inside the container.
Clone the repository and then run the following commands to build the NextJS application:
yarn install
yarn buildTo start the project locally, run:
yarn startOpen http://localhost:3000 with your browser to see the result. See README.md in /__seed__ for more details regarding seeding backend data (e.g., in a cloud Firebase project).
Ensure that the following is defined locally in environment file website/.env:
NEXT_PUBLIC_IS_EMULATOR_MODE=true
NEXT_PUBLIC_FIRESTORE_EMULATOR_HOST=localhost:8080
To launch the local emulator, run:
yarn install
yarn fb:emuThis will create a local emulator instance of Firebase, with local UI Firebase dashboard accessible via http://localhost:4000 which provides the Firebase Emulator Suite for local services (e.g., Firestore).
Next, to start the project locally, in a separate terminal instance run:
yarn build
yarn devNote: A cloud-based Firebase project must still exist in order to run the emulator locally in this manner. Simply create a blank/empty Firebase project using a Google account for this purpose, and then populate file website/.env accordingly with corresponding API key and project information from Firebase (see website/example.env for additional reference, as well as website/__seed__/README.md for more information regarding seeding a cloud-based Firebase Firestore database).
Open http://localhost:3000 with your browser to see the result. The local data will be seeded from scratch. Furthermore, you can use the local auth service by simply logging in via any of the provided services (e.g., Google) with auto-generated credentials, which will simulate a logged in user account.
yarn dev— Starts the application in development mode athttp://localhost:3000.yarn build— Creates an optimized production build of your application.yarn start— Starts the application in production mode.yarn lint— Runs ESLint for all files in thesrcdirectory.yarn prettier— Runs Prettier for all files in thesrcdirectory.yarn fmt- Runyarn prettierandyarn lintsuccessively.yarn precommit— Run commitizen ongit-staged files.yarn storybook- Run storybook locally athttp://localhost:6006.yarn fb:emu- Run the local Firebase Emulator Suite athttp://localhost:4000.
.github— GitHub configuration including the CI workflow..husky— Husky configuration and hooks.public— Static assets such as robots.txt, images, and favicon.src— Application source code, including pages, components, styles.
Using git commit will bring up a prompt that will fill out commit messages to the repo's commit connvention.
Commit messages must conform to the Conventional Commits specification.
The commit message should be structured as follows:
<type>[optional scope]: <description>
[optional body]
[optional footer(s)]
<type> must be one of the following:
| type | description |
|---|---|
| build | Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm) |
| chore | Changes that do not affect production; e.x., updating grunt tasks, etc. |
| ci | Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) |
| docs | Documentation only changes |
| feat | A new feature |
| fix | A bug fix |
| perf | A code change that improves performance |
| refactor | A code change that neither fixes a bug nor adds a feature |
| revert | A commit that reverts a previous commit |
| style | Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc) |
| test | Adding missing tests or correcting existing tests |
See the Conventional Commits specification for examples of valid commit messages.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![imgbot[bot] avatar](https://avatars.githubusercontent.com/in/4706?v=4 "imgbot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent