codificar/scaffolder

Laravel scaffolder

1.0 2018-06-19 20:19 UTC

This package is not auto-updated.

Last update: 2024-10-26 19:21:34 UTC


README

Scaffolder for laravel Software license Quality score Laravel version Waffle board

Remove the headache of creating over and over again the base code for most of your projects. Scaffolder is tailored following the principle that the development process must be a happy thing so, code and enjoy ! You are free to extend it the way you need. This package only generate things that you need to start, always keeping the code clean and abstract. Are you hungry ? Fork it !

Installation

  1. Get laravel up and running

  2. Add the following packages to your composer.json

    "laravelcollective/html": "5.1.*",
    "yajra/laravel-datatables-oracle": "~5.0",
    "codificar/scaffolder-theme-material": "dev-master",
    "codificar/scaffolder": "dev-master",
  3. Update your packages

    composer update
  4. Add the service providers to the providers array in {laravel-root}\config\app.php

    ScaffolderTheme\ScaffolderThemeServiceProvider::class,
    Scaffolder\ScaffolderServiceProvider::class,
    yajra\Datatables\DatatablesServiceProvider::class,
  5. Add the following aliases in {laravel-root}\config\app.php

    'Form'       => Collective\Html\FormFacade::class,
    'Html'       => Collective\Html\HtmlFacade::class,
    'Datatables' => yajra\Datatables\Datatables::class,

Getting started

First you need to publish the configuration files and assets

./artisan vendor:publish --provider="Scaffolder\ScaffolderServiceProvider"
./artisan vendor:publish --provider="ScaffolderTheme\ScaffolderThemeServiceProvider" --force

Here we are using the theme codificar/scaffolder-theme-material, but you can fork it, and do whatever you want/need :)

At this point, you already can start to scaffold things. You have two ways to use the package.

Command line way (Hardcore devs)

When you execute the artisan publish command, the service provider creates the folder {laravel-root}\scaffolder-config that has the following structure:

- scaffolder-config
-- app.json
-- models
-- cache

The app.json file contains global settings, also you will get some demo files for models. All you need to scaffold an application is to edit the app.json file, and create the json files for the models you want. After you have all the files ready, you have the following commands:

This command generate the application using the files that you have provided.

./artisan scaffolder:generate

For instance, when you update the package, you should clear the cache files stored in {laravel-root}\scaffolder-config\cache

./artisan scaffolder:cache:clear
User interface way (Lazy devs)

All you need to do, is go to your http://{crazyhost}/scaffolder/generator and fill some inputs :)

Next steps

Check out the wiki to get more information about things that you need to know

Contributing

Just let me know your ideas and let's work together

License

The scaffolder package is licensed under the MIT license