Skip to content
/ web-mhs Public

A clean and dynamic student listing web app built with React JS to display and manage a list of university students with a responsive and modern UI.

Notifications You must be signed in to change notification settings

AriqF1/web-mhs

Repository files navigation

StudentHUB

StudentHUB is a web application built with React JS designed to help students and lecturers manage courses, and interact with various dashboard features.


GitHub stars GitHub forks

📚 Features

  • 🔐 Login and Authentication
    Secure login system that allows users (students and lecturers) to access the portal.

  • 📚 Courses Page
    A page dedicated to displaying and managing available courses.

  • 👩‍🏫 Lecturers Page
    A page that lists lecturers, their profiles, and associated courses.

  • 👨‍🎓 Student Page
    A page that lists student, their profiles, and detail.

  • 📊 Dashboard with Interactive Widgets
    A personalized dashboard displaying key metrics such as total courses, total lecturers, total students, using interactive widgets.


🛠️ Built With

  • React JS — A JavaScript library for building user interfaces.
  • React Router — For handling navigation between different pages of the application.
  • Context API / Redux (if used) — State management for user data, authentication status, and global states.
  • Tailwind CSS — For styling the application.

📦 Installation

Follow these steps to get your project up and running locally:

  1. Clone the repository:

    git clone https://github.com/your-username/web-mhs.git
    cd web-mhs
  2. Install dependencies frontend:

    cd frontend
    npm install
  3. Install dependencies frontend:

    ccd ..
    cd backend
    npm install
  4. Run the application:

    cd ..
    cd frontend
    npm run dev
    
    cd ..
    cd backend
    node index.js

🚀 Usage Examples

To use the StudentHUB application, follow these steps after installation:

  1. Open your browser and navigate to http://localhost:3000.
  2. Log in using your credentials.
  3. Explore the dashboard and manage courses.

🤝 Contributing

Contributions are welcome! Please follow these steps to contribute:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/AmazingFeature).
  3. Make your changes and commit them (git commit -m 'Add some AmazingFeature').
  4. Push to the branch (git push origin feature/AmazingFeature).
  5. Open a pull request.

📄 License

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

About

A clean and dynamic student listing web app built with React JS to display and manage a list of university students with a responsive and modern UI.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages