PHPackages                             cleaniquecoders/kickoff - 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. cleaniquecoders/kickoff

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

cleaniquecoders/kickoff
=======================

Helps configure your new Laravel project with good practices.

1.16.0(1mo ago)8232MITBladePHP ^8.3CI passing

Since Aug 2Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/cleaniquecoders/kickoff)[ Packagist](https://packagist.org/packages/cleaniquecoders/kickoff)[ RSS](/packages/cleaniquecoders-kickoff/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (40)Versions (50)Used By (0)

[![PHP Linting (Pint)](https://github.com/cleaniquecoders/laravel-starter/actions/workflows/lint.yml/badge.svg)](https://github.com/cleaniquecoders/laravel-starter/actions/workflows/lint.yml) [![Test](https://github.com/cleaniquecoders/laravel-starter/actions/workflows/run-tests.yml/badge.svg)](https://github.com/cleaniquecoders/laravel-starter/actions/workflows/run-tests.yml)

🚀 Kickoff
=========

[](#-kickoff)

This package bootstraps a **new Laravel project** with all the essential tools, configs, and workflows you need for a modern and maintainable setup.

[![Landing Page](assets/landing-hero.png)](assets/landing-hero.png)

🎯 Target Setup
--------------

[](#-target-setup)

Kickoff is designed for Laravel projects with this starter configuration:

```
laravel new myapp --git --livewire --pest --npm --livewire-class-components
```

**Includes:**

- ✅ Git repository initialization
- ✅ Livewire for reactive components
- ✅ Pest for testing
- ✅ NPM for asset management
- ✅ Livewire class-based components

The complete setup is based on [Project Template](https://github.com/nasrulhazim/project-template).

📥 Usage
-------

[](#-usage)

### Quick Start (Automatic Project Creation)

[](#quick-start-automatic-project-creation)

Kickoff can now automatically create a new Laravel project if one doesn't exist:

```
# 1. Install globally
composer global require cleaniquecoders/kickoff

# 2. Ensure Laravel installer is available
composer global require laravel/installer

# 3. Create and bootstrap in one command
kickoff start
```

**Complete Example:**

```
# Creates ./blog directory with a fresh Laravel project, then applies kickoff
kickoff start johndoe blog
cd blog
```

This automatically runs:

```
laravel new blog --git --livewire --pest --npm --livewire-class-components --no-interaction
```

### Usage with Existing Project

[](#usage-with-existing-project)

If you already have a Laravel project:

```
cd my-existing-project
kickoff start johndoe my-project .
```

Or specify the path:

```
kickoff start johndoe blog /path/to/existing/laravel
```

### Options

[](#options)

- `` - Your name or organization (required)
- `` - Project name (required)
- `` - Project directory (optional, defaults to `./`)

### What Happens

[](#what-happens)

```
📦 Creating new Laravel project blog...

⏳ Creating Laravel project with Livewire, Pest, and Git... ✅

🎉 Let's kickoff your johndoe/blog now!

⏳ Copy application stubs... ✅
⏳ Update composer.json... ✅
⏳ Update project files... ✅
⏳ Configure environment... ✅
⏳ Install packages... ✅
⏳ Build assets... ✅

🎉 Project setup completed successfully!
```

> ⚠️ **Warning**: Only run on fresh Laravel projects. Existing project files will be overwritten.

✨ Features
----------

[](#-features)

[![Features Overview](assets/landing-features.png)](assets/landing-features.png)

- 📦 Installs required Laravel packages:

    - [spatie/laravel-permission](https://spatie.be/docs/laravel-permission)
    - [spatie/laravel-medialibrary](https://spatie.be/docs/laravel-medialibrary)
    - [cleaniquecoders/traitify](https://github.com/cleaniquecoders/traitify)
    - [cleaniquecoders/laravel-media-secure](https://github.com/cleaniquecoders/laravel-media-secure)
    - [owen-it/laravel-auditing](https://laravel-auditing.com)
- 🛠 Dev tools:

    - [barryvdh/laravel-debugbar](https://github.com/barryvdh/laravel-debugbar)
    - [larastan/larastan](https://github.com/nunomaduro/larastan) for static analysis
    - [driftingly/rector-laravel](https://github.com/rectorphp/rector-laravel)
    - [pestphp/pest-plugin-arch](https://pestphp.com) for architecture testing
- ⚙️ Configuration:

    - Adds QA scripts to `composer.json`
    - Autoloads `support/helpers.php`
    - Creates `rector.php`, `phpstan.neon.dist`, and `pint.json`
- 📂 Project Structure:

    - `support/` for helpers
    - Refactored `routes/` into `web/`, `api/`, and `console/` subfolders (backups included)
    - `tinker/` with `.gitignore`
    - `docs/README.md` with a placeholder TOC
- 🛡️ Automation Scripts:

    - Creates executable scripts in `bin/` for tasks like backup, deployment, PHPStan reporting, dependency updates, and project install
    - All scripts use the current directory name as the project name
- ✅ Testing:

    - Generates `tests/Feature/ArchitectureTest.php` using Pest Arch
- 📝 Documentation:

    - Creates `CHANGELOG.md`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `SECURITY.md`, `SUPPORT.md`, and `LICENSE.md`
- ⚡ GitHub Actions Workflows:

    - Pint (Laravel Pint)
    - PHPStan
    - Rector
    - Tests (Pest)
    - Changelog updater
- 🔧 Artisan & Project Tasks:

    - Clears config and view caches
    - Runs migrations
    - Creates storage symlink
    - Publishes package configs and migrations
- 🛠️ Infrastructure Templates:

    - Sets up `.config/` with Nginx and Supervisor templates

📸 Screenshots
-------------

[](#-screenshots)

### Dashboard

[](#dashboard)

The generated project includes a fully-featured admin dashboard with user statistics, quick actions, and system information.

[![Dashboard](assets/dashboard.png)](assets/dashboard.png)

### Role & Permissions Management

[](#role--permissions-management)

Manage roles with granular permissions using Spatie Laravel Permission.

[![Role Permissions](assets/role-permissions.png)](assets/role-permissions.png)

### Settings Management

[](#settings-management)

Configure application settings through an intuitive admin interface.

[![Email Settings](assets/settings-email.png)](assets/settings-email.png)

🧪 Development & Testing
---------------------------

[](#-development--testing)

### For Contributors

[](#for-contributors)

Test your changes to kickoff using the sandbox script:

```
# Create fresh Laravel app and apply kickoff
bin/sandbox run

# Inspect the generated project
cd test-output/sandbox
# create a database in mysql named `sandbox`
```

Then create tables & seed data:

```
php artisan reload:db
```

Run the sandbox app:

```
npm run build
php artisan serve
```

To clean up sandbox, run:

```
bin/sandbox reset
```

**Sandbox Features:**

- ✅ Automated testing workflow (30 seconds vs 10 minutes manually)
- ✅ Git-safe (uses skip-worktree to prevent accidental commits)
- ✅ Repeatable testing cycles
- ✅ Isolated test environment

**Requirements:**

- Laravel installer: `composer global require laravel/installer`

See `bin/sandbox` for detailed usage and commands.

🛡️ Automation Scripts
---------------------

[](#️-automation-scripts)

- Creates executable scripts in `bin/` for common project tasks:

    - **backup-app**: Backup your application files
    - **backup-media**: Backup only media files changed in the last 24 hours
    - **build-fe-assets**: Build and commit frontend assets
    - **deploy**: Deploy code to your server with branch/tag support
    - **update-dependencies**: Update Composer and npm dependencies, audit and build assets
    - **reinstall-npm**: Remove and reinstall npm modules and lock file
    - **install**: Project initialization, database setup, and environment configuration
    - **phpstan**: Run PHPStan and generate readable reports per identifier
- All scripts use the current directory name as the project name for dynamic configuration.
- Scripts are made executable and can be run directly from the `bin/` directory.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

If you discover a security vulnerability within AirBox, please send an e-mail to Nasrul Hazim via . All security vulnerabilities will be promptly addressed.

Contributors
------------

[](#contributors)

[ ![project-template Contributors](https://camo.githubusercontent.com/e657e279a23017b672a3b195a08216c7053fac0323d155241a02b708ca875d62/68747470733a2f2f636f6e747269622e726f636b732f696d6167653f7265706f3d636c65616e69717565636f646572732f6b69636b6f6666)](https://github.com/cleaniquecoders/kickoff/graphs/contributors)License
-------

[](#license)

The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance99

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity64

Established project with proven stability

 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 ~5 days

Total

47

Last Release

39d ago

PHP version history (2 changes)1.1.0PHP ^8.2

1.4.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/b57069d0f4b634f65eccc6e5d5848990e25968d45ec2cf46d626c6a4658f944b?d=identicon)[nasrulhazim.m](/maintainers/nasrulhazim.m)

---

Top Contributors

[![nasrulhazim](https://avatars.githubusercontent.com/u/10341422?v=4)](https://github.com/nasrulhazim "nasrulhazim (239 commits)")

---

Tags

laravel

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/cleaniquecoders-kickoff/health.svg)

```
[![Health](https://phpackages.com/badges/cleaniquecoders-kickoff/health.svg)](https://phpackages.com/packages/cleaniquecoders-kickoff)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M681](/packages/barryvdh-laravel-ide-helper)[laravel/installer

Laravel application installer.

83610.7M20](/packages/laravel-installer)[yajra/laravel-datatables-oracle

jQuery DataTables API for Laravel

4.9k33.8M335](/packages/yajra-laravel-datatables-oracle)[tightenco/jigsaw

Simple static sites with Laravel's Blade.

2.2k438.5k29](/packages/tightenco-jigsaw)[laravel/vapor-cli

The Laravel Vapor CLI

31310.7M8](/packages/laravel-vapor-cli)[wnx/laravel-stats

Get insights about your Laravel Project

1.8k1.8M7](/packages/wnx-laravel-stats)

PHPackages © 2026

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