CougarCS is the largest student-run Computer Science organization at the University of Houston. At CougarCS, our mission is to smoothly transition our inexperienced members into young professionals by the end of their degree and to provide support and assistance to members who struggle academically or who need career guidance.

This is the admin portal for CougarCS. The portal is designed for officers to manage data of the organization.

The portal is built with NextJS and TypeScript. The backend is built with ExpressJS and TypeScript. The database is built with MySQL. You can view to the backend repository here.

• Requirements

  • NodeJS Version 16+
  • Yarn

• Installation

  1. yarn to install packages
  2. Create an .env in the root (./) directory with the following variables:

    BASE_URL = <API_URL>
  

  3. You're good to go!

• Scripts

  • yarn start : Runs the code normally using next start
  • yarn dev : Starts the development server.
  • yarn build : Builds the application for production usage.

• Linting/Styling

  • This repo uses ESLint and Prettier to enforce linting and styling rules.
  • yarn lint : Runs ESLint on the codebase.
  • yarn prettier : Runs Prettier on the codebase.
  • yarn prettier:fix : Runs Prettier on the codebase and fixes any issues.
  • We highly suggest using an ESLint and Prettier plugin for your respective editor to aid with development.

• Structure

  • _app.tsx : This is the root component of the application.
  • ./components : This folder contains all the components used in the application.
  • ./interfaces : This folder contains all the interfaces used in the application.
  • ./pages : This folder contains all the pages used in the application.
  • ./public : This folder contains all the static files used in the application.
  • ./styles : This folder contains all the styles used in the application.
  • ./types : This folder contains all the types used in the application.
  • ./utils : This folder contains all the utility functions used in the application.

Want to get involved? Get in contact with the CougarCS Webmaster([email protected]) to get involved.