Gentelella v2.1.1 - Maintenance Release

Summary

This maintenance release focuses on updating all dependencies to their latest versions, fixing chart functionality issues, and enhancing the developer experience. The release ensures all security vulnerabilities are patched while improving widget styling and chart visualizations.

Key Improvements

Dependency Updates

• All dependencies updated to latest versions for security and performance
• ECharts upgraded to 6.0.0 (major version) with enhanced features
• Security patches applied resolving all CVE vulnerabilities
• Modern toolchain with latest Vite, TypeScript, and ESLint versions

Chart & Widget Enhancements

• Fixed ECharts page - All charts now display correctly on echarts.html
• Enhanced widget system - Improved content density with professional styling
• Chart color consistency - Fixed Device Usage chart to match label colors
• Interactive functionality - Restored visitors location map and weather icons

Developer Experience

• Stable development server with auto-restart capability
• Clean production builds with comprehensive console log removal
• Enhanced build configuration with better optimization settings
• Improved debugging with development-only logging

Detailed Changes

Dependency Version Updates

Vite: 7.0.6 → 7.1.4
Bootstrap: 5.3.6 → 5.3.8  
ECharts: 5.6.0 → 6.0.0
Chart.js: 4.4.2 → 4.5.0
jQuery: 3.6.1 → 3.7.1
TypeScript: 5.8.3 → 5.9.2
ESLint: 9.31.0 → 9.34.0
DataTables: 2.3.2 → 2.3.3
Font Awesome: 7.0.0 → 7.0.1
Ruby: 2.6.10 → 3.3.9
Nokogiri: 1.13.10 → 1.18.9

Fixed Functionality

• ECharts Page: All 12 chart types now display correctly
  • Bar graphs, pie charts, donut charts, scatter plots
  • Line charts, horizontal bars, world map visualization
  • Pyramid sales funnel with improved readability
  • Sonar radar chart for performance metrics
• Index Dashboard: Restored interactive features
  • Visitors location map with country data
  • Animated weather icons (Skycons)
  • Device usage chart with matching colors
• Widget Cards: Enhanced content density and styling
  • Additional metrics and growth indicators
  • Professional card design with hover effects
  • Better typography and spacing

Technical Improvements

• Development Server: Enhanced stability and reliability
  • Fixed frequent crashes and restart issues
  • Added automatic restart capability with dev:watch script
  • Improved file watching and hot module replacement
• Production Builds: Clean and optimized output
  • Comprehensive console statement removal
  • Enhanced Terser configuration for better minification
  • ES module support with modern JavaScript
• Code Quality: Updated linting and formatting tools
  • Latest ESLint and Prettier configurations
  • Better error handling and debugging capabilities

Installation

For New Projects

git clone https://github.com/puikinsh/gentelella.git
cd gentelella
npm install
npm run dev

For Existing Projects

git pull origin master
npm install
npm run build

Security Notes

• All CVE vulnerabilities resolved with latest dependency versions
• jQuery upgraded to 3.7.1 - addresses Dependabot security alerts
• Ruby and Nokogiri updated - resolves all documentation build vulnerabilities
• Enhanced security headers and proper CSP configuration

Development Commands

npm run dev          # Start development server
npm run dev:watch    # Start with auto-restart capability  
npm run build        # Production build
npm run lint:fix     # Fix linting issues
npm run format       # Format code
npm run analyze      # Bundle analysis

Breaking Changes

None - This is a backward-compatible maintenance release.

Gentelella Admin Template v2.1.0

Enhancement Release - jQuery-Free Core System & Brand Refresh

This release brings significant modernization to Gentelella's core system, introducing a completely jQuery-free implementation for essential functionality while maintaining full backward compatibility. The focus is on performance, modern JavaScript practices, and improved developer experience.

🎯 Key Highlights

jQuery-Free Core System

• Complete modernization of main-core.js with vanilla JavaScript
• New DOM utilities library providing jQuery-like API without dependencies
• Dynamic module loading with intelligent caching and performance monitoring
• Loading states and visual indicators for enhanced user experience

Modern Favicon Implementation

• SVG-first approach ensuring crisp display on all devices
• Complete favicon suite: SVG, ICO, Apple Touch Icon, Android Chrome icons
• PWA-ready with web app manifest
• Brand-consistent design using the template's signature colors

Production-Ready Improvements

• Clean console output with development-only debugging
• Perfect vertical alignment of navigation elements
• Enhanced error handling and recovery
• Streamlined codebase with reduced development artifacts

📦 What's New

Core System Enhancements

• Modern DOM Utilities (src/utils/dom-modern.js)

  • Complete jQuery replacement for DOM manipulation
  • Slide animations, fade effects, event handling
  • Consistent API across the entire codebase

• Enhanced Module Loading

  • Performance monitoring and statistics
  • Intelligent caching system
  • Visual loading indicators
  • Robust error boundaries

UI/UX Improvements

• Navigation Perfection

  • Pixel-perfect vertical centering of user profile and notifications
  • Improved responsive behavior on mobile devices
  • Enhanced touch interaction support

• Visual Consistency

  • Brand-aligned favicon across all platforms
  • Improved spacing and alignment throughout interface
  • Modern loading states for better user feedback

Developer Experience

• Clean Production Code

  • Removed verbose console logs
  • Development-only debugging wrapped in environment checks
  • Professional error handling

• Modern JavaScript

  • ES6+ features throughout
  • Async/await for asynchronous operations
  • Modern event handling patterns

🔧 Technical Details

File Changes

• src/main-core.js - Completely modernized with jQuery-free implementation
• src/utils/dom-modern.js - New comprehensive DOM utilities library
• src/js/init-modern.js - Updated initialization with modern patterns
• src/js/sidebar-modern.js - Enhanced sidebar functionality
• production/images/favicon.* - Complete favicon suite
• production/site.webmanifest - PWA manifest configuration

Performance Metrics

• Core bundle remains at 79KB (unchanged)
• Zero jQuery dependencies in core system
• Faster initialization with modern JavaScript
• Improved animation performance with CSS transitions

🚀 Migration Guide

For Existing Users

No breaking changes! Your existing code will continue to work. The jQuery-free system runs alongside existing jQuery code, allowing gradual migration.

Using Modern DOM Utilities

// Old jQuery way
$('.element').slideUp();

// New modern way
DOM.slideUp(DOM.select('.element'));

Dynamic Module Loading

// Load modules with visual feedback
if (document.querySelector('.chart-container')) {
  const charts = await loadModule('charts');
}

📝 Bug Fixes

• Fixed loadModule reference errors when using main-minimal.js
• Resolved favicon display issues in legacy browsers
• Corrected navigation element positioning and alignment
• Eliminated development console noise in production builds

🔄 Dependencies

No new dependencies added. All improvements use native browser APIs and existing libraries.

📊 Browser Support

• Modern browsers (Chrome, Firefox, Safari, Edge)
• Progressive enhancement for older browsers
• Full mobile browser support (iOS Safari, Chrome Mobile)

🙏 Acknowledgments

Thanks to all contributors and users who provided feedback for this release. Special thanks to the community for patience during the modernization process.

📥 Installation

New Installation

git clone https://github.com/puikinsh/gentelella.git
cd gentelella
npm install
npm run dev

Upgrading from 2.0.0

git pull origin master
npm install
npm run build

🐛 Known Issues

None at this time. Please report any issues on our GitHub repository.

Major Stable Release - Bootstrap 5 with Modern Build System

🚀 Key Highlights:
• 90% smaller bundle (79KB vs 779KB) with Vite build system
• Bootstrap 5.3.6 complete migration with modern design
• Morris.js eliminated - replaced with Chart.js 4.4.2
• jQuery easing fixed - all animation errors resolved
• Enhanced performance - 40-70% faster page loads

🔧 Major Improvements:
• Complete Morris.js removal (morisjs.html → chart3.html)
• Fixed jQuery easing TypeError issues
• Updated navigation across 35+ HTML files
• Modern responsive design with mobile-first approach
• Error page redesigns (403, 404, 500)

📦 Smart Loading System:
• Core Bundle (79KB): Essential libraries
• Chart Module (219KB): Only loads on chart pages
• Form Module (200KB): Only loads on form pages
• Conditional module loading for optimal performance

🛠️ Technical Stack:
• Bootstrap 5.3.6 • Vite 6.3.5 • Chart.js 4.4.2 • ECharts 5.6.0

🚀 Quick Start:

git clone https://github.com/ColorlibHQ/gentelella.git
cd gentelella && npm install && npm run dev

Full changelog: https://github.com/ColorlibHQ/gentelella/blob/master/changelog.md

• Fixed all errors reported until now
• Updated dependencies
• Fixed vulnerability notices

• Updated Bootstrap to 4.3.1
• Updated all dependencies
• Fixed all reported bugs

This version is tested but we would recommend not to use it in production right away. Please install it for testing purposes and report back if there are any problems to be fixed.

• Updated FullCalendar version (3.1.0) and added new feature : list view #321
• Added calendar folder language #266
• Text Area Multi Editor fix - now you can add multiple editors in the same page working properly #325
• General Form - cancel button , validating and submitting fix. Now cancel button doesn't act like a "submit" button anymore , also added a "reset" button #280
• Form elements : input background icon hidden fix. Left icon it appears now when sidebar is closed #239
• Search bar on Tables Dynamic fix ( it's working properly on responsive ) #328
• Tables Dynamic - search button fix ( now it's working properly on responsive ) #241
• Submenu labels over footer menu fix #346
• Sidebar "nav-sm" on current page always display child menu fix #286
• Two font-awesome folders in vendors fix ( removed "fontawesome" folder ) #364
• Tables Dynamic overflow on mobile fix #358
• Small fixes on sidebar in terms of alignment , line-height and font-size
• Sidebar logout link fix ( now it's working )
• Removed inline Javascript code
• Created independent functions ( ex : init_chart(); )
• Now Javascript code it is in one place ( custom.min.js ) file
• "Gentellela" name fix. Changed name from "Gentellela" to Gentelella on every page including readme.md and package.json
• Tables Dynamic - "datatables.scroller.js" fix ( replaced with dataTables.scroller.js )

• Introduce gulp build system
• Sidebar menu fixes
• Fixed Footer
• Fix login form not switching to signup form

• Fix menu not become active if url contains parameters
• Fix form upload form not adjust on large number of files
• Remove invalid css
• Add fixed sidebar functionalities
• Add compose message functionalities
• Add npm package

• Add multilevel menu
• Mobile comptibility enhancement

Release Notes

• Fixed dataTables
• Added new dataTable variations
• Added changelog.md
• FInally introduced version and version tags