Documentation

  • Home
  • Documentation
SmartHR Agent Banner

Introduction

SmartHR – HR Management Admin Template is a HR management solution for automating and simplifying HR operations. SmartHR is a simple, intelligent, and user-friendly solution that offers many kinds of technology modules to help in automating your human resource practices.

Requirements

System Overview

The SmartHR template requires a modern Laravel development environment with PHP 8.3+ support, essential extensions, and development tools for optimal performance and development experience.

Core Technologies
Backend Framework

Laravel 12.54.0

Frontend Framework

Bootstrap 5.3.8

Programming Language

PHP 8.4

System Requirements
Composer

For PHP package dependency management

PHP Extensions

bcmath, ctype, fileinfo, json, mbstring, openssl, pdo, tokenizer, xml

Node.js

For Vite build process & SCSS compilation

Text Editor

VS Code, Sublime Text, or any code editor

Development Tools
Local Server

XAMPP/WAMP/MAMP

Version Control

Git

Web Browser

Any modern browser

Important Note

Ensure all PHP extensions are enabled in your server configuration. For production deployment, consider using a managed hosting service that supports Laravel 13.x and PHP 8.3+.

Features

SmartHR offers powerful admin template and modern interface.

Built-in Applications
  • Calendar
  • Chat
  • To Do
  • Notes
  • File Manager
  • Social Feed
  • Kanban
  • Email
  • Call
Layout Features
  • Creative Design
  • Fully Responsive
  • Color & Fonts is easily changed
  • W3C Validated Code
  • Build with Bootstrap v5.x used
  • Compatible Browsers: IE8+, Firefox, Safari, Opera, Chrome
  • Dark, Light with RTL Supported
  • Various Sidebar Colours
  • Multiple Layouts

File Structure

Project Overview

The Laravel project follows standard Laravel directory structure with the main application located in smarthr/laravel/. The application includes all standard Laravel directories for a complete application structure.

smarthr/
└── laravel/
    ├── app/
    │   ├── Http/
    │   │   ├── Controllers/
    │   │   └── Middleware/
    │   ├── Models/
    │   └── Providers/
    │
    ├── bootstrap/
    │   └── cache/
    │
    ├── config/
    │   ├── app.php
    │   ├── auth.php
    │   └── database.php
    │
    ├── database/
    │   ├── factories/
    │   ├── migrations/
    │   └── seeders/
    │
    ├── public/
    │   ├── index.php
    │   └── assets/
    │       ├── css/
    │       ├── fonts/
    │       ├── img/
    │       └── js/
    │
    ├── resources/
    │   ├── css/
    │   ├── js/
    │   ├── sass/
    │   └── views/
    │       ├── layouts/
    │       ├── partials/
    │       └── pages/
    │
    ├── routes/
    │   ├── web.php
    │   └── api.php
    │
    ├── storage/
    │   ├── app/
    │   ├── framework/
    │   └── logs/
    │
    ├── tests/
    │   └── Feature/
    │
    ├── artisan
    ├── composer.json
    ├── package.json
    └── vite.config.js

Laravel Structure

Laravel Blade Template Structure

SmartHR uses Laravel's Blade templating engine with a master layout file and individual page templates for consistent design and functionality. Below are the actual files from the project.

Main Layout File

This is the actual master layout file from the project that provides the common HTML structure, navigation, and scripts for all pages:

<!DOCTYPE html>
<html lang="en">

<head>
    @include('partials.head-css')
    @include('partials.title-meta')
</head>

<body>
    @include('partials.main-wrapper')
        
        @include('partials.topbar')

        @yield('content')

        @include('partials.footer')

    </div>
    <!-- /Main Wrapper -->

    @component('components.modal-popup')
    @endcomponent

@include('partials.vendor-scripts')

</body>
</html>
Sample Page Template

This is the actual starter page template from the project that extends the main layout:

<?php $page = 'blank-page'; ?>
@extends('layout.mainlayout')
@section('content')

    <!-- ========================
        Start Page Content
    ========================= -->

    <div class="page-wrapper">

        <!-- Start Content -->
        <div class="content">

            <!-- Page Header -->
            <div class="d-flex align-items-center justify-content-between gap-2 mb-4 flex-wrap">
                <div>
                    <h4 class="mb-0">Blank Page</h4>
                </div>
                <div class="gap-2 d-flex align-items-center flex-wrap">
                    <a href="javascript:void(0);" class="btn btn-icon btn-outline-light shadow" data-bs-toggle="tooltip" data-bs-placement="top" aria-label="Refresh" data-bs-original-title="Refresh"><i class="ti ti-refresh"></i></a>
                    <a href="javascript:void(0);" class="btn btn-icon btn-outline-light shadow" data-bs-toggle="tooltip" data-bs-placement="top" aria-label="Collapse" data-bs-original-title="Collapse" id="collapse-header"><i class="ti ti-transition-top"></i></a>
                </div>
            </div>
            <!-- End Page Header -->

        </div>
        <!-- End Content -->

        @component('components.footer')
        @endcomponent

    </div>

    <!-- ========================
        End Page Content
    ========================= -->

@endsection
Key Blade Template Features
Template Inheritance

@extends directive for master layout structure

Content Sections

@section and @yield for dynamic content injection

Partial Includes

@include directive for reusable partials (topbar, sidebar, footer)

Route Conditions

@if Route::is() for conditional layout rendering

Component System

@component directive for modal popup components

PHP Variables

PHP variables for page identification and routing

Installation

Laravel Framework Setup

Follow these steps to set up SmartHR Laravel application on your local development environment. This guide covers Laravel-specific installation, environment configuration, and project setup.

Prerequisites
Composer
MySQL/SQLite
Web Server (Apache/Nginx)
Tip: Use XAMPP, WAMP, or MAMP for local development
Installation Steps
1
Project Setup

Extract the SmartHR Laravel project to your web server directory:

XAMPP: htdocs/smarthr/laravel/
WAMP: www/smarthr/laravel/
2
Install PHP Dependencies

Open terminal/command prompt in the Laravel project directory and run:

composer install
Note: Ensure Composer is installed on your system
3
Install Node.js Dependencies

Install frontend dependencies for SCSS compilation:

npm install
Note: Ensure Node.js and npm are installed on your system
4
Environment Configuration

Configure your Laravel environment:

cp .env.example .env
php artisan key:generate
Configure: Update database settings in .env file
5
Database Setup

Set up your database and run migrations:

php artisan migrate
6
Build Frontend Assets

Compile SCSS and build frontend assets:

npm run build
7
Access Application

Start your web server and access the Laravel application:

php artisan serve
Example URLs:
Artisan Server: http://127.0.0.1:8000
Live Server: yourdomain.com/laravel/public

Fonts

The default font is Inter. To change the font:

Update the @import URL and the --font-family-primary variable in style.css: 

// Font
@import url('https://fonts.googleapis.com/css2?family=Noto+Sans:ital,wght@0,100..900;1,100..900&display=swap');


	body {
		font-family: "Noto Sans", sans-serif;
	}

Color System

The design token variables are defined in the @theme block of your CSS file. Here are the primary color tokens:

Background Color Change

You can change the header background color in style.css as per your wish


	.header {
		background: #fff;
		left: 0;
		position: fixed;
		right: 0;
		top: 0;
		height: 60px;
	}

Dark Mode

How it Works

Dark mode is controlled by a theme attribute/class on the root element. When activated, all design tokens are overridden to dark variants.

The theme is controlled by the data-theme attribute on the <html> element:

<html lang="en" data-theme="dark">

Dark mode styles are defined in the [data-theme=dark] block in style.css:

[data-theme=dark] {
	--color-dark: #D8DDDF;
	--color-light: #19222E;
	--color-white: #0B0D0E;
}

RTL Support

To enable Right-to-Left (RTL) layout, add the dir="rtl" attribute to the <html> tag:

<html lang="en" dir="rtl">

Tailwind CSS handles RTL layout transformations automatically when the dir attribute is set. All margin, padding, and positioning utilities adapt to the RTL direction.

RTL Demo

An RTL demo page is available at layout-rtl.blade.php in the HTML version for reference.

Icons

Use Tabler Icons with specific class


	<!DOCTYPE html>
	<html lang="en">
		<head>
            <!-- Tabler Icon CSS -->
            <link rel="stylesheet" href="{{URL::asset('build/plugins/tabler-icons/tabler-icons.min.css')}}">
		</head>
	</html>



	<i class="ti ti-dashboard"></i>
	<i class="ti ti-stethoscope"></i>
	<i class="ti ti-chart-pie-3"></i>

Layout Options

SmartHR offers multiple layout options to suit different application needs. Each layout can be combined with light or dark mode.

Default Layout

The default layout features a full vertical sidebar on the left, a horizontal topbar at the top, and the main content area. This is the standard layout used across all dashboard pages.

  • Full-width sidebar with navigation menu, logo, and user profile
  • Top header with search, notifications, and user actions
  • Responsive - sidebar collapses to overlay on mobile devices

Mini Sidebar

The mini sidebar layout collapses the sidebar to show only icons, providing more space for the main content area. Users can toggle between expanded and collapsed states using the sidebar toggle button.

  • Collapsed sidebar showing only menu icons
  • Hover to expand and reveal full menu text
  • Toggle via the hamburger button in the topbar

Two-Column Layout

The two-column layout features a primary icon bar and a secondary navigation panel. This layout is ideal for applications with deep menu hierarchies.

  • Primary column with category icons
  • Secondary column with detailed sub-navigation
  • See layout-two-column.blade.php for a working demo

License

SmartHR is developed by Dreams Technologies and is available under both Envato Extended & Regular License options.

Regular License

Usage by either yourself or a single client is permitted for a single end product, provided that end users are not subject to any charges.

Extended License

For use by you or one client in a single end product for which end users may be charged.

What are the main differences between the Regular License and the Extended License?

Note

If you operate as a freelancer or agency, you have the option to acquire the Extended License, which permits you to utilize the item across multiple projects on behalf of your clients.

Credits

NAME URL
Bootstrap https://getbootstrap.com/docs/
jQuery https://jquery.com/
Fontawesome https://fontawesome.com/
Select2 https://github.com/select2/select2
Date Timepicker https://cdnjs.com/libraries/jquery-datetimepicker
Google Fonts https://fonts.google.com/
Fancy Box http://fancybox.net/
Moment JS https://momentjs.com/
theia-sticky-sidebar https://github.com/WeCodePixels/theia-sticky-sidebar
Range-Slider https://ionicframework.com/docs/api/range

Support

Need Support?

If this documentation does not address your questions, please feel free to contact us via email at support@dreamstechnologies.com

Reach the team at GMT+5:30. Typical reply within 12–24 hours on weekdays — rarely up to 48 hrs during holidays. Support is available to verified buyers for template-related issues.

Contact Support

Important Note : We strive to offer top-notch support, but it's only available to verified buyers and for template-related issues such as bugs and errors. Custom changes and third-party module setups are not covered.

Custom Work

Do you need a customized application for your business?

If you need a customized application for your business depends on your specific requirements and goals, Please contact us. Customization can be the key to success, ensuring your project perfectly aligns with your unique goals and requirements.

Don't Miss Out on the Benefits of Customization!

Unlock the potential of your project. It's time to ensure your project isn't another cookie-cutter solution but truly unique and effective one.

Discover how customization can make a difference in your project's success. Let's create a solution that's as unique as your vision!

We'll tailor the application to meet your specific needs and preferences.

We will upload your website to the server and ensure it is live.

Book an Appointment Get a Free Quote
thanks

Thank You

Thank you once again for downloading SmartHR.
We hope you're enjoying your experience, and we kindly request that you take a moment to share your valuable review and rating with us.

Review Link