PHPackages                             al-rimi/submit - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. al-rimi/submit

ActiveLibrary[Utility & Helpers](/categories/utility)

al-rimi/submit
==============

A simple submission system for managing student submissions.

v1.5.4(1y ago)027MITPHPPHP >=8.0

Since Nov 17Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/Al-rimi/submit-pak)[ Packagist](https://packagist.org/packages/al-rimi/submit)[ RSS](/packages/al-rimi-submit/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (10)Versions (11)Used By (0)

**Submit Package**
==================

[](#submit-package)

[](./screenshots/screenshot-pc.jpg)[](./screenshots/screenshot-phone.jpg)

A simple and customizable system for managing submissions. Designed for Laravel applications, it offers essential tools to streamline submission processes with minimal setup.

**Installation**
----------------

[](#installation)

#### Step 1: Install the Package

[](#step-1-install-the-package)

```
composer require al-rimi/submit
```

#### Step 2: Run the Installation Command

[](#step-2-run-the-installation-command)

```
php artisan submit:install
```

This command performs the following tasks:1. Publishes assets, views, and configuration files.
2. Installs necessary Node.js dependencies.
3. Updates the `vite.config.js` file with Submit assets (`submit.css` and `submit.js`).
4. Builds assets using `npm run build`.
5. Runs database migrations.
6. Seeds the database with example data.

**Features**
------------

[](#features)

- **Submission Management**: Collect, validate, and store student submissions effectively.
- **Email Notifications**: Rreceive notifications after each submission.
- **Dynamic Table Management**: Displays and updates student submissions dynamically without page reloads.
- **Auto-fill**: Custom JS script for client side auto fill.
- **UI**: vanilla CSS with simple animations and clean look..

**Customization**
-----------------

[](#customization)

#### **Environment Variables**

[](#environment-variables)

To enable submission notifications and set a deadline, add the following variables to your `.env` file:

```
NOTIFICATION_EMAIL=      # Email address to receive submission notifications
SUBMISSION_DEADLINE=     # Submission deadline in ISO 8601 format (e.g., "YYYY-MM-DDTHH:MM:SS")
```

#### **Routes**

[](#routes)

The package publishes its routes to `routes/submit.php`. You can customize these routes to:

- Change view paths.
- Add middleware for additional security or access control.

#### **Views**

[](#views)

All customizable views are published to your project for easy modification:

- **Submission Page**: `resources/views/submissions.blade.php`
- **Email Template**: `resources/views/emails/submissions_email.blade.php`

#### **CSS and JavaScript**

[](#css-and-javascript)

dependency-free assets for styling and interactivity in **vanilla CSS and JavaScript**:

- **CSS File**: `resources/css/submit.css`
- **JavaScript File**: `resources/js/submit.js`

#### **Database**

[](#database)

The package provides database migrations and a sample seeder to kickstart your setup:

- **Migrations**: Automatically created tables for submission data.
- **Seeder**: `database/Seeders/StudentsTableSeeder.php` populates the database with example records.

**Troubleshooting**
-------------------

[](#troubleshooting)

**Vite Configuration**The 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:

```
export default defineConfig({
    input: [
        'resources/css/app.css',
        'resources/js/app.js',
        'resources/css/submit.css',
        'resources/js/submit.js'
    ],
    // other Vite configuration
});

```

**Build Issues**If you encounter build issues, ensure Node.js and npm are properly installed. Then rerun:

```
npm install
npm run build

```

**Uninstallation**
------------------

[](#uninstallation)

#### Step 1: Remove all traces of the Submit package:

[](#step-1-remove-all-traces-of-the-submit-package)

```
php artisan submit:uninstall
```

#### Step 2: remove the package:

[](#step-2-remove-the-package)

```
composer remove al-rimi/submit
```

**Requirements**
----------------

[](#requirements)

- PHP 8.0 or higher
- Laravel 10.x or 11.x
- Node.js (for Vite asset compilation)

> Have questions or facing issues? Check out the [issues page](https://github.com/Al-rimi/submit-pak/issues).

**License**
-----------

[](#license)

This package is open-source and is licensed under the [MIT License](LICENSE).

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance46

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

10

Last Release

543d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8c05d70a1593760b275579c837f6d98db3efbfefe9e17f9fbe68d4c39b382b73?d=identicon)[Al-rimi](/maintainers/Al-rimi)

---

Top Contributors

[![Al-rimi](https://avatars.githubusercontent.com/u/123071996?v=4)](https://github.com/Al-rimi "Al-rimi (61 commits)")

---

Tags

assignment-managementlaravel-packagephpsubmission-notificationssubmission-systemsubmissionsvanilla-cssvanilla-jslaravelpackagecustomizablesubmissionstudent-management

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/al-rimi-submit/health.svg)

```
[![Health](https://phpackages.com/badges/al-rimi-submit/health.svg)](https://phpackages.com/packages/al-rimi-submit)
```

###  Alternatives

[laravel/scout

Laravel Scout provides a driver based solution to searching your Eloquent models.

1.7k49.4M479](/packages/laravel-scout)[spatie/laravel-enum

Laravel Enum support

3655.4M31](/packages/spatie-laravel-enum)[psalm/plugin-laravel

Psalm plugin for Laravel

3274.9M308](/packages/psalm-plugin-laravel)[laragear/preload

Effortlessly make a Preload script for your Laravel application.

119363.5k](/packages/laragear-preload)[illuminate/broadcasting

The Illuminate Broadcasting package.

7126.5M178](/packages/illuminate-broadcasting)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)