{"id":26107053,"url":"https://github.com/hasnainhsa/assignment-tracker","last_synced_at":"2026-04-17T16:04:27.070Z","repository":{"id":281503062,"uuid":"945461850","full_name":"HasnainHSA/Assignment-Tracker","owner":"HasnainHSA","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-09T14:19:52.000Z","size":104,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-09T15:24:42.247Z","etag":null,"topics":["assignment","python","streamlit","webapp"],"latest_commit_sha":null,"homepage":"https://assignment-tracker.streamlit.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HasnainHSA.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-03-09T13:36:40.000Z","updated_at":"2025-03-09T14:21:42.000Z","dependencies_parsed_at":"2025-03-09T15:35:35.896Z","dependency_job_id":null,"html_url":"https://github.com/HasnainHSA/Assignment-Tracker","commit_stats":null,"previous_names":["hasnainhsa/assignment-tracker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HasnainHSA%2FAssignment-Tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HasnainHSA%2FAssignment-Tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HasnainHSA%2FAssignment-Tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HasnainHSA%2FAssignment-Tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HasnainHSA","download_url":"https://codeload.github.com/HasnainHSA/Assignment-Tracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242762737,"owners_count":20181266,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["assignment","python","streamlit","webapp"],"created_at":"2025-03-09T22:43:00.416Z","updated_at":"2026-04-17T16:04:27.056Z","avatar_url":"https://github.com/HasnainHSA.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Here’s the completed `README.md` in proper Markdown format, structured as a typical README file with clear sections and consistent formatting. It’s ready to be dropped into your project directory.\n\n---\n\n\n# Assignment Tracker\n\nA sleek, dark-mode assignment tracker built with **Streamlit** to help you manage your university workload. Add assignments, track their completion, monitor progress with charts, and stay organized—all with a minimalist vibe.\n\n\n## Features\n\n- **Add Assignments**: Input assignment names and due dates with an intuitive form.\n- **Track Progress**: Mark assignments as \"Done\" and see your progress with a smooth progress bar.\n- **Visual Insights**: \n  - Pie chart showing the current status (Completed vs. Pending).\n- **Persistent Storage**: Assignments and history are saved to a JSON file (`assignments.json`).\n- **Dark Mode UI**: Custom CSS with smooth animations, hover effects, and a modern aesthetic.\n- **History Tracking**: Logs actions like adding, completing, or deleting assignments.\n- **Clear All**: Reset everything with a single button for a fresh start.\n\n\n\n## Prerequisites\n\n- **Python 3.8+**: Ensure Python is installed on your system.\n- A terminal or command-line interface to install dependencies and run the app.\n\n---\n\n## Installation\n\n1. **Clone the Repository** (or download the code):\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd minimalist-assignment-tracker\n   ```\n\n2. **Set Up a Virtual Environment** (optional but recommended):\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows: venv\\Scripts\\activate\n   ```\n\n3. **Install Dependencies**:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Run the Application**:\n   ```bash\n   streamlit run app.py\n   ```\n   Open your browser to `http://localhost:8501` to start tracking!\n\n---\n\n## Usage\n\n1. **Add an Assignment**:\n   - Enter the assignment name (e.g., \"CS101 Essay\") and select a due date.\n   - Click \"Add Assignment\" to save it.\n2. **Track Assignments**:\n   - View all assignments sorted by due date.\n   - Mark them as \"Done\" with the checkbox or delete them with the \"Delete\" button.\n3. **Monitor Progress**:\n   - Check the progress bar and pie chart to see how you’re doing.\n4. **Clear All**:\n   - Hit \"Clear All Assignments\" to wipe the slate clean.\n\n---\n\n## File Structure\n\n- `app.py`: The main application code.\n- `assignments.json`: Auto-generated file to store assignments and history.\n- `requirements.txt`: List of Python dependencies.\n- `README.md`: This file.\n\n---\n\n## Dependencies\n\nSee `requirements.txt` for the full list. Key libraries include:\n- `streamlit`: Web app framework.\n- `matplotlib`: For generating charts.\n- Standard Python libraries: `datetime`, `json`, `os`, `collections`.\n\n---\n\n## Screenshots\n\nHere’s what you’ll see when you run the app:\n\n1. **Main Interface**  \n   - A dark-themed layout with a bold \"Minimalist Assignment Tracker\" title.\n   - Below, a form to add assignments with a glowing \"Add Assignment\" button on hover.\n   - Assignments listed in neat cards, showing due dates and days left (or \"Overdue!\" in red).\n\n2. **Progress Section**  \n   - A green progress bar fills up as you complete tasks.\n   - A pie chart in green and red shows the split between Completed and Pending assignments.\n\n3. **Assignment Card**  \n   - Each card has a checkbox to mark \"Done\" and a \"Delete\" button that pops with a shadow effect on hover.\n   - Overdue assignments stand out with red text—impossible to miss!\n\n*Note: Add real screenshots by dragging images into your repo and linking them here (e.g., `![Main Interface](screenshots/main.png)`).*\n\n---\n\n## Notes\n\n- The app saves data to `assignments.json` in the same directory. Don’t delete this file unless you want to reset everything!\n- The pie chart updates dynamically based on completed and pending assignments.\n- Overdue assignments are highlighted in red for quick visibility.\n\n---\n\n## Contributing\n\nFeel free to fork this repo, tweak the code, or submit a pull request with improvements! Ideas:\n- Add notifications for upcoming due dates.\n- Include a filter for completed/pending assignments.\n- Enhance the charts with more detailed stats (e.g., completion trends over time).\n\n---\n\n## License\n\nThis project is open-source under the [MIT License](LICENSE). Use it, modify it, share it—go wild!\n\n---\n\n## Built With\n\n- Python \u0026 Streamlit\n- Dark mode uni vibes 📚\n\nHappy tracking!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasnainhsa%2Fassignment-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhasnainhsa%2Fassignment-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasnainhsa%2Fassignment-tracker/lists"}