# Build Notes

###### Showcasing the latest build notes and changes with each iteration of the template.

#### SmartAdmin v5 Upgrade

This release is a complete overhaul of SmartAdmin, rebuilt entirely from the ground up to take full advantage of Bootstrap 5. Unlike a simple version upgrade, this is a new template that eliminates legacy dependencies, modernizes the codebase, and enhances performance across the board.

One of the biggest changes is the removal of jQuery, making the template leaner, faster, and fully aligned with modern web development standards. The entire JavaScript structure has been rewritten to be vanilla JS-based, improving maintainability and reducing unnecessary dependencies. Additionally, Bootstrap 5 introduces a more flexible grid system, improved utility classes, and better handling of responsive design, all of which have been incorporated into this rebuild.

All components, layouts, and UI elements have been redesigned to reflect the latest trends while ensuring compatibility with Bootstrap 5 standards. The removal of outdated plugins and refactoring of existing features result in a cleaner, more efficient template. Furthermore, accessibility and usability improvements have been a major focus, ensuring a better experience for all users.

Since this is a full rewrite, it is not backward-compatible with previous versions of SmartAdmin. Developers upgrading from SmartAdmin v4 will need to adjust their custom implementations accordingly. However, this new version sets the foundation for easier future updates, better scalability, and long-term stability.

Thank you for your support, and we hope you enjoy the new and improved SmartAdmin v5!

#### Update v5.5.0 New Framework Versions Added

- ANGULAR Seed Version – Minimal Angular setup with routing, SCSS, and modular components to start projects quickly.
- RUBY ON RAILS Seed + Full – Rails 7 integration with ERB layouts, authentication starter, and dashboard pages.
- SPRING BOOT Seed + Full – Java-based starter with controllers, services, and Thymeleaf templates for rapid development.

#### Update v5.4.0 New Seed Versions Added

- REACT Seed Version – Lightweight starter with routing, layout shell, SCSS variables, and example components to kickstart development.
- NEXT.JS Seed Version – App Router setup with layout, theming, ESLint/Prettier, and example pages optimized for fast builds.

#### Update v5.3.0 Seed & Full Versions Added

- ASP.NET CORE 9.x Seed + Full – Seed for clean start; Full with auth-ready pages, controllers, and sample services.
- ASP.NET Core MVC Seed + Full – Seed with MVC areas & layouts; Full with CRUD samples and helpers.
- SYMFONY Seed + Full – Seed with Twig layouts; Full with controllers, forms, and entities.
- CODEIGNITER Seed + Full – Seed app structure; Full with modules, examples, and services.
- CAKEPHP Seed + Full – Seed skeleton; Full with bake-generated CRUD and themed templates.
- FLASK Seed + Full – Seed with Blueprints; Full with auth, views, and sample APIs.
- NODE.JS Seed + Full – Seed (EJS) templating; Full with Express routes, middleware, and examples.

#### Build v5.2.0 Enhanced Features and Accessibility. Take a backup of your old version folder

- GULP Complete Revamp – Fully updated Gulp file for faster runtime, smooth execution, and improved automation.
- HTML Complete Revamp – Major HTML restructure: migrated from `.ejs` to `.html`, reorganized folders, and updated all HTML pages.
- JS Complete Revamp – Fully restructured JavaScript folder. Moved external scripts into `scripts/pages` for better organization.
- UI/UX Design & Accessibility Improvements – Updated overall font family to 'Public Sans' for improved readability, enhanced color contrast for accessibility, and refined layout for a cleaner, modern look across the app.
- NEW Plugins Updated & Configuration Added – Upgraded all project plugins to latest versions for improved performance and security. Added plugin file and configuration control to streamline management and customization.

#### Build v5.1.0 Major Update with New Features and Improvements

- NEW 4 New Dashboard Examples – Introduced fresh dashboard templates to cover more use cases and design needs.
- FIX v1.2.7 Released – Added Add/Edit/Delete features, UI improvements, and resolved known bugs.
- NEW ApexChart Integration – Integrated ApexCharts with a custom SmartAdmin wrapper for cleaner and reusable chart modules.
- NEW ES6 Module Conversion – Migrated East Pie Chart and Peity Chart libraries to modern ES6 modules for better performance and maintainability.
- NEW FullCalendar Integration – Added FullCalendar with SmartAdmin custom wrapper for seamless calendar views and event management.
- NEW In-house Plugin: Steamline Charts – Introduced a lightweight custom chart plugin for streamlined data visualization.
- NEW New Themes Added – Introduced additional pre-configured themes to improve UI customization options.
- DOCS Documentation Updated – Refreshed and expanded developer documentation for easier onboarding and clearer guidance.
- NEW Vector Maps – Integrated new vector maps for better geographic visualization.

#### Build v 5.0.3 Enhanced Features and Accessibility

- JS SmartTables.js v1.2.1
  Added a robust `initializeBootstrapComponents` method that:
  - Initializes Bootstrap 5 components via the native Bootstrap JavaScript API.
  - Handles fallback to jQuery-based Bootstrap (older versions).
  - Includes support for popovers, tooltips, and dropdowns.
  - Includes proper error handling.
  - Emits custom events for third-party code to hook into.
  - Provides a hook for developers to run custom code when rows are expanded.
  Integrated this method with expanded rows in three key places:
  - In `updateExpandedRow` for both local and server-side data.
  - In `updateExpandedRowsAfterResize` for server-side data specifically.
  - Added an extra safeguard in `setupResponsiveRows` with a `setTimeout` to ensure initialization occurs.
  - Added detailed debugging via the SmartTables logger to help troubleshoot any issues.
  - Fixed issue with fuzzy match bug from the last update, added a router to decide which search algorithm to use based on data source.
- SCSS SmartTables.js v1.2.1 - Enhanced responsive design: expanded buttons are more focused, and table hover effects are more UX-focused.
- DOM SmartTables.js v1.2.1 -Added print button for SmartTables.
- *HBS Added Search Page with full image Search & Image view functionality.
- *HBS Added Forum Page with interactive elements for compose and reply.
- SCSS Added `.set-high-contrast`beta mode and `.color-blind` mode.
- SCSS Added a proper table hover css for both general tables and SmartTables (handles expanded rows).
- FIX Fixed calendar table.
- FIX No more broken images in profile page!
- DOM Added search input box for mobile (check this in mobile view).
- SCSS Many other CSS fixes and improvements.

#### Build v 5.0.2 ST v1.2.0 & More... Minor Update

- NEW Disabled sortable panel for mobile by default for improved performance.
- NEW Theme color has been normalized.
- NEW Improved ARIA accessibility (100% score on Lighthouse) with enhanced ARIA attributes.
- FIX Updated reset function to include dark mode reset to light.
- BS5 Updated display utility page to Bootstrap 5.
- FIX Moved navigation ARIA attributes to elements.
- FIX Fixed data attribute error for data-actions.
- NEW Added favicons.
- FIX Fixed link color in dark mode.
- FIX Fixed sanitize bug for data-action.
- FIX Fixed dark navigation color issues.
- NEW Normalized colors for consistent design.
- FIX Organized nav.scss for better maintainability.
- FIX Cleaned up StackGenerator interface.
- FIX Fixed fuzzy search demo.
- NEW Added StackLibrary page.
- FIX Bug fix for StackGenerator.
- FIX Updated panel styles to reflect overall style consistency.
- NEW Added loading spinner to SmartTable for server fetch.
- NEW Added Server Calls Page with mock-server.php for simulated server calls.
- FIX Updated SmartTable page examples with various tricks and tips.
- PLUG SmartTables - Enhanced functionality and performance.
  - Added caching and prefetching for next page.
  - Introduced callhooks, server-side AJAX methods, and Abort Controller.
  - Improved alerts for invalid data formats.
  - Revamped Load Ajax, Process Data, and Draw methods.
  - Added method to handle hanging AJAX requests.

#### Build v 5.0.1 Seed Project Stable Minor Update

- FIX Fixed all reported bugs.
- BS5 Added missing Bootstrap 5 elements and utilities.
- NEW Added new utility classes.
- NEW Added new Visibility Generator page for creating responsive visibility classes.
- PLUG SmartTables.js - Rebuilt with ES6 modules and moved out of beta. Fixed all bugs and quirks for a smoother, more reliable experience.
  - Added new export options: Excel, CSV, Copy, PDF, JSON, XML, and HTML.
  - Enhanced stability and performance with ES6 module architecture.
- NEW Added new pages for SmartTables settings and plugins.
- NEW Added new Table Style Generator.
- NEW Added new User Profile page with edit and add options.
- NEW Added new System Mail page with send, read, and compose views.
- NEW Added new Messenger & Chat page.
- NEW Implemented proper dark mode support.
- NEW Added new side panels component.
- NEW Added Blank Page Template, check index.html for more details.
- NEW Added new User Contact page with a fully functional notes app and filter option.
- FIX Resolved SCSS bugs.
- FIX Cleaned up the design for a more polished user interface.
- JS Cleaned up and debugged JavaScript for improved performance and reliability.
- FIX Fixed responsive design issues for better cross-device compatibility.
- PLUG SmartApp.js - Added new functions to enhance UI management.
  - Introduced new utility functions for dynamic interactions.
  - Optimized for performance and modularity.

#### Build v 5.0.0 Seed Project Major Update

- *HBS Added brand new Stack Generator page, create your own custom icons with multi-layer drag and drop support.
- JS Icon search has been improved significantly.
  - Users can now search for icons with a fuzzy search algorithm.
  - The search results are now cached for faster performance.
  - Added search hints, search history, and made it easier to switch between icon sets.
  - Clicking on the searched icon will copy the icon name to the clipboard.
  - SVG Icons can be customized before copying to the clipboard.
- PNL Panel Component has been completely reworked, it is now more flexible and easier to use.
- FICN Added SVG Icon sets that uses SVG Sprites for optimal performance. Can customize thickness, fill and stroke colors.
- DEL Removed the dependency on jQuery, and all jquery based plugins.
- DOM App was redisigned from the ground up to be more efficient and adapt to the latest technologies.
- BUILD Revamped the build process to be more efficient and easier to maintain.
- *EJS Switched to EJS for templating for better performance and more features.
- Tech Migrated all base pages to EJS with upto date codes and latest features for BS5.
- PLUG SmartNavigation.js - Built with vanilla JavaScript, ensuring a lightweight and fast navigation experience.
- PLUG SmartApp.js - Built a fully modular ES5 framework for managing UI interactions without jQuery.
  - Modular JS framework for UI without jQuery, managing themes, panels, and sounds.
  - Optimized event delegation and caching for scalable DOM interactions.
  - Security: Strict input validation, fullscreen protection, and minimized event leaks.
  - Performance: Efficient caching, debounced events, and optimized panel management.
  - Tech: Enhanced with new CSS, EJS templates, and robust layout system.
- PLUG SmartFilter.js - Built a fuzzy search algorithm plugin in ES5 with a dynamic ranking system and other powerful features.
  - Lightweight vanilla JS for fast navigation, using WeakMap for memory efficiency.
  - Secure caching, event delegation, and fuzzy search with pre-indexed text nodes.
  - Security: Rate limiting, sanitized inputs, and error recovery.
  - Performance: Debounced inputs, efficient string matching, and automatic cache clearing.
- PLUG SmartSlimScroll.js - Rebuilt from the ground up using ES5, updated security, and improved performance.
  - Core Functionality: Custom Scrollbar, Vanilla JavaScript, Bootstrap 5 Compatibility
  - Key Features: Customizable Options (width, height, color, speed, etc), Touch Support, Drag-and-Drop Scrolling, Event Handling.
  - Performance Optimizations: Event Throttling, Passive Event Listeners, Intersection Observer, WeakMap for State Management.
  - Security Features: Input Sanitization (for width/height etc), Bounds Checking, Protected Against XSS.
  - Memory Management: WeakMap Usage, Cleanup with `Destroy`, Event Listener Cleanup.
  - Error Handling: Try-Catch Blocks, Graceful Degradation, Improved Logging.
  - Modern JavaScript Features: ES6+ Syntax, Optional Chaining, Modern DOM APIs.
- PLUG SmartTables.js Beta - Built a fully modular ES5 robust plugin for table data management, sorting, export, import, and various API features.
  - Key Features: Sorting, Filtering, Export, Import, Pagination, Responsive Design (using resizeObserver), Loading States, Cutomization options and plugin extension with a robust API.
  - Performance Optimizations: Debouncing, Caching, Memory Management, Efficient DOM Operations (requestAnimationFrame).
  - Security Features: Sanitized Inputs, Rate Limiting, Error Handling, and more.
  - Extensibility and Hooks: Customizable templates, hooks for additional features, and a robust API for plugin extension.
  - Responsive Design: Using resizeObserver for optimal performance.
  - Customization: Extensible API, Configuration Options, and Plugin Extension.
  - Data Handling: Multiple Data Sources, Column Management, Type Detection.
- PLUG Sortable.js - Integrated with SmartApp.js to manage panel drag and drop, and other powerful features.

#### Build v 4.6.0 Improvements, bug fixes, plugin updates, and more...

- SCSS Fixed all reported and discovered CSS bugs.
- PCKG Updated latest sass library builder.
- PCKG Fixed all build errors for gulp build, you should now be able to use the latest version of node. Please ignore any deprecated warnings as it will be fixed in a future update.
- *HBS Added new Subscription Dashboard
- MISC Added quick change icon (see top right) for Dark Mode, Light Mode, and Default Mode
- JS Fixed responsive data bug for Datatables, you can now use pagination without breaking the responsive dropdown.
- PLUG Added new plugin for File Manager (beta) - it may be a little buggy, please use with caution
- PLUG Updated Bootstrap to 4.6.0, Jquery to 3.5.1, check your `package.json`

#### Build v 4.5.1 Hot fix

- MISC Fixed all reported bugs and errors for Dark Mode
- JS Fixed Saving state for Skins
- DOM Change DOM element `id='mythemes'` to singular `id='mytheme'`
- PLUG Updated Bootstrap to 4.5.0, Jquery to 3.5.1, check your `package.json`

#### Build v 4.5.0 Example pages, more plugins, and requested features

- MISC Fixed all reported bugs and errors
- MISC Fixed gulp warning messages for Bootstrap's SCSS files.
- BUILD Added new build component to combine all CSS and JS files by running `gulp build-combined` which produces `'combined.js'` and `'combined.css'` files.
- JS Added Methods for Layout Options, see Settings Layout Options page for more details.
- PLUG Updated all plugins to latest, check your `package.json`
- PCKG Updated build file, updated package.json
- SCSS Added Fixed Footer option. See settings panel under App Layout for more details.
- SCSS Added Dark Navigation option. See settings panel under Global Modification for more details.
- SCSS Added Theme Modes Layer addon for Dark and Light Themes. See settings panel under Theme Modes (beta) for more details.
  - DOM Changes: We have hardcoded two additional stylesheets to the `head` element, refer to the HTML ID `#mytheme` and `#myskin`
- *HBS Added Projects View page
- *HBS Updated Docs to reflect recent changes

#### Build v 4.4.5 Hot Fix

- SCRP Fixed bugs for Project Structure page
- *HBS Updated Docs

#### Build v 4.4.3 BIG Documentation Update

- PLUG Updated all plugins to latest, check your `package.json`
- PCKG Updated build file, updated package.json
- PRJT Announcement: Removed Seed projects for PHP, Angular, ASP.NET and RubyOnRails Seed projects from the HTML Flavor.

  ## Licensed Content Update

  Dear Folks,

  We have always felt strongly towards ensuring that every customer of SmartAdmin has an opportunity to grow a strong connection with the entire range of Products of what the Theme has to offer, as such we have always included Seed versions of other Flavors, such as PHP, Angular, RubyOnRails and .NET Core, with the HTML Full purchase.

  These contributions were to give you a sneak peak of what the other Flavors had to offer and to of course assist you as our loyal customers with the target development platform of your choice. After much considering, we feel that this model does not allow us to fully support the Theme in the way we had envisioned.

  This means, that starting from this update, we are removing the seeds to encourage adoption of the Full versions. Obtaining the Seed and the Full versions of the Flavor you are interested in, will now only be made available after the purchase of each respective Flavor product on WrapBootstrap and will no longer be part of the HTML Flavor itself.

  #### WrapBootstrap Product Links

  - SmartAdmin for .NET Core
  - SmartAdmin for PHP

  We do apologize that we have had to take this decision, it was not made lightly. Rest assured though that we will always continue to support the community to our best abilities and with your interest at heart.

  Sincerely,
  Sunny

- PRJT Updated SLIM & Seed Project
- MISC Fixed all reported bugs and errors
- MISC Fixed Summernote's icon issue from last update
- FICN Updated Fontawesome Pro packages adding COVID-19 Icon sets.
- *HBS Revamped Documentation
- SCRP Added function for SmartPanels 'One Click' turn on Icons. See settings panel under Accessibility for more details.

#### Build v 4.4.1 Improvements and bug fixes

- SCRP Updated all plugins to latest version
- PCKG Updated build file, updated package.json
- PRJT Updated PHP Seed flavor
- PRJT Updated SLIM project (HTML Flavor)
- MISC Fixed all reported bugs and errors
- FICN Updated Fontawesome Pro packages adding the all new DuoTone icons now with a total of 7500+ icons to choose from

#### Build v 4.0.2 Improvements and bug fixes

- JS Updated Jquery 3.3.1 to 3.4.1
  - Notes: This change may impact some plugins on IE10, if you are seeing any issues with datatables for IE10, please revert back to jquery 3.3.1 through the build.json.
- SCRP Updated all plugins to latest version
- MISC Updated `./src/img`, `./src/custom/plugins` directories
- PCKG Updated build file, updated package.json
- PRJT Updated PHP Seed flavor
- PRJT Added Ruby on Rails Seed flavor
- PRJT Updated SLIM project (HTML Flavor)
- PRJT Added AJAX Alpha Flavor (HTML Flavor)
- PRJT Added Angular 8 Alpha Seed (work in progress)
- CSS Added RTL CSS which are automated. You can even write your own CSS and it will auto convert to RTL. Seed docs for proper usage.
- MISC Fixed all reported bugs and errors

#### Build v 4.0.1 Improvements and bug fixes

- PRJT Added Seed project (PHP Flavor)
- PRJT Added SLIM project (HTML Flavor)
- PRJT Added Full project (HTML AJAX Flavor - Alpha release)
- SCRP Fixed linux bug for lowercase uppercase in build.json
- *HBS Fixed error on blank.hbs
- SCRP Fixed fontawesome page bugs
- *HBS Updated app flavors page (added content for app flavor)
- *HBS Updated app docs
- *HBS Updated license page to reflect latest license changes on wrapbootstrap
- *HBS Update statistic bug
- *HBS Updated UI for side panels
- *HBS Added google analytics option
- *HBS Fixed broken link for inbox
- SCRP Added smartvoice.js (work in progress, page will be added in next release)
- *HBS Spell corrections and added links to footer
- SCSS CSS bug fix for (_nav-function-hidden.scss, _settings-demo-theme-colors.scss, _mod-clear-bg.scss, _mod-clean-page-bg.scss, _custom-bootstrap-varients.scss, _nav.scss, _mod-text-size.scss)
- SCSS Added NEW skin options (overlays base CSS file so there might be a flicker when switching pages because of the delay for server fetching), over 13 unique skins are now part of the base app
- PLUG Updated all plugins to latest, check your `package.json`
- DEL Removed `nav_dev.json`, `license.md`
- *HBS Updated docs
- *HBS Added source files HTML
- MISC Updated `./src/img`, `./src/custom/plugins` directories

#### Build v 4.0.0 Initial release

- *HBS Added source files HTML
  - Notes: Layouts are neatly organized into handlebar template partials `*.hbs`. Making it much easier to edit, remove or add new pages. There are three base layouts (main.hbs, auth.hbs, and alt.hbs)
- PCKG Updated BS4 pack to v4.3
- SCSS Added source files for CSS
- PRJT Added Seed project (HTML Flavor)
- PRJT Added Seed project (.Net Flavor)
- SCRP Added package.json
- SCRP Added _modules for SmartAdmin WebApp Core
- PLUG Added npm dependencies:
  - "@fullcalendar/bootstrap": "^4.2.0",
  - "@fullcalendar/core": "^4.2.0",
  - "@fullcalendar/daygrid": "^4.2.0",
  - "@fullcalendar/interaction": "^4.2.0",
  - "@fullcalendar/list": "^4.2.0",
  - "@fullcalendar/timegrid": "^4.2.0",
  - "bootbox": "^5.1.3",
  - "bootstrap": "^4.3.1",
  - "bootstrap-colorpicker": "^3.1.2",
  - "bootstrap-datepicker": "^1.9.0",
  - "bootstrap-daterangepicker": "^3.0.5",
  - "bootstrap-markdown": "^2.10.0",
  - "c3": "^0.7.1",
  - "chart.js": "^2.8.0",
  - "chartist": "^0.11.2",
  - "cropperjs": "^1.5.1",
  - "d3": "^5.9.2",
  - "datatables.net-autofill-bs4": "^2.3.3",
  - "datatables.net-bs4": "^1.10.19",
  - "datatables.net-buttons-bs4": "^1.5.6",
  - "datatables.net-colreorder-bs4": "^1.5.1",
  - "datatables.net-fixedcolumns-bs4": "^3.2.6",
  - "datatables.net-fixedheader-bs4": "^3.1.5",
  - "datatables.net-keytable-bs4": "^2.5.0",
  - "datatables.net-responsive-bs4": "^2.2.3",
  - "datatables.net-rowgroup-bs4": "^1.1.0",
  - "datatables.net-rowreorder-bs4": "^1.2.5",
  - "datatables.net-scroller-bs4": "^2.0.0",
  - "datatables.net-select-bs4": "^1.3.0",
  - "dropzone": "^5.5.1",
  - "dygraphs": "^2.1.0",
  - "easy-pie-chart": "^2.1.7",
  - "es6-promise-polyfill": "^1.2.0",
  - "flot": "^0.8.3",
  - "flot-spline": "0.0.1",
  - "holderjs": "^2.9.6",
  - "i18next-client": "^1.11.4",
  - "inputmask": "^4.0.8",
  - "ion-rangeslider": "^2.3.0",
  - "jquery": "3.3.1",
  - "jquery-cropper": "^1.0.0",
  - "jquery-mousewheel": "^3.1.13",
  - "jquery-slimscroll": "^1.3.8",
  - "jquery-sparkline": "^2.4.0",
  - "jquery-throttle-debounce": "github:myorangeca/jquery-throttle-debounce",
  - "jquery-ui": "^1.12.1",
  - "jquery.flot.tooltip": "^0.9.0",
  - "jqvmap": "^1.5.1",
  - "jszip": "^3.2.1",
  - "justifiedGallery": "^3.7.0",
  - "lightgallery": "^1.6.12",
  - "markdown": "^0.5.0",
  - "moment": "^2.24.0",
  - "node-waves": "^0.7.6",
  - "nouislider": "^13.1.5",
  - "pace-js": "^1.0.2",
  - "pdfmake": "^0.1.56",
  - "peity": "^3.3.0",
  - "popper.js": "^1.15.0",
  - "select2": "4.0.7",
  - "smartwizard": "^4.3.1",
  - "summernote": "^0.8.12",
  - "sweetalert2": "^8.11.7",
  - "toastr": "^2.1.4"
- GULP Added gulpfile.js with automated tasks:
  - compress images/*.css/*.js files
  - concatinate modules to core JS package
  - copy fonts/icons/favicon/videos
  - organize bower components
  - sass and hbs compiler
  - gulp task watch
  - gulp task connect
- MISC Added .favicon
- MISC Added IMG, VIDEO, and MISC directory for all media

#### Hi Sunny,

how can I help you today?
Analyze my data

Create a new report

Summarize my Calendar

App Builder
Unlock limitless design potential with 16+ layout combinations and extensive customization options—tailor your dashboard to fit your exact needs.
Header position fixed
Navigation full height
Navigation position fixed
Navigation collapsed
Navigation Minified
Dark Navigation
Colorblind Mode
High Contrast Mode