{"id":26662910,"url":"https://github.com/al-rimi/submit-pak","last_synced_at":"2026-01-31T23:09:21.760Z","repository":{"id":263260437,"uuid":"889775851","full_name":"Al-rimi/submit-pak","owner":"Al-rimi","description":"Laravel-based submissions management package","archived":false,"fork":false,"pushed_at":"2024-12-05T01:54:44.000Z","size":1630,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-11T18:23:40.824Z","etag":null,"topics":["assignment-management","laravel-package","php","submission-notifications","submission-system","submissions","vanilla-css","vanilla-js"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/Al-rimi.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-11-17T07:42:38.000Z","updated_at":"2024-12-05T01:54:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"62f17b80-7746-4d6f-b9a6-979b7e36c8c8","html_url":"https://github.com/Al-rimi/submit-pak","commit_stats":null,"previous_names":["al-rimi/submit-pak"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al-rimi%2Fsubmit-pak","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al-rimi%2Fsubmit-pak/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al-rimi%2Fsubmit-pak/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al-rimi%2Fsubmit-pak/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Al-rimi","download_url":"https://codeload.github.com/Al-rimi/submit-pak/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248456382,"owners_count":21106607,"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-management","laravel-package","php","submission-notifications","submission-system","submissions","vanilla-css","vanilla-js"],"created_at":"2025-03-25T14:18:55.298Z","updated_at":"2026-01-31T23:09:21.755Z","avatar_url":"https://github.com/Al-rimi.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **Submit Package**\n\n[](./screenshots/screenshot-pc.jpg)\n[](./screenshots/screenshot-phone.jpg)\n\nA simple and customizable system for managing submissions. Designed for Laravel applications, it offers essential tools to streamline submission processes with minimal setup.\n\n## **Installation**\n\n#### Step 1: Install the Package\n```bash\ncomposer require al-rimi/submit\n```\n\n#### Step 2: Run the Installation Command\n```bash\nphp artisan submit:install\n```\n\u003cdetails\u003e\n\u003csummary\u003eThis command performs the following tasks:\u003c/summary\u003e\n\n\n  1. Publishes assets, views, and configuration files.\n  2. Installs necessary Node.js dependencies.\n  3. Updates the `vite.config.js` file with Submit assets (`submit.css` and `submit.js`).\n  4. Builds assets using `npm run build`.\n  5. Runs database migrations.\n  6. Seeds the database with example data.\n\n\u003c/details\u003e\n\n## **Features**\n- **Submission Management**: Collect, validate, and store student submissions effectively.\n- **Email Notifications**: Rreceive notifications after each submission.\n- **Dynamic Table Management**: Displays and updates student submissions dynamically without page reloads.\n- **Auto-fill**: Custom JS script for client side auto fill.\n- **UI**: vanilla CSS with simple animations and clean look..\n\n## **Customization**  \n\n#### **Environment Variables**  \nTo enable submission notifications and set a deadline, add the following variables to your `.env` file:  \n```env  \nNOTIFICATION_EMAIL=      # Email address to receive submission notifications  \nSUBMISSION_DEADLINE=     # Submission deadline in ISO 8601 format (e.g., \"YYYY-MM-DDTHH:MM:SS\")  \n```  \n\n#### **Routes**  \nThe package publishes its routes to `routes/submit.php`. You can customize these routes to:  \n- Change view paths.  \n- Add middleware for additional security or access control.  \n\n#### **Views**  \nAll customizable views are published to your project for easy modification:  \n- **Submission Page**: `resources/views/submissions.blade.php`  \n- **Email Template**: `resources/views/emails/submissions_email.blade.php`  \n\n#### **CSS and JavaScript**  \ndependency-free assets for styling and interactivity in **vanilla CSS and JavaScript**:  \n- **CSS File**: `resources/css/submit.css`  \n- **JavaScript File**: `resources/js/submit.js`  \n\n#### **Database**  \nThe package provides database migrations and a sample seeder to kickstart your setup:  \n- **Migrations**: Automatically created tables for submission data.  \n- **Seeder**: `database/Seeders/StudentsTableSeeder.php` populates the database with example records.  \n\n\n## **Troubleshooting**\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eVite Configuration\u003c/strong\u003e\u003c/summary\u003e\n\nThe package automatically adds `resources/css/submit.css` and `resources/js/submit.js` to `vite.config.js`. If this step fails, manually update your `vite.config.js` file:\n\n    export default defineConfig({\n        input: [\n            'resources/css/app.css',\n            'resources/js/app.js',\n            'resources/css/submit.css',\n            'resources/js/submit.js'\n        ],\n        // other Vite configuration\n    });\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eBuild Issues\u003c/strong\u003e\u003c/summary\u003e\n    \nIf you encounter build issues, ensure Node.js and npm are properly installed. Then rerun:\n\n    npm install\n    npm run build\n\u003c/details\u003e\n\n## **Uninstallation**\n\n#### Step 1: Remove all traces of the Submit package:\n```bash\nphp artisan submit:uninstall\n```\n#### Step 2: remove the package:\n```bash\ncomposer remove al-rimi/submit\n```\n\n## **Requirements**\n- PHP 8.0 or higher  \n- Laravel 10.x or 11.x  \n- Node.js (for Vite asset compilation)  \n\n\u003e Have questions or facing issues? Check out the [issues page](https://github.com/Al-rimi/submit-pak/issues).  \n\n## **License**\nThis package is open-source and is licensed under the [MIT License](LICENSE).  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fal-rimi%2Fsubmit-pak","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fal-rimi%2Fsubmit-pak","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fal-rimi%2Fsubmit-pak/lists"}