ridrog/boilerplate

Boilerplate for Laravel Packages

1.0.0 2019-10-20 11:33 UTC

This package is auto-updated.

Last update: 2024-11-20 23:04:03 UTC


README

How to use this laravel package boilerplate

Setup

Step 1
Clone or download this Repository into a laravel installtion.

Step 2

  • Rename all Files from "BoilplateXxxxx.php" to "YourPackageNameXxxxx.php"
  • Search and Replace "Boilerplate" with "YourPackageName" (case sensitive!)
  • Search and Replace "boilerplate" with "yourpackagename" (case sensitive!)
  • Replace the name in the LICENSE File

Step 3

  • Use your terminal to cd to the root of this package
  • Run composer install
  • Run the tests composer test

Step 4

  • Add the namespace and the path to the composer.json File of your laravel installation
"autoload": {
    "classmap": [
        "database/seeds",
        "database/factories"
        ],
    "psr-4": {
        "App\\": "app/",
        "{Vendor}\\{{PackageName}}\\": "packages/{vendor}/{packagename}/src/
    }
},
  • Add the Service Provider to config/app.php

Development

  1. Update all the readme /docs files
    Delete what you don't need
    You also need to delete links from \docs\index.md to the not used/deleted files in \docs\details

  2. Develop the package

Publish

  1. Create a Github repository for your package
  2. Push the package to github
  3. Bonus: Enable Github Pages in the settings of the repository
  4. Generate a Release
  5. Add the package to packagist
  6. Bonus: Add the github repository to travis to run test on every change that is pushed to the repository
  7. Delete this section
  8. DONE

Build Status Latest Stable Version Total Downloads Latest Unstable Version License

Full Documentation

What is this

Installation

Usage

Config

Details

Facade

Routes

Controllers

Views

Middleware

Migrations

Seeder

Commands

Translation

Events and Listeners

Notifications

Tests

Change log

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email mail@ridrog.de instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.