Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shiinaneet/violationwebreactapp

Last synced: 23 days ago
JSON representation

Host: GitHub
URL: https://github.com/shiinaneet/violationwebreactapp
Owner: ShiinaNeet
Created: 2024-10-03T05:39:41.000Z (3 months ago)
Default Branch: main
Last Pushed: 2024-12-12T04:08:46.000Z (about 1 month ago)
Last Synced: 2024-12-12T05:19:14.444Z (about 1 month ago)
Language: JavaScript
Size: 560 KB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Student Violation Management with Email Integration

**Student Violation List** is a web application designed to manage student violations effectively. It allows users to create, edit, and delete violations, as well as visualize the data through charts that display monthly and overall student violations. The application is built using React with Vite and Material UI.

Website: [Student-Violations-Website](https://react.shiinaneet.site/)

## Features

- **CRUD Operations**: Create, read, update, and delete student violations.
- **Violation Management**: Easily manage and categorize student violations.
- **Data Visualization**: View charts for monthly and overall student violations.
- **Responsive Design**: Optimized for both desktop and mobile devices.

## Tech Stack

- **Frontend**: React (Vite)
- **UI Framework**: Material UI
- **Charts**: (Specify the chart library used, e.g., Chart.js, Recharts)
- **Deployment**: (Nginx - Ubuntu)

## Prerequisites

To run this project locally, you need to have the following installed:

- [Node.js](https://nodejs.org/en/)
- [npm](https://www.npmjs.com/)

## Installation

Follow these steps to set up the project locally:

1. **Clone the repository**:
```bash
git clone https://github.com/shiinaneet/ViolationWebReactApp.git
cd ViolationWebReactApp
```

2. **Install dependencies**:
```bash
npm install
```

3. **Run the application**:
```bash
npm run dev
```

4. **Open your browser**:
Visit `http://localhost:3000` (or the port specified in the console) to view the application.

## Screenshots

Add screenshots of your app here:

1. **Student with Violation List**
![Student with Violation List](https://github.com/user-attachments/assets/39acb72e-8403-42c0-995a-bcd072fa47d3)
![Edit student Violation](https://github.com/user-attachments/assets/9ddb6852-a53c-4839-ad62-a95696e9036d)
![Student Full information](https://github.com/user-attachments/assets/08c4654e-bb3f-464c-89ec-ce923832af91)
![Student Send Email](https://github.com/user-attachments/assets/919355d2-e65e-40af-b5e9-0f40982859ea)

2. **Violation List**
![Violation List](https://github.com/user-attachments/assets/63d9ced8-9b86-42f4-906a-19d4f556d5a4)

3. **Violation Chart**
![Chart](https://github.com/user-attachments/assets/b85a80b1-906c-429c-bc24-1f97fd0d7b7b)

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Contact

For any inquiries, please contact:
- **Name**: Gene Paolo Dayandayan
- **Email**: [email protected]
- **GitHub**: [github.com/ShiinaNeet](https://github.com/ShiinaNeet)