bradleyrmartin/laravel-init

A Laravel scaffolding package that publishes opinionated starter files into your application.

1.0.4 2026-03-21 10:23 UTC

Requires

• php: ^8.3
• illuminate/console: ^13.0
• illuminate/support: ^13.0
• propaganistas/laravel-phone: ^6.0

Requires (Dev)

• orchestra/testbench: ^11.0
• pestphp/pest: ^4.4.1
• pestphp/pest-plugin-laravel: ^4.1

MIT

• Bradley R. Martin

README

A Laravel scaffolding package that publishes opinionated starter files into your application.

Requires: Laravel 13+ · PHP 8.3+

Installation

composer require bradleyrmartin/laravel-init

The service provider is auto-discovered by Laravel.

Publishing Assets

Publish all assets at once:

php artisan laravel-init:publish

Or publish a specific group:

Tag	What it publishes
laravel-init	Everything
laravel-init-controllers	app/Http/Controllers/Controller.php
laravel-init-cursor	.cursor/rules/ Cursor AI rules

# Publish controllers only
php artisan laravel-init:publish --tag=laravel-init-controllers

# Publish Cursor rules only
php artisan laravel-init:publish --tag=laravel-init-cursor

# Force overwrite existing files
php artisan laravel-init:publish --force

You can also use the standard Laravel vendor:publish command directly:

php artisan vendor:publish --provider="BradleyRMartin\LaravelInit\LaravelInitServiceProvider" --tag=laravel-init

Published Files

app/
└── Http/
    └── Controllers/
        └── Controller.php

.cursor/
└── rules/
    └── laravel.mdc

Development

Branches

Branch	Purpose
main	Stable, Packagist-published code
next	Active development — all PRs target this branch

Workflow

1. Create a feature branch off next
2. Open a PR targeting next — tests run automatically
3. Merge the PR into next
4. When ready to release, create a GitHub Release with a semver tag (e.g. v1.2.0)
5. The release workflow will automatically:
   • Bump package.json to the release version
   • Commit the bump to next
   • Merge next into main
   • Notify Packagist to pull the latest main

Required GitHub Secrets

Secret	Description
RELEASE_TOKEN	A GitHub Personal Access Token with repo scope (needed to push and merge branches)
PACKAGIST_TOKEN	Your Packagist API token (username bradleyrmartin is hardcoded in the workflow)

Running Tests Locally

composer install
./vendor/bin/pest

License

MIT