DEV Community

Cover image for How to use Blade UI Icons in your Laravel Project
Adams Adebayo
Adams Adebayo

Posted on

How to use Blade UI Icons in your Laravel Project

From communicating information to guiding users on how to perform actions on our websites or apps, icons have been a key part of the digital world. And as a developer, there's no doubt you have to use icons as you develop solutions that make life easier for your users.
__

What is Blade Icons?

As a Laravel developer you are probably familiar with Blade as the templating engine for the Laravel framework.

So what is Blade Icons? Blade Icons is a package that allows you to make use of up to 70,000+ SVG icons inside your Blade templates. And in this tutorial, I am going to show you how to add it to your Laravel app and also how to install different icon sets that are supported.

Create a Laravel project

If you already have an existing Laravel project, you can skip to the next heading, if not, you can follow along. In order to create a Laravel project, we need to have PHP and Composer installed, Once you have those installed, run the following command to create a new Laravel project:

composer create-project laravel/laravel insert-your-project-name
Enter fullscreen mode Exit fullscreen mode

That is going to create a fresh Laravel application in a folder named insert-your-project-name, after that is done, change your directory to insert-your-project-name using:

cd insert-your-project-name
Enter fullscreen mode Exit fullscreen mode

Once you're in that directory, open the application in any code editor of your choice, then run the following command to run your application:

php artisan serve
Enter fullscreen mode Exit fullscreen mode

If all the steps are completed successfully you should see a message that contains a link to your application like this in your command line:

artisan serve result

Click or copy and paste the localhost URL into the browser of your choice to confirm that your application is running successfully:

base website

Install Blade Icons package

Once you have the Laravel application up and running, you need to install the Blade Icons package in order to be able to use it, and you do so by running the following command using Composer:

composer require blade-ui-kit/blade-icons
Enter fullscreen mode Exit fullscreen mode

This will install the default icon set for you, and also publish the vendor configuration, Next, you need to define the path for the icon, you can do this by creating a folder named svg inside the resources folder, so you'll have resources/svg, as your SVG icons will be placed in that directory.

After that, go to your ./vendor/blade-ui-kit/config/blade-icons.php file and uncomment the default array as seen below:

blade icon config

Install and use icon packages

After the above steps have been completed, head over to Blade Icons' third party icon set packages list on their Github repo and select your preferred one, I'll be using Blade Carbon Icons package by Swapnil Sarwe, run the following command to install the package:

composer require codeat3/blade-carbon-icons
Enter fullscreen mode Exit fullscreen mode

After that is done, you can start using the Blade Carbon Icons full list of icons here in your Blade template as shown below:

<h1>This is an apple: <x-carbon-apple/></h1>
Enter fullscreen mode Exit fullscreen mode

Now, run your app and you should see the below screen:

end result

Or with styling like so:

<x-carbon-apple style="color: green"/>
Enter fullscreen mode Exit fullscreen mode

or with classes:

 <x-carbon-apple class="h-6 w-9"/>
Enter fullscreen mode Exit fullscreen mode

More configuration can be done to the package inside the ./vendor/codeat3/blade-carbon-icons/config/blade-carbon-icons.php file.

Conclusion

And that's it! you have successfully added and used the Blade Icons package in your Laravel application.

I'll greatly appreciate your feedback. 👍

Top comments (1)

Collapse
 
benmcm1994_71 profile image
Benjamin McMullan

You shouldn't edit the vendor files. You should be editing the blade-icons.php in your config folder.