{"id":27075827,"url":"https://github.com/bushra-butt-17/student-api-mongodb","last_synced_at":"2026-03-20T01:03:22.169Z","repository":{"id":286358424,"uuid":"763148143","full_name":"Bushra-Butt-17/Student-API-MongoDB","owner":"Bushra-Butt-17","description":"A fully responsive and user-friendly Students Management System built with Flask, MongoDB, and Bootstrap. 🚀 Manage student records with CRUD operations and enjoy a smooth UI experience.","archived":false,"fork":false,"pushed_at":"2024-12-24T05:37:08.000Z","size":304,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-27T01:35:21.442Z","etag":null,"topics":["api-integration","bootstrap","crud","flask-application","mongodb","python","student-management","user-interface"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Bushra-Butt-17.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-25T17:25:06.000Z","updated_at":"2025-03-22T12:19:46.000Z","dependencies_parsed_at":"2025-04-06T00:16:57.363Z","dependency_job_id":"31265baf-6cb5-4feb-8680-8f4af42620cd","html_url":"https://github.com/Bushra-Butt-17/Student-API-MongoDB","commit_stats":null,"previous_names":["bushra-butt-17/student-api-mongodb","bushra-butt-17/localrepo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Bushra-Butt-17/Student-API-MongoDB","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bushra-Butt-17%2FStudent-API-MongoDB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bushra-Butt-17%2FStudent-API-MongoDB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bushra-Butt-17%2FStudent-API-MongoDB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bushra-Butt-17%2FStudent-API-MongoDB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bushra-Butt-17","download_url":"https://codeload.github.com/Bushra-Butt-17/Student-API-MongoDB/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bushra-Butt-17%2FStudent-API-MongoDB/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29558100,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T20:52:40.164Z","status":"ssl_error","status_checked_at":"2026-02-17T20:48:10.325Z","response_time":100,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-integration","bootstrap","crud","flask-application","mongodb","python","student-management","user-interface"],"created_at":"2025-04-06T00:16:55.097Z","updated_at":"2026-02-17T21:01:58.085Z","avatar_url":"https://github.com/Bushra-Butt-17.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://github.com/user-attachments/assets/debd283a-2436-4c32-8cca-444c0a77c957\" alt=\"Project Preview\" width=\"100%\"\u003e\r\n\r\n\r\n# 📚 Students Management System - Flask Web Application\r\n\r\nWelcome to the **Students Management System** built using **Flask**, **MongoDB**, and **Bootstrap**! 🚀 This project allows you to **Create**, **Read**, **Update**, and **Delete** student records through a user-friendly interface. Let's explore the details! 💻✨\r\n\r\nhttps://github.com/user-attachments/assets/43e38d5b-ba16-43be-95f3-dd41fd8796d6\r\n\r\n\r\n\r\n\r\n## 🚀 Features\r\n\r\n- **✨ Beautiful User Interface**: Built with **Bootstrap** and custom styling to ensure a smooth and aesthetic experience.\r\n- **📱 Fully Responsive**: The application looks great on all devices, from desktops to mobile phones.\r\n- **📚 CRUD Operations**: You can **add, view, update**, and **delete** student records in the database.\r\n- **🔙 Home Button**: Go back to the homepage anytime with an easy-to-access button.\r\n- **🛠 Flash Messages**: Alerts are shown on the page for any important actions (like success or errors).\r\n- **❤️ Footer**: Featuring credits and a visit link.\r\n\r\n## 🌟 Technologies Used\r\n\r\n- **Python**: The backend is powered by **Flask**, a lightweight Python web framework.\r\n- **MongoDB**: All students' data is stored in a **MongoDB** database.\r\n- **Bootstrap**: Provides an attractive and responsive design out of the box.\r\n- **HTML/CSS**: For structuring the page and styling it.\r\n\r\n## 🔧 Installation\r\n\r\n### Prerequisites\r\n\r\nBefore you get started, ensure you have the following installed on your machine:\r\n\r\n- Python 3.x\r\n- Flask\r\n- MongoDB\r\n- Bootstrap (used via CDN)\r\n\r\n### Steps\r\n\r\n1. Clone the repository:\r\n\r\n   ```bash\r\n   git clone https://github.com/Bushra-Butt-17/Student-API-MongoDB.git\r\n   cd students-management\r\n   ```\r\n\r\n2. Install the required Python dependencies:\r\n\r\n   ```bash\r\n   pip install -r requirements.txt\r\n   ```\r\n\r\n3. Make sure your **MongoDB** server is running locally or remotely.\r\n\r\n4. Run the Flask application:\r\n\r\n   ```bash\r\n   python app.py\r\n   ```\r\n\r\n5. Open your browser and navigate to `http://127.0.0.1:5000` to see the application in action! 🎉\r\n\r\n## 🎨 UI Preview\r\n\r\nHere is a preview of how the application looks:\r\n\r\n- **Home Page**: With a **Go Back to Home** button that takes you back to the homepage.\r\n- **Students Table**: Displays all students' information in a neat table with hover effects.\r\n- **Footer**: Includes credits and a footer link to a helpful website.\r\n\r\n## 🖥 How It Works\r\n\r\nThis application provides a simple **CRUD** (Create, Read, Update, Delete) functionality for managing student records in a MongoDB database. Here’s a breakdown of each operation:\r\n\r\n### 1. **Create** (Add Student)\r\nThe application allows you to add new students to the database. The form to add a student includes fields for:\r\n- **Name**\r\n- **Age**\r\n- **Grade**\r\n\r\nAfter submitting the form, a new student is created and added to the database. A success message is displayed to confirm the action.\r\n\r\n### 2. **Read** (View Students)\r\nOnce a student is added, you can view all student records in a well-structured table. The table shows:\r\n- **Name**\r\n- **Age**\r\n- **Grade**\r\n\r\nThe table is populated dynamically using data fetched from the MongoDB database. Additionally, you can filter students based on various attributes.\r\n\r\n### 3. **Update** (Edit Student)\r\nYou can edit an existing student’s details. The application provides an **Edit** button next to each student record in the table. Clicking it allows you to modify the following fields:\r\n- **Name**\r\n- **Age**\r\n- **Grade**\r\n\r\nAfter saving the changes, the updated student data is saved to the database, and a success message is displayed.\r\n\r\n### 4. **Delete** (Remove Student)\r\nIf you want to delete a student, there is a **Delete** button next to each record. Clicking this button removes the student from the database. A confirmation message will be displayed to confirm the deletion.\r\n\r\n## ⚙️ Database Configuration\r\n\r\nThe application uses **MongoDB** as the database to store student information. The connection URI for MongoDB can be configured in the Flask app.\r\n\r\n### Example configuration:\r\n\r\n```python\r\napp.config['MONGO_URI'] = 'mongodb://localhost:27017/studentsdb'\r\n```\r\n\r\n- The **studentsdb** database stores student records in a collection called **students**.\r\n- Each student document contains the following fields: **name**, **age**, and **grade**.\r\n\r\n## 📱 Mobile-Friendly\r\n\r\nThe app is **fully responsive** and provides a seamless experience on mobile devices. Try resizing your browser window to see how the layout adjusts!\r\n\r\n## 📸 Screenshots\r\n\r\n### Home Page\r\n![Main](https://github.com/user-attachments/assets/d1da93a5-8f59-4733-9c51-120fa33dd092)\r\n![Actions](https://github.com/user-attachments/assets/81634c3f-873c-42c6-9df0-9b5a153d02d5)\r\n### Students Table\r\n![All-Students](https://github.com/user-attachments/assets/b0006bf2-0a78-4d44-8138-21230c111d17)\r\n![Students-Age](https://github.com/user-attachments/assets/ff3c27c2-cf95-4089-b618-c9d4e421f251)\r\n![Filter-by-Age](https://github.com/user-attachments/assets/396b7014-edb3-4f2e-b9b6-55f1f7efaed7)\r\n### Add/Edit Student Form\r\n![Add-Student](https://github.com/user-attachments/assets/fe816478-5d3a-4e32-a76c-b48c2a9869ea)\r\n![Update-Success](https://github.com/user-attachments/assets/51894b36-f23b-4b18-aa26-e8a8135a5393)\r\n![Delete-Alert](https://github.com/user-attachments/assets/3130ae93-5016-4b02-9fcf-0f1d1a72d86e)![Update-Form](https://github.com/user-attachments/assets/d176c471-60ff-44fd-8ccf-aae4aec96a05)\r\n![Delete-Flash](https://github.com/user-attachments/assets/1d1bb215-225f-49c4-b41d-1e99689218bc)\r\n\r\n\r\n## 📝 Contributing\r\n\r\nContributions are welcome! If you find any issues or have ideas for improvement, feel free to open an issue or create a pull request. Here's how you can contribute:\r\n\r\n1. Fork the repository\r\n2. Create a new branch (`git checkout -b feature-branch`)\r\n3. Commit your changes (`git commit -am 'Add new feature'`)\r\n4. Push to the branch (`git push origin feature-branch`)\r\n5. Create a new Pull Request\r\n\r\n## 🛠️ License\r\n\r\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\r\n\r\n---\r\n\r\nMade with ❤️ by **Bushra Shahbaz** (BSDSF21M020) 🚀\r\n\r\n---\r\n\r\n## 💬 Feel Free to Reach Out\r\n\r\nIf you have any questions or feedback, feel free to reach out to me at [bsdsf21m020@pucit.edu.pk](mailto:bsdsf21m020@pucit.edu.pk). 😊\r\n\r\n---\r\n\r\n## 🔧 Requirements\r\n\r\n### **`requirements.txt`**\r\n\r\nHere are the dependencies you need to install:\r\n\r\n```txt\r\nFlask==2.2.2\r\nflask-pymongo==2.3.0\r\npymongo==4.3.3\r\nflask-wtf==1.0.0\r\n```\r\n\r\n### How to Install:\r\n\r\n1. **Create a Virtual Environment (optional but recommended)**:\r\n\r\n   ```bash\r\n   python3 -m venv venv\r\n   ```\r\n\r\n2. **Activate the Virtual Environment**:\r\n   - **For Windows**:\r\n     ```bash\r\n     venv\\Scripts\\activate\r\n     ```\r\n   - **For Mac/Linux**:\r\n     ```bash\r\n     source venv/bin/activate\r\n     ```\r\n\r\n3. **Install the dependencies**:\r\n\r\n   ```bash\r\n   pip install -r requirements.txt\r\n   ```\r\n\r\n4. **Run the Application**:\r\n\r\n   After installing the dependencies, run the Flask application with:\r\n\r\n   ```bash\r\n   python app.py\r\n   ```\r\n\r\n---\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbushra-butt-17%2Fstudent-api-mongodb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbushra-butt-17%2Fstudent-api-mongodb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbushra-butt-17%2Fstudent-api-mongodb/lists"}