{"id":48092457,"url":"https://github.com/manighahrmani/programming_marks_calculator","last_synced_at":"2026-04-04T15:32:45.112Z","repository":{"id":242220623,"uuid":"808721629","full_name":"manighahrmani/programming_marks_calculator","owner":"manighahrmani","description":"A calculator for the Programming module (M30299) build using Flutter and hosted on Firebase. ","archived":false,"fork":false,"pushed_at":"2025-02-08T19:25:34.000Z","size":325,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-08T20:26:09.846Z","etag":null,"topics":["dart","firebase","flutter","portsmouth","programming"],"latest_commit_sha":null,"homepage":"https://programming-marks-calculator.web.app","language":"C++","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/manighahrmani.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":"2024-05-31T17:11:32.000Z","updated_at":"2025-02-08T19:25:37.000Z","dependencies_parsed_at":"2024-06-10T18:06:23.479Z","dependency_job_id":"c8c16b8e-758d-4d59-846a-3878ba8d7b91","html_url":"https://github.com/manighahrmani/programming_marks_calculator","commit_stats":null,"previous_names":["manighahrmani/programming_marks_calculator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/manighahrmani/programming_marks_calculator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manighahrmani%2Fprogramming_marks_calculator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manighahrmani%2Fprogramming_marks_calculator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manighahrmani%2Fprogramming_marks_calculator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manighahrmani%2Fprogramming_marks_calculator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manighahrmani","download_url":"https://codeload.github.com/manighahrmani/programming_marks_calculator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manighahrmani%2Fprogramming_marks_calculator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31403959,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"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":["dart","firebase","flutter","portsmouth","programming"],"created_at":"2026-04-04T15:32:36.124Z","updated_at":"2026-04-04T15:32:44.658Z","avatar_url":"https://github.com/manighahrmani.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Programming Marks Calculator\n\nThis is a Flutter app that calculates the total marks for a programming course based on various assessments and their respective weights.\n\n## Getting Started\n\nTo run this app on your local machine, follow these steps:\n\n1. Make sure you have Flutter installed. If not, follow the official installation guide: [Flutter Installation](https://flutter.dev/docs/get-started/install)\n\n2. Clone this repository using Visual Studio Code:\n   - Open Visual Studio Code.\n   - Press `Ctrl+Shift+P` (or `Cmd+Shift+P` on macOS) to open the command palette.\n   - Type \"Git: Clone\" and press Enter.\n   - Paste the repository URL: `https://github.com/manighahrmani/programming_marks_calculator`\n   - Choose a location to save the cloned repository.\n   - Click \"Open\" to open the cloned repository in Visual Studio Code.\n\n3. Install the necessary extensions in Visual Studio Code:\n   - Dart\n   - Flutter\n\n4. Open the terminal in Visual Studio Code (`Ctrl+Shift+P` and type \"Terminal: Create New Integrated Terminal\") and navigate to the project directory:\n   ```\n   cd programming_marks_calculator\n   ```\n\n5. Run the following command to get the dependencies:\n   ```\n   flutter pub get\n   ```\n\n6. Connect a device or start an emulator.\n\n7. Run the app using the following command:\n   ```\n   flutter run\n   ```\n\n## App Structure\n\nThe app consists of three main parts:\n\n1. **Data**: The [`lib/data/assessment_data.dart`](https://github.com/manighahrmani/programming_marks_calculator/tree/main/lib/data/assessment_data.dart) file contains the data for the assessments and their corresponding weights.\n\n2. **Backend**: The [`lib/backend/marks_calculator.dart`](https://github.com/manighahrmani/programming_marks_calculator/tree/main/lib/backend/marks_calculator.dart) file contains the logic for calculating the total marks based on the entered marks and the assessment weights.\n\n3. **UI**: The [`lib/ui/home_page.dart`](https://github.com/manighahrmani/programming_marks_calculator/tree/main/lib/ui/home_page.dart) file defines the user interface of the app. It includes text fields for entering marks and a button to calculate the total marks.\n\nThe UI communicates with the backend by passing the entered marks to the `MarksCalculator` class, which performs the calculations and returns the result. The data is kept separate in the `assessment_data.dart` file, promoting separation of concerns.\n\n## Hosting on Firebase (for free!)\n\nTo host your Flutter app as a website on Firebase, follow these steps:\n\n1. Create a new Firebase project on the Firebase Console: [Firebase Console](https://console.firebase.google.com/)\n\n2. Install the Firebase CLI by running the following command:\n   ```\n   npm install -g firebase-tools\n   ```\n\n3. Log in to Firebase using the CLI:\n   ```\n   firebase login\n   ```\n\n4. In your Flutter project directory, initialize Firebase:\n   ```\n   firebase init\n   ```\n   Select \"Hosting\" and follow the prompts to set up hosting.\n\n5. Build your Flutter app for the web:\n   ```\n   flutter build web\n   ```\n\n6. Deploy your app to Firebase Hosting:\n   ```\n   firebase deploy\n   ```\n\n7. Your app will be hosted at the provided URL, which will look like: `https://your-project-id.web.app`\n\n## Live App\n\nYou can test the live version of the Programming Marks Calculator app hosted on Firebase: [Programming Marks Calculator](https://programming-marks-calculator.web.app)\n\nFeel free to explore the app and provide feedback!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanighahrmani%2Fprogramming_marks_calculator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanighahrmani%2Fprogramming_marks_calculator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanighahrmani%2Fprogramming_marks_calculator/lists"}