adminator-admin-dashboard 2.7.0 β†’ 2.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,403 @@
1
+ # Changelog
2
+
3
+ ## [2.7.1] - 2025-07-10
4
+
5
+ ### Bug Fixes & Improvements
6
+ - Minor version bump with maintenance updates
7
+ - Enhanced code quality and stability improvements
8
+ - Updated documentation and changelog formatting
9
+
10
+ ## [2.7.0] - 2025-07-09
11
+
12
+ ### jQuery-Free Release + NPM Package Publication
13
+
14
+ This release represents a **major performance milestone** - complete removal of jQuery dependency and all jQuery-based plugins, resulting in a modern, lightweight, and significantly faster admin template.
15
+
16
+ ### NPM Package Available
17
+
18
+ **Adminator is now available as an npm package!**
19
+
20
+ ```bash
21
+ # Install via npm
22
+ npm install adminator-admin-dashboard
23
+
24
+ # Or install via yarn
25
+ yarn add adminator-admin-dashboard
26
+ ```
27
+
28
+ **Package Information:**
29
+ - **Package Name**: `adminator-admin-dashboard`
30
+ - **Registry**: https://www.npmjs.com/package/adminator-admin-dashboard
31
+ - **Size**: 5.7 MB (includes complete source + built assets)
32
+ - **Contents**: Source code, production builds, documentation, and all dependencies
33
+
34
+ **What's included:**
35
+ - Complete source code (`src/` directory)
36
+ - Pre-built production assets (`dist/` directory)
37
+ - All dependencies and development tools
38
+ - Comprehensive documentation (CLAUDE.md, CHANGELOG.md)
39
+ - Ready-to-use HTML templates
40
+
41
+ **Usage:**
42
+ ```bash
43
+ # After installation, navigate to package directory
44
+ cd node_modules/adminator-admin-dashboard
45
+
46
+ # Install dev dependencies for customization
47
+ npm install
48
+
49
+ # Start development server
50
+ npm start
51
+ ```
52
+
53
+ This release represents a **major performance milestone** - complete removal of jQuery dependency and all jQuery-based plugins, resulting in a modern, lightweight, and significantly faster admin template.
54
+
55
+ ### Performance Improvements
56
+
57
+ **Bundle Size Reduction:**
58
+ - **~600KB Reduction**: Complete elimination of jQuery and jQuery-dependent plugins
59
+ - **Faster Load Times**: Native DOM manipulation for optimal performance
60
+ - **Modern Architecture**: ES6+ class-based components with zero legacy overhead
61
+
62
+ **Removed jQuery Dependencies:**
63
+ - `jquery` (3.7.1) - Replaced with vanilla JS DOM manipulation
64
+ - `jquery-sparkline` (2.4.0) - Replaced with Chart.js mini charts
65
+ - `bootstrap-datepicker` (1.10.0) - Replaced with HTML5 date inputs + vanilla JS
66
+ - `datatables` (1.10.18) - Replaced with vanilla JS table component
67
+ - `easy-pie-chart` (2.1.7) - Replaced with vanilla JS SVG pie charts
68
+ - `jvectormap` (2.0.4) - Replaced with vanilla JS SVG world map
69
+
70
+ ### Modern JavaScript Implementations
71
+
72
+ **100% Vanilla JavaScript Architecture:**
73
+ - **Component System**: Modern class-based components (Sidebar, Charts, etc.)
74
+ - **DOM Utilities**: jQuery-like functionality using native JavaScript (`src/assets/scripts/utils/dom.js`)
75
+ - **Event Management**: Native event handling with modern delegation patterns
76
+ - **Mobile Optimization**: Touch-friendly interactions without jQuery overhead
77
+
78
+ **Feature-Complete Replacements:**
79
+
80
+ **Charts & Visualizations:**
81
+ - **Chart.js Sparklines**: Mini charts with full theme support and better performance
82
+ - **SVG Pie Charts**: Custom circular progress indicators with animations
83
+ - **Enhanced Line Charts**: Interactive charts with tooltip support and responsive design
84
+
85
+ **Interactive Components:**
86
+ - **Vanilla DataTables**: Full-featured table with sorting, pagination, and search
87
+ - **HTML5 Date Pickers**: Enhanced native date inputs with Day.js integration
88
+ - **Vector Maps**: JavaScript-based world map with markers and theme support
89
+ - **Sidebar Navigation**: Smooth animations and touch-friendly mobile interactions
90
+
91
+ **UI Enhancements:**
92
+ - **Mobile Search**: Full-width search overlay with enhanced touch experience
93
+ - **Dropdown Management**: Improved mobile dropdown behavior with overlay handling
94
+ - **Responsive Design**: Better mobile viewport handling and gesture support
95
+
96
+ ### Technical Achievements
97
+
98
+ **Architecture Modernization:**
99
+ - **ES6+ Classes**: Modern component architecture replacing jQuery plugins
100
+ - **Module System**: ES6 import/export for better code organization
101
+ - **Type Safety**: Enhanced error handling and parameter validation
102
+ - **Performance**: Eliminated jQuery overhead and improved runtime efficiency
103
+
104
+ **Theme Integration:**
105
+ - **Dark Mode Support**: All new components fully support light/dark theme switching
106
+ - **CSS Variables**: Component styling integrated with existing theme system
107
+ - **Consistent Design**: Maintained visual consistency while improving performance
108
+
109
+ **Developer Experience:**
110
+ - **Clean Console**: Removed all development console notices and debugging output
111
+ - **ESLint Compliance**: All code follows modern ESLint 9.x flat config standards
112
+ - **Maintainable Code**: Well-documented, modular architecture for future enhancements
113
+
114
+ ### Zero Breaking Changes
115
+
116
+ **Seamless Migration:**
117
+ - **Visual Consistency**: All components maintain identical visual appearance
118
+ - **API Compatibility**: Existing functionality preserved with better performance
119
+ - **Theme Support**: Full compatibility with existing dark/light mode system
120
+ - **Mobile Experience**: Enhanced mobile interactions with no breaking changes
121
+
122
+ ### Component Improvements
123
+
124
+ **Enhanced Functionality:**
125
+ - **Charts**: Better responsiveness and theme integration
126
+ - **Tables**: Improved sorting and pagination performance
127
+ - **Date Pickers**: Enhanced mobile experience with native HTML5 inputs
128
+ - **Maps**: Better rendering performance and theme consistency
129
+ - **Navigation**: Smoother animations and better touch handling
130
+
131
+ ### Code Quality
132
+
133
+ **Production Ready:**
134
+ - **Clean Output**: No console debugging statements in production code
135
+ - **Linting**: All JavaScript files pass ESLint 9.x with modern standards
136
+ - **Performance**: Optimized for speed with minimal DOM manipulation
137
+ - **Accessibility**: Maintained accessibility features without jQuery dependencies
138
+
139
+ ### Files Modified
140
+
141
+ **Core Application:**
142
+ - `src/assets/scripts/app.js` - Complete jQuery removal and modern component integration
143
+ - `src/assets/scripts/components/Sidebar.js` - Vanilla JS sidebar with animations
144
+ - `src/assets/scripts/components/Chart.js` - Chart.js implementation replacing jQuery Sparkline
145
+ - `src/assets/scripts/utils/dom.js` - jQuery-like utilities using vanilla JavaScript
146
+
147
+ **New Implementations:**
148
+ - Enhanced mobile search functionality
149
+ - Vanilla JavaScript data table component
150
+ - HTML5 date picker enhancements
151
+ - SVG-based vector maps
152
+ - Modern dropdown and popover handling
153
+
154
+ ### Migration Notes
155
+
156
+ **Automatic Migration:**
157
+ - No code changes required for existing projects
158
+ - All functionality automatically upgraded to vanilla JavaScript
159
+ - Theme system remains fully compatible
160
+ - Mobile experience enhanced without breaking changes
161
+
162
+ **Performance Benefits:**
163
+ - Immediate ~600KB bundle size reduction
164
+ - Faster initial page load
165
+ - Improved runtime performance
166
+ - Better mobile experience
167
+
168
+ ## [2.6.1] - 2025-07-26
169
+
170
+ ### Dependency Updates
171
+ - Updated `bootstrap` 5.3.6 β†’ 5.3.7
172
+ - Updated `postcss` 8.5.5 β†’ 8.5.6
173
+ - Updated `stylelint` 16.20.0 β†’ 16.21.0
174
+
175
+ ## [2.6.0] - 2025-06-21
176
+
177
+ ### Dark Mode Release
178
+
179
+ This release introduces a comprehensive dark mode system with seamless theme switching and component integration.
180
+
181
+ ### New Features
182
+
183
+ **Complete Dark Mode System:**
184
+ - **Smart Theme Toggle**: Bootstrap-based switch with sun/moon icons and "Light/Dark" labels
185
+ - **OS Preference Detection**: Automatically detects and applies user's preferred color scheme
186
+ - **Persistent Theme Storage**: Remembers user's theme choice across sessions
187
+ - **Instant Theme Switching**: Real-time theme updates without page reload
188
+
189
+ **Theme-Aware Components:**
190
+ - **Chart.js Integration**: Dynamic color schemes for all chart types with proper contrast
191
+ - **FullCalendar Support**: Dark-mode aware calendar with proper border and text colors
192
+ - **Vector Maps**: Custom color palettes for both light and dark themes
193
+ - **Google Maps**: Theme-specific styling for landscapes, highways, and POI markers
194
+ - **Sparkline Charts**: Optimized color sets for dark mode visibility
195
+ - **Skycons Weather Icons**: Adaptive colors for better dark mode contrast
196
+
197
+ **CSS Architecture:**
198
+ - **CSS Custom Properties**: Comprehensive variable system for consistent theming
199
+ - **Semantic Color Naming**: Intuitive color variables (--c-text-base, --c-bkg-card, etc.)
200
+ - **Component Isolation**: Each component respects global theme variables
201
+ - **Responsive Design**: Theme switching works seamlessly across all screen sizes
202
+
203
+ **Visual Enhancements:**
204
+ - **Adaptive Logo**: SVG logo automatically adjusts colors based on theme
205
+ - **Smart Contrast**: Proper text/background contrast ratios in both themes
206
+ - **Border Consistency**: Unified border colors throughout the interface
207
+ - **Loading States**: Theme-aware loaders and progress indicators
208
+
209
+ ### Technical Improvements
210
+
211
+ **Architecture Updates:**
212
+ - **Theme Utility Module**: New `src/assets/scripts/utils/theme.js` with comprehensive theme management
213
+ - **CSS Variables File**: New `src/assets/styles/utils/theme.css` with light/dark color schemes
214
+ - **Component Integration**: Updated all major components to support theme switching
215
+ - **Event System**: Custom events for theme change notifications
216
+
217
+ **Performance Optimizations:**
218
+ - **Efficient Switching**: Minimal DOM manipulation for theme changes
219
+ - **CSS Variable Updates**: Leverages browser-native CSS custom properties
220
+ - **Memory Management**: Proper cleanup of theme-related event listeners
221
+ - **Build Integration**: Theme assets are properly bundled and optimized
222
+
223
+ ### User Experience
224
+
225
+ **Intuitive Controls:**
226
+ - **Accessible Toggle**: Proper ARIA labels and keyboard navigation support
227
+ - **Visual Feedback**: Clear indication of current theme state
228
+ - **Smooth Transitions**: CSS transitions for theme switching (where appropriate)
229
+ - **Consistent Placement**: Theme toggle integrated into header navigation
230
+
231
+ **Smart Behavior:**
232
+ - **First-Time Detection**: Respects OS dark mode preference on first visit
233
+ - **Cross-Session Persistence**: Theme choice remembered across browser sessions
234
+ - **Fallback Handling**: Graceful degradation when localStorage is unavailable
235
+ - **Dynamic Updates**: All components update immediately when theme changes
236
+
237
+ ### Development Experience
238
+
239
+ **Documentation:**
240
+ - **Theme API**: Comprehensive methods for theme management
241
+ - **Color Guidelines**: Standardized color usage across components
242
+ - **Component Examples**: Updated examples showing theme-aware components
243
+ - **Migration Guide**: Instructions for theme integration in custom components
244
+
245
+ ### Enhanced Components
246
+
247
+ **Charts & Data Visualization:**
248
+ - Chart.js with dynamic color schemes
249
+ - Sparkline charts with theme-optimized colors
250
+ - Easy Pie Charts with adaptive styling
251
+ - Vector maps with custom dark mode palettes
252
+
253
+ **Interactive Elements:**
254
+ - FullCalendar with proper dark mode borders
255
+ - DataTables with theme-consistent styling
256
+ - Date pickers with adaptive colors
257
+ - Form elements with dark mode support
258
+
259
+ **Maps & Location:**
260
+ - Google Maps with custom dark mode styling
261
+ - Vector maps with region-specific color schemes
262
+ - Marker and overlay theme integration
263
+
264
+ ### Breaking Changes
265
+
266
+ None. This release is fully backward compatible.
267
+
268
+ ### Migration Guide
269
+
270
+ Existing projects will automatically inherit dark mode capabilities. No code changes required.
271
+
272
+ **Optional Enhancements:**
273
+ - Add `data-theme` attribute handling for custom components
274
+ - Use CSS variables from `theme.css` for consistent coloring
275
+ - Listen for `adminator:themeChanged` events for custom theme handling
276
+
277
+ ### Files Added/Modified
278
+
279
+ **New Files:**
280
+ - `src/assets/scripts/utils/theme.js` - Theme management utility
281
+ - `src/assets/styles/utils/theme.css` - CSS variables and color schemes
282
+
283
+ **Enhanced Files:**
284
+ - All HTML pages updated with theme-aware components
285
+ - Component JavaScript files updated for theme integration
286
+ - SCSS files enhanced with CSS variable usage
287
+ - Logo SVG updated for theme compatibility
288
+
289
+ ## [2.5.0] - 2025-06-16
290
+
291
+ ### Major Modernization Release
292
+
293
+ This release represents a comprehensive modernization of the entire build toolchain and development stack.
294
+
295
+ ### Dependency Updates
296
+
297
+ **Phase 1 - Safe Updates:**
298
+ - Updated `chart.js` 4.4.2 β†’ 4.5.0
299
+ - Updated `shx` 0.3.3 β†’ 0.4.0
300
+ - Added `eslint-formatter-table` for better linting output
301
+
302
+ **Phase 2 - Moderate Updates:**
303
+ - Updated `sass-loader` 14.2.1 β†’ 16.0.5
304
+ - Updated `postcss-preset-env` 9.6.0 β†’ 10.2.3
305
+ - Updated `stylelint-config-standard` 36.0.1 β†’ 38.0.0
306
+ - Fixed `stylelint` command syntax for latest version
307
+
308
+ **Phase 3 - Major Breaking Changes:**
309
+ - Updated `copy-webpack-plugin` 12.0.2 β†’ 13.0.0
310
+ - Updated `babel-loader` 9.2.1 β†’ 10.0.0
311
+ - Updated `webpack-cli` 5.1.4 β†’ 6.0.1
312
+ - Updated `eslint` 8.57.1 β†’ 9.29.0
313
+
314
+ **Latest Dependencies Update:**
315
+ - Updated all Babel packages to v7.27.x
316
+ - Updated FullCalendar packages to v6.1.17
317
+ - Updated Bootstrap to v5.3.6
318
+ - Updated webpack ecosystem (webpack 5.99.9, webpack-dev-server 5.2.2)
319
+ - Updated PostCSS to v8.5.5
320
+ - Updated Sass to v1.89.2
321
+ - Updated Stylelint to v16.20.0
322
+ - Plus 22 total dependency updates
323
+
324
+ ### Configuration Changes
325
+
326
+ **ESLint 9.x Migration:**
327
+ - Migrated from `.eslintrc.json` to `eslint.config.mjs` (flat config)
328
+ - Removed incompatible `eslint-config-airbnb-base` and `eslint-plugin-import`
329
+ - Created modern ESLint configuration with equivalent rules
330
+ - Updated line endings for cross-platform compatibility
331
+
332
+ **Build System Improvements:**
333
+ - Enhanced webpack configuration compatibility
334
+ - Improved CSS processing pipeline
335
+ - Better development server performance
336
+
337
+ **Package Management:**
338
+ - Fixed `package.json` to reflect exact installed dependency versions
339
+ - Removed incompatible ESLint packages from dependencies
340
+ - Ensured version alignment between installed and declared packages
341
+
342
+ **Phase 5.1 - Date Library Migration:**
343
+ - **REMOVED** `moment` 2.30.1 (67KB) - unused legacy dependency
344
+ - **ADDED** `dayjs` 1.11.13 (2KB) - modern 97% smaller alternative
345
+ - Created comprehensive `DateUtils` module with modern date handling
346
+ - Updated FullCalendar to use Day.js for dynamic date generation
347
+ - Enhanced date picker functionality with Day.js validation
348
+ - Bundle size reduction: ~65KB saved
349
+ - Zero breaking changes - Day.js provides same API coverage
350
+
351
+ ### Development Experience
352
+
353
+ - **Node.js Support**: Now requires Node.js 18.12.0+ (compatible with v23.11.0)
354
+ - **Modern tooling**: All dependencies updated to latest stable versions
355
+ - **Zero security vulnerabilities**: Complete security audit clean
356
+ - **Improved performance**: Faster builds and development server
357
+ - **Better linting**: Modern ESLint 9.x with flat config
358
+ - **Enhanced CSS**: Latest PostCSS and Sass versions
359
+
360
+ ### Security & Quality
361
+
362
+ - All dependencies audited and updated to latest secure versions
363
+ - Zero known security vulnerabilities
364
+ - Modern linting rules for better code quality
365
+ - Updated copyright notices to 2025
366
+
367
+ ### Documentation
368
+
369
+ - Updated README with modern setup instructions
370
+ - Enhanced development workflow documentation
371
+ - Added comprehensive changelog entries
372
+
373
+ ### Breaking Changes
374
+
375
+ - **Node.js**: Minimum version now 18.12.0
376
+ - **ESLint**: Configuration format changed from eslintrc to flat config
377
+ - **Development**: Some webpack-cli commands removed (init, loader, plugin)
378
+
379
+ ### Migration Guide
380
+
381
+ For projects upgrading from v2.1.0:
382
+ 1. Ensure Node.js version is 18.12.0 or higher
383
+ 2. Run `npm install` to get updated dependencies
384
+ 3. ESLint configuration is automatically updated
385
+ 4. No code changes required for existing projects
386
+
387
+ ## [2.1.0]
388
+ - Upgraded all dependencies
389
+
390
+ ## [2.0.0]
391
+
392
+ ### Changed
393
+ - Upgrade to Bootstrap 5
394
+
395
+ ## [1.1.0]
396
+
397
+ ### Changed
398
+ - Upgrade to webpack 5
399
+
400
+ ## [1.0.0]
401
+
402
+ ### Added
403
+ - Intial release
package/README.md CHANGED
@@ -1,12 +1,12 @@
1
- # Adminator Bootstrap 5 Admin Template v2.7.0
1
+ # Adminator Bootstrap 5 Admin Template v2.7.1
2
2
 
3
3
  **Adminator** is a responsive Bootstrap 5 Admin Template built with modern development tools. It provides you with a collection of ready to use code snippets and utilities, custom pages, a collection of applications and some useful widgets.
4
4
 
5
- πŸš€ **Latest Update (v2.7.0)**: **100% jQuery-Free** - Complete removal of jQuery dependency (~600KB bundle reduction) with modern vanilla JavaScript implementation.
5
+ **Latest Update (v2.7.1)**: **100% jQuery-Free** - Complete removal of jQuery dependency (~600KB bundle reduction) with modern vanilla JavaScript implementation.
6
6
 
7
- ⚑ **Performance Benefits**: Faster load times, smaller bundle size, modern ES6+ code, and zero jQuery overhead.
7
+ **Performance Benefits**: Faster load times, smaller bundle size, modern ES6+ code, and zero jQuery overhead.
8
8
 
9
- πŸ“š **[Complete Documentation](https://puikinsh.github.io/Adminator-admin-dashboard/)** - Detailed setup guides, API reference, and examples
9
+ **[Complete Documentation](https://puikinsh.github.io/Adminator-admin-dashboard/)** - Detailed setup guides, API reference, and examples
10
10
 
11
11
  Preview of this awesome admin template available here: https://colorlib.com/polygon/adminator/index.html
12
12
 
@@ -35,48 +35,48 @@ Preview of this awesome admin template available here: https://colorlib.com/poly
35
35
  - [Authors](#authors)
36
36
  - [License](#license)
37
37
 
38
- ## What's New in v2.7.0
39
-
40
- πŸš€ **jQuery-Free Release** - Complete removal of jQuery dependency with modern vanilla JavaScript:
41
-
42
- ### πŸ’₯ Major Performance Improvements
43
- - **⚑ ~600KB Bundle Reduction**: Eliminated jQuery and all jQuery-dependent plugins
44
- - **πŸš€ Faster Load Times**: Native DOM manipulation for optimal performance
45
- - **πŸ“¦ Smaller Bundle Size**: Significantly reduced JavaScript payload
46
- - **🌟 Modern ES6+ Code**: Class-based architecture with modern JavaScript features
47
-
48
- ### πŸ”„ jQuery Replacements (Zero Breaking Changes)
49
- - **πŸ“Š Chart.js**: Replaced jQuery Sparkline with Chart.js mini charts
50
- - **πŸ“… HTML5 Date Pickers**: Enhanced native date inputs with Day.js support
51
- - **πŸ“‹ Vanilla DataTables**: Custom table component with sorting and pagination
52
- - **🎨 SVG Pie Charts**: Pure JavaScript circular progress indicators
53
- - **πŸ—ΊοΈ Vector Maps**: JavaScript-based world map with markers and interactions
54
- - **πŸ’¬ Vanilla Popovers**: Lightweight alternatives to Bootstrap JS components
55
-
56
- ### πŸ› οΈ Technical Achievements
57
- - **🎯 100% Vanilla JavaScript**: No jQuery dependency anywhere in the codebase
58
- - **♻️ Component Architecture**: Modern class-based components (Sidebar, Charts, etc.)
59
- - **πŸ”§ Enhanced DOM Utilities**: jQuery-like functionality using native JavaScript
60
- - **πŸ“± Mobile Optimized**: Touch-friendly interactions and responsive behavior
61
- - **πŸŒ™ Theme Integration**: All new components fully support dark/light mode switching
62
-
63
- ### πŸŒ™ Previous Updates (v2.6.0 - Dark Mode System)
64
-
65
- ### 🎨 Dark Mode Features
66
- - **πŸŒ— Smart Theme Toggle**: Bootstrap-based switch with sun/moon icons and intuitive labels
67
- - **πŸ”„ OS Preference Detection**: Automatically detects and applies your preferred color scheme
68
- - **πŸ’Ύ Persistent Storage**: Remembers your theme choice across browser sessions
69
- - **⚑ Instant Switching**: Real-time theme updates without page reload
70
- - **🎯 Component Integration**: All charts, calendars, maps, and UI elements are theme-aware
71
-
72
- ### πŸ› οΈ Technical Implementation
73
- - **🎨 CSS Variables Architecture**: Comprehensive color system with semantic naming
74
- - **πŸ“Š Chart.js Integration**: Dynamic color schemes for all chart types
75
- - **πŸ—“οΈ FullCalendar Support**: Dark-mode aware calendar with proper contrast
76
- - **πŸ—ΊοΈ Vector Maps**: Custom color palettes for both light and dark themes
77
- - **πŸŽͺ Component Compatibility**: Theme support across all interactive elements
78
-
79
- ### πŸš€ Previous Updates (v2.5.0)
38
+ ## What's New in v2.7.1
39
+
40
+ **jQuery-Free Release** - Complete removal of jQuery dependency with modern vanilla JavaScript:
41
+
42
+ ### Major Performance Improvements
43
+ - **~600KB Bundle Reduction**: Eliminated jQuery and all jQuery-dependent plugins
44
+ - **Faster Load Times**: Native DOM manipulation for optimal performance
45
+ - **Smaller Bundle Size**: Significantly reduced JavaScript payload
46
+ - **Modern ES6+ Code**: Class-based architecture with modern JavaScript features
47
+
48
+ ### jQuery Replacements (Zero Breaking Changes)
49
+ - **Chart.js**: Replaced jQuery Sparkline with Chart.js mini charts
50
+ - **HTML5 Date Pickers**: Enhanced native date inputs with Day.js support
51
+ - **Vanilla DataTables**: Custom table component with sorting and pagination
52
+ - **SVG Pie Charts**: Pure JavaScript circular progress indicators
53
+ - **Vector Maps**: JavaScript-based world map with markers and interactions
54
+ - **Vanilla Popovers**: Lightweight alternatives to Bootstrap JS components
55
+
56
+ ### Technical Achievements
57
+ - **100% Vanilla JavaScript**: No jQuery dependency anywhere in the codebase
58
+ - **Component Architecture**: Modern class-based components (Sidebar, Charts, etc.)
59
+ - **Enhanced DOM Utilities**: jQuery-like functionality using native JavaScript
60
+ - **Mobile Optimized**: Touch-friendly interactions and responsive behavior
61
+ - **Theme Integration**: All new components fully support dark/light mode switching
62
+
63
+ ### Previous Updates (v2.6.0 - Dark Mode System)
64
+
65
+ ### Dark Mode Features
66
+ - **Smart Theme Toggle**: Bootstrap-based switch with sun/moon icons and intuitive labels
67
+ - **OS Preference Detection**: Automatically detects and applies your preferred color scheme
68
+ - **Persistent Storage**: Remembers your theme choice across browser sessions
69
+ - **Instant Switching**: Real-time theme updates without page reload
70
+ - **Component Integration**: All charts, calendars, maps, and UI elements are theme-aware
71
+
72
+ ### Technical Implementation
73
+ - **CSS Variables Architecture**: Comprehensive color system with semantic naming
74
+ - **Chart.js Integration**: Dynamic color schemes for all chart types
75
+ - **FullCalendar Support**: Dark-mode aware calendar with proper contrast
76
+ - **Vector Maps**: Custom color palettes for both light and dark themes
77
+ - **Component Compatibility**: Theme support across all interactive elements
78
+
79
+ ### Previous Updates (v2.5.0)
80
80
  - **Latest Dependencies**: All 22+ dependencies updated to latest versions
81
81
  - **Modern Build Tools**: webpack 5.99.9, webpack-dev-server 5.2.2
82
82
  - **ESLint 9.x**: Migrated to modern flat config format
@@ -86,7 +86,48 @@ Preview of this awesome admin template available here: https://colorlib.com/poly
86
86
 
87
87
  ## Getting Started
88
88
 
89
- In order to run **Adminator** on your local machine all what you need to do is to have the prerequisites stated below installed on your machine and follow the installation steps down below. Prebuilt static assets can be found under [releases](https://github.com/puikinsh/Adminator-admin-dashboard/releases).
89
+ You can use **Adminator** in several ways:
90
+
91
+ ### NPM Package Installation (Recommended)
92
+
93
+ Install the complete template as an npm package:
94
+
95
+ ```bash
96
+ # Install via npm
97
+ npm install adminator-admin-dashboard
98
+
99
+ # Or install via yarn
100
+ yarn add adminator-admin-dashboard
101
+ ```
102
+
103
+ **Package Information:**
104
+ - **Package Name**: `adminator-admin-dashboard`
105
+ - **Version**: 2.7.1 (jQuery-free release)
106
+ - **Size**: 5.7 MB (includes source + built assets)
107
+ - **Registry**: https://www.npmjs.com/package/adminator-admin-dashboard
108
+
109
+ **Usage after npm install:**
110
+ ```bash
111
+ # Navigate to the package directory
112
+ cd node_modules/adminator-admin-dashboard
113
+
114
+ # Install development dependencies (if you want to customize)
115
+ npm install
116
+
117
+ # Start development server
118
+ npm start
119
+ ```
120
+
121
+ **What's included in the npm package:**
122
+ - Complete source code (`src/` directory)
123
+ - Pre-built production assets (`dist/` directory)
124
+ - All dependencies and development tools
125
+ - Documentation (CLAUDE.md, CHANGELOG.md)
126
+ - Ready-to-use HTML templates
127
+
128
+ ### Local Development Setup
129
+
130
+ For development and customization, clone the repository:
90
131
 
91
132
  #### Prerequisites
92
133
  - **Node.js 18.12.0 or higher** (tested with Node.js 23.11.0)
@@ -95,8 +136,6 @@ In order to run **Adminator** on your local machine all what you need to do is t
95
136
 
96
137
  #### Installing & Local Development
97
138
 
98
- Start by typing the following commands in your terminal in order to get **Adminator** full package on your machine and starting a local development server with live reload feature.
99
-
100
139
  ```bash
101
140
  # Clone the repository
102
141
  git clone https://github.com/puikinsh/Adminator-admin-dashboard.git adminator
@@ -114,6 +153,12 @@ npm start
114
153
  npm run dev
115
154
  ```
116
155
 
156
+ ### Quick Start Options
157
+
158
+ 1. **Fastest**: Use prebuilt static assets from [releases](https://github.com/puikinsh/Adminator-admin-dashboard/releases)
159
+ 2. **Recommended**: Install via npm package for easy updates
160
+ 3. **Development**: Clone repository for full customization
161
+
117
162
  #### Development Commands
118
163
 
119
164
  ```bash
@@ -145,23 +190,23 @@ npm run lint:scss
145
190
  npm run lint
146
191
  ```
147
192
 
148
- ## πŸŒ™ Dark Mode Usage
193
+ ## Dark Mode Usage
149
194
 
150
195
  Adminator now includes a comprehensive dark mode system that works out of the box:
151
196
 
152
- ### **Automatic Setup**
197
+ ### Automatic Setup
153
198
  - Dark mode is automatically initialized on page load
154
199
  - Detects your OS preference (light/dark) on first visit
155
200
  - Remembers your choice across browser sessions
156
201
 
157
- ### **Theme Toggle**
202
+ ### Theme Toggle
158
203
  - Look for the **Light/Dark** toggle switch in the header navigation
159
204
  - Click to instantly switch between light and dark themes
160
- - Visual feedback with sun β˜€οΈ and moon πŸŒ™ icons
205
+ - Visual feedback with sun and moon icons
161
206
 
162
- ### **For Developers**
207
+ ### For Developers
163
208
 
164
- πŸ“š **[Complete Theme API Documentation β†’](https://puikinsh.github.io/Adminator-admin-dashboard/api/theme-api)**
209
+ **[Complete Theme API Documentation β†’](https://puikinsh.github.io/Adminator-admin-dashboard/api/theme-api)**
165
210
 
166
211
  **Using the Theme API:**
167
212
  ```javascript
@@ -197,17 +242,17 @@ window.addEventListener('adminator:themeChanged', (event) => {
197
242
  - `--c-border` - Border colors
198
243
  - `--c-primary` - Primary brand color
199
244
 
200
- πŸ“– **[View Complete CSS Variables Reference β†’](https://puikinsh.github.io/Adminator-admin-dashboard/customization/theme-system)**
245
+ **[View Complete CSS Variables Reference β†’](https://puikinsh.github.io/Adminator-admin-dashboard/customization/theme-system)**
201
246
 
202
247
  ## Documentation
203
248
 
204
- πŸ“š **[Complete Documentation Site](https://puikinsh.github.io/Adminator-admin-dashboard/)** - Comprehensive guides and API reference
249
+ **[Complete Documentation Site](https://puikinsh.github.io/Adminator-admin-dashboard/)** - Comprehensive guides and API reference
205
250
 
206
251
  ### Quick Links:
207
- - πŸš€ **[Installation Guide](https://puikinsh.github.io/Adminator-admin-dashboard/getting-started/installation)** - Complete setup instructions
208
- - πŸŒ™ **[Theme System](https://puikinsh.github.io/Adminator-admin-dashboard/customization/theme-system)** - Dark mode and theming
209
- - πŸ”§ **[API Reference](https://puikinsh.github.io/Adminator-admin-dashboard/api/theme-api)** - JavaScript API documentation
210
- - πŸ’‘ **[Examples](https://puikinsh.github.io/Adminator-admin-dashboard/examples/theme-integration)** - Integration examples
252
+ - **[Installation Guide](https://puikinsh.github.io/Adminator-admin-dashboard/getting-started/installation)** - Complete setup instructions
253
+ - **[Theme System](https://puikinsh.github.io/Adminator-admin-dashboard/customization/theme-system)** - Dark mode and theming
254
+ - **[API Reference](https://puikinsh.github.io/Adminator-admin-dashboard/api/theme-api)** - JavaScript API documentation
255
+ - **[Examples](https://puikinsh.github.io/Adminator-admin-dashboard/examples/theme-integration)** - Integration examples
211
256
 
212
257
  ## Adminator for other platforms and frameworks
213
258
  * [Adminator right to left](https://github.com/mortezakarimi/Adminator-admin-dashboard-rtl) - Adminator modified to work with right to left languages like Persian and Arabic
@@ -343,13 +388,13 @@ See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
343
388
 
344
389
  πŸ“š **[Online Documentation](https://puikinsh.github.io/Adminator-admin-dashboard/)** includes comprehensive guides for all features.
345
390
 
346
- #### Latest Release: V 2.7.0 (2025-07-09)
347
- - **πŸš€ 100% jQuery-Free** - Complete removal of jQuery dependency (~600KB reduction)
348
- - **⚑ Modern Vanilla JavaScript** - Class-based architecture with ES6+ features
349
- - **πŸ“Š Chart.js Integration** - Replaced jQuery Sparkline with Chart.js
350
- - **πŸ“… HTML5 Date Pickers** - Enhanced native inputs with Day.js support
351
- - **πŸ—ΊοΈ SVG Vector Maps** - Pure JavaScript world maps with theme support
352
- - **🎯 Zero Breaking Changes** - All functionality preserved with better performance
391
+ #### Latest Release: V 2.7.1 (2025-07-10)
392
+ - **100% jQuery-Free** - Complete removal of jQuery dependency (~600KB reduction)
393
+ - **Modern Vanilla JavaScript** - Class-based architecture with ES6+ features
394
+ - **Chart.js Integration** - Replaced jQuery Sparkline with Chart.js
395
+ - **HTML5 Date Pickers** - Enhanced native inputs with Day.js support
396
+ - **SVG Vector Maps** - Pure JavaScript world maps with theme support
397
+ - **Zero Breaking Changes** - All functionality preserved with better performance
353
398
 
354
399
  #### Previous Releases
355
400
  - **V 2.6.0**: Complete Dark Mode System with theme switching