UF Open Source Club's Website

The official remodeling of the official club website.

The website needs to be a central place for

• Potential club members who are interested in what the Open Source Club is and want to find out more
• Existing club members as a way to easily check what events are happening and what projects the club is working on
• Students or others who are interested in open source in general and want to see how UF is involved with Open Source

The project roadmap can be found here.

Getting Started

Install

• An internet browser like Firefox or Google Chrome
• An IDE or text editor like WebStorm, VSCode, Atom, or Sublime Text
  • Install an EditorConfig plugin if available, to help ensure consistent formatting
• Node.js (whatever version is the latest, there shouldn't be any issues unless on an ancient version)
• Yarn - Instructions to install here

Then clone this repo

Verifying your installs

• run yarn -v and node -v, these should output a version number along the lines of v10.16.0 or 6.11.3
• if these commands fail, make sure you have node.js properly installed.

Testing

If working with backend follow these instructions:

1. The first step is to run yarn install in the root project repository.

2. Now run yarn workspace server watch to startup the server.

3. The backend development server should now be running! For testing with a database connect to a mongoDB database either locally or remotely.

If working with the frontend follow these instructions:

1. Run the command yarn workspace client start from the root directory.

2. The server should now be running on http://localhost:3000

Deployment

Our own Nginx server using the club stack project

Built With

• React - Used for the frontend, it helps define the layout into components and manage page elements/components dynamically.
• Node.js - Used on the backend, useful for HTTP protocol and uses an asynchronous event driven JavaScript runtime.
• Express - A Node.js framework with a plethora of HTTP utility methods and middleware.
• MongoDB - A document-based, NoSQL database.

Check out the DESIGN.md file in docs folder for more information about the project.

Contributing

Please read CONTRIBUTING.md for how to work on the project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details