2017 © Pedro Peláez
 

library laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

image

atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  • Monday, October 9, 2017
  • by atomescrochus
  • Repository
  • 5 Watchers
  • 32 Stars
  • 867 Installations
  • HTML
  • 0 Dependents
  • 0 Suggesters
  • 4 Forks
  • 0 Open issues
  • 12 Versions
  • 7 % Grown

The README.md

Bulma template starter kit for Laravel

A quick replacement for Laravel's basic templates, built with Bulma. It requires Laravel >= 5.4., (*1)

Total Downloads, (*2)

Install

Via Composer, (*3)

``` bash $ composer require atomescrochus/laravel-bulma-starter, (*4)


Then you have to install the package' service provider, _unless you are running Laravel >=5.5_ (it'll use package auto-discovery). : ```php // config/app.php 'providers' => [ ... Atomescrochus\LaravelBulmaStarter\LaravelBulmaStarterServiceProvider::class, ];

Then, follow theses simple steps:, (*5)

  1. Add "bulma": "^0.3.1" to your package.json file;
  2. Run npm update
  3. (If you don't want to use Bootstrap anymore) Remove, or comment out the reference to sass_bootstrap and variables in your resources/assets/sass/app.scss file and from resources/assets/js/bootstrap.js.
  4. Add @import "node_modules/bulma/bulma"; to the resources/assets/sass/app.scss file
  5. Run npm run [your-choice-of-env] (the template files max uses of the mix() helper)

Usage

Publish the package's view files

If you want to take a peak at the code, you can publish the package's files using:, (*6)

php artisan vendor:publish --provider="Atomescrochus\LaravelBulmaStarter\LaravelBulmaStarterServiceProvider" --tag="views"

You'll find them in resources/views/vendor/laravel-bulma-starter., (*7)

Replace Laravel default files

If I wanted to replace the welcome.blade.php to the one provided in the package, I would just open the one provided with Laravel, and replace its content by @include('laravel-bulma-starter::welcome'). For the auth.login view, I'd use @include('laravel-bulma-starter::auth.login'), and so on., (*8)

Using the package default template by yourself

Just create a new blade file and extend it with @extends('laravel-bulma-starter::layouts.bulma')., (*9)

You can pass content to this layout file using, (*10)

@section('content')
Some content.
@endsection

You can add elements to the top right menu as such, (*11)

@push('right-nav-menu')
    <a class="nav-item is-tab" href="{{ url('/some-link') }}">A menu item</a>
    <a class="nav-item is-tab" href="{{ url('/some-other-link') }}">Another menu item</a>
@endpush

If you need to add other scripts, or stylesheets, you can use some additionnal stacks (scripts-before, scripts-after, styles-before and styles-after) like so, (*12)

@push('scripts-before')
     
    <!-- You still have to use the <script> tags here. -->
@endpush

@push('styles-before')
     
    <!-- You still have to use the <link> tags here. -->
@endpush

Error display component

The only real difference between this packages' views and Laravel's default, beside using Bulma, is that I use a custom component for errors. It can be used as such:, (*13)

// if using it in a "horizontal form"
@include('laravel-bulma-starter::components.forms-errors', ['field' => 'nameOfField', 'type' => 'horizontal'])

// or if in a regular form, just omit the type
@include('laravel-bulma-starter::components.forms-errors', ['field' => 'nameOfField'])

Of course, you are in now way forced to use the components outisde this package's views, but I find it really useful so give it a try!, (*14)

Change log

Please see CHANGELOG for more information on what has changed recently., (*15)

Contributing

Please see CONTRIBUTING and CONDUCT for details., (*16)

Security

If you discover any security related issues, please email jp@atomescroch.us instead of using the issue tracker., (*17)

Credits

License

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

The Versions

09/10 2017

dev-master

9999999-dev https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

09/10 2017

dev-develop

dev-develop https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

09/10 2017

2.1.1

2.1.1.0 https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

18/09 2017

2.1.0

2.1.0.0 https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

05/02 2017

2.0.2

2.0.2.0 https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

03/02 2017

2.0.1

2.0.1.0 https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

03/02 2017

2.0.0

2.0.0.0 https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

03/02 2017

1.0.4

1.0.4.0 https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

01/02 2017

1.0.3

1.0.3.0 https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

31/01 2017

1.0.2

1.0.2.0 https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

31/01 2017

1.0.1

1.0.1.0 https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter

31/01 2017

1.0.0

1.0.0.0 https://github.com/atomescrochus/laravel-bulma-starter

A quick replacement for Laravel's basic templates, built with Bulma

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel atomescrochus bulma laravel-bulma-starter