You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Aigars Silkalns f20baf588e Add TypeScript migration and jQuery-free implementation files 5 months ago
.github update 1 2 years ago
ci Added verifying version before creating release 3 years ago
docs Fix documentation screenshots 6 months ago
src Add TypeScript migration and jQuery-free implementation files 5 months ago
webpack Add TypeScript migration and jQuery-free implementation files 5 months ago
.babelrc Fixed build errors 6 months ago
.editorconfig Inital release 8 years ago
.gitattributes Inital release 8 years ago
.gitignore jQuery Free Release 5 months ago
.npmignore Add TypeScript migration and jQuery-free implementation files 5 months ago
.nvmrc update 1 2 years ago
.stylelintrc.json update 1 2 years ago
CHANGELOG.md Release v2.7.1 - Minor version bump with maintenance updates 5 months ago
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md 8 years ago
LICENSE Add LICENSE file 8 years ago
README.md Release v2.7.1 - Minor version bump with maintenance updates 5 months ago
browserslist update 1 2 years ago
eslint.config.mjs Release v2.7.1 - Minor version bump with maintenance updates 5 months ago
forms.php ๐Ÿ”— Fix broken demo URLs and update remaining 2017 copyright 6 months ago
package-lock.json Add TypeScript migration and jQuery-free implementation files 5 months ago
package.json Release v2.7.1 - Minor version bump with maintenance updates 5 months ago
tsconfig.json Add TypeScript migration and jQuery-free implementation files 5 months ago
webpack.config.js Inital release 8 years ago

README.md

Adminator Bootstrap 5 Admin Template v2.7.1

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.

Latest Update (v2.7.1): 100% jQuery-Free - Complete removal of jQuery dependency (~600KB bundle reduction) with modern vanilla JavaScript implementation.

Performance Benefits: Faster load times, smaller bundle size, modern ES6+ code, and zero jQuery overhead.

Complete Documentation - Detailed setup guides, API reference, and examples

Preview of this awesome admin template available here: https://colorlib.com/polygon/adminator/index.html

Preview

Screenshots

Light Mode: Adminator Bootstrap 5 Light Mode

Dark Mode: Adminator Bootstrap 5 Dark Mode

Demo Site: Here

TOC

What's New in v2.7.1

jQuery-Free Release - Complete removal of jQuery dependency with modern vanilla JavaScript:

Major Performance Improvements

  • ~600KB Bundle Reduction: Eliminated jQuery and all jQuery-dependent plugins
  • Faster Load Times: Native DOM manipulation for optimal performance
  • Smaller Bundle Size: Significantly reduced JavaScript payload
  • Modern ES6+ Code: Class-based architecture with modern JavaScript features

jQuery Replacements (Zero Breaking Changes)

  • Chart.js: Replaced jQuery Sparkline with Chart.js mini charts
  • HTML5 Date Pickers: Enhanced native date inputs with Day.js support
  • Vanilla DataTables: Custom table component with sorting and pagination
  • SVG Pie Charts: Pure JavaScript circular progress indicators
  • Vector Maps: JavaScript-based world map with markers and interactions
  • Vanilla Popovers: Lightweight alternatives to Bootstrap JS components

Technical Achievements

  • 100% Vanilla JavaScript: No jQuery dependency anywhere in the codebase
  • Component Architecture: Modern class-based components (Sidebar, Charts, etc.)
  • Enhanced DOM Utilities: jQuery-like functionality using native JavaScript
  • Mobile Optimized: Touch-friendly interactions and responsive behavior
  • Theme Integration: All new components fully support dark/light mode switching

Previous Updates (v2.6.0 - Dark Mode System)

Dark Mode Features

  • Smart Theme Toggle: Bootstrap-based switch with sun/moon icons and intuitive labels
  • OS Preference Detection: Automatically detects and applies your preferred color scheme
  • Persistent Storage: Remembers your theme choice across browser sessions
  • Instant Switching: Real-time theme updates without page reload
  • Component Integration: All charts, calendars, maps, and UI elements are theme-aware

Technical Implementation

  • CSS Variables Architecture: Comprehensive color system with semantic naming
  • Chart.js Integration: Dynamic color schemes for all chart types
  • FullCalendar Support: Dark-mode aware calendar with proper contrast
  • Vector Maps: Custom color palettes for both light and dark themes
  • Component Compatibility: Theme support across all interactive elements

Previous Updates (v2.5.0)

  • Latest Dependencies: All 22+ dependencies updated to latest versions
  • Modern Build Tools: webpack 5.99.9, webpack-dev-server 5.2.2
  • ESLint 9.x: Migrated to modern flat config format
  • Enhanced CSS: Latest Sass (1.89.2), PostCSS (8.5.6), Bootstrap (5.3.7)
  • Updated Components: Chart.js 4.5.0, FullCalendar 6.1.17
  • Zero Vulnerabilities: Complete security audit with all packages secure

Getting Started

You can use Adminator in several ways:

Install the complete template as an npm package:

# Install via npm
npm install adminator-admin-dashboard

# Or install via yarn
yarn add adminator-admin-dashboard

Package Information:

Usage after npm install:

# Navigate to the package directory
cd node_modules/adminator-admin-dashboard

# Install development dependencies (if you want to customize)
npm install

# Start development server
npm start

What's included in the npm package:

  • Complete source code (src/ directory)
  • Pre-built production assets (dist/ directory)
  • All dependencies and development tools
  • Documentation (CLAUDE.md, CHANGELOG.md)
  • Ready-to-use HTML templates

Local Development Setup

For development and customization, clone the repository:

Prerequisites

  • Node.js 18.12.0 or higher (tested with Node.js 23.11.0)
  • npm (included with Node.js) or Yarn
  • Git

Installing & Local Development

# Clone the repository
git clone https://github.com/puikinsh/Adminator-admin-dashboard.git adminator

# Navigate to the project directory
cd adminator

# Install dependencies
npm install

# Start development server (available at http://localhost:4000)
npm start

# Alternative: Start with webpack dashboard
npm run dev

Quick Start Options

  1. Fastest: Use prebuilt static assets from releases
  2. Recommended: Install via npm package for easy updates
  3. Development: Clone repository for full customization

Development Commands

# Development server with hot reload
npm start

# Development server with dashboard
npm run dev

# Build for production (optimized)
npm run build

# Build for production (unminified)
npm run release:unminified

# Build for production (minified)
npm run release:minified

# Preview production build
npm run preview

# Lint JavaScript files
npm run lint:js

# Lint SCSS files  
npm run lint:scss

# Run all linters
npm run lint

Dark Mode Usage

Adminator now includes a comprehensive dark mode system that works out of the box:

Automatic Setup

  • Dark mode is automatically initialized on page load
  • Detects your OS preference (light/dark) on first visit
  • Remembers your choice across browser sessions

Theme Toggle

  • Look for the Light/Dark toggle switch in the header navigation
  • Click to instantly switch between light and dark themes
  • Visual feedback with sun and moon icons

For Developers

Complete Theme API Documentation โ†’

Using the Theme API:

// Get current theme
const currentTheme = Theme.current(); // 'light' or 'dark'

// Switch themes programmatically
Theme.toggle();

// Set specific theme
Theme.apply('dark');

// Listen for theme changes
window.addEventListener('adminator:themeChanged', (event) => {
  console.log('Theme changed to:', event.detail.theme);
});

CSS Variables for Custom Styling:

.my-component {
  background: var(--c-bkg-card);
  color: var(--c-text-base);
  border: 1px solid var(--c-border);
}

Available CSS Variables:

  • --c-bkg-body - Main background
  • --c-bkg-card - Card backgrounds
  • --c-text-base - Primary text color
  • --c-text-muted - Secondary text color
  • --c-border - Border colors
  • --c-primary - Primary brand color

View Complete CSS Variables Reference โ†’

Documentation

Complete Documentation Site - Comprehensive guides and API reference

Adminator for other platforms and frameworks

Files/Folders Structure

Here is a brief explanation of the template folder structure and some of its main files usage:

โ””โ”€โ”€ src                         # Contains all template source files.
โ”‚   โ””โ”€โ”€ assets                  # Contains JS, CSS, images and icon fonts.
โ”‚   โ”‚   โ””โ”€โ”€ scripts             # Contains all JavaScript files.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ charts          # Chart.js, Sparkline & Pie Chart plugins init.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ chat            # All chat app JS code.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ constants       # Template constant values like color values.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ datatable       # Date table plugin init.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ datepicker      # Bootstrap datepicker init.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ email           # All email app code.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ fullcalendar    # Fullcalendar plugin init.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ googleMaps      # Google maps API integration code.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ masonry         # Masonry layout code.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ popover         # Bootstrap popover plugin init.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ scrollbar       # Perfect scrollbar plugin init.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ search          # Topbar toggle search init.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ sidebar         # Sidebar JS code.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ skycons         # Animated icons plugin init.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ utils           # Basic utils used for proper rendering.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ vectorMaps      # Vector maps plugin init.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ app.js          # Main application entry point.
โ”‚   โ”‚   โ”‚
โ”‚   โ”‚   โ””โ”€โ”€ static              # Contains the non-code files.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ fonts           # Contains icon fonts.
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ images          # Contains all template images/svg.
โ”‚   โ”‚   โ”‚
โ”‚   โ”‚   โ””โ”€โ”€ styles              # Contains all SCSS files.
โ”‚   โ”‚       โ””โ”€โ”€ spec            # Contains custom SCSS files.
โ”‚   โ”‚       โ”‚   โ””โ”€โ”€ components  # Contains all template components.
โ”‚   โ”‚       โ”‚   โ””โ”€โ”€ generic     # Contains basic scaffolding styles.
โ”‚   โ”‚       โ”‚   โ””โ”€โ”€ screens     # Contains views specific styles.
โ”‚   โ”‚       โ”‚   โ””โ”€โ”€ settings    # Contains all template variables.
โ”‚   โ”‚       โ”‚   โ””โ”€โ”€ tools       # Contains all mixins.
โ”‚   โ”‚       โ”‚   โ””โ”€โ”€ utils       # Contains helper classes.
โ”‚   โ”‚       โ”‚   โ””โ”€โ”€ index.scss  # Indicator file.
โ”‚   โ”‚       โ”‚
โ”‚   โ”‚       โ””โ”€โ”€ vendor          # Contains all plugin files & custom styles.
โ”‚   โ”‚       โ””โ”€โ”€ index.scss      # Main style entry point.
โ”‚   โ”‚
โ”‚   โ””โ”€โ”€ *.html                  # All HTML template pages.
โ””โ”€โ”€ webpack                     # Contains Webpack configuration.
โ”‚   โ””โ”€โ”€ plugins                 # Contains all Webpack plugins config.
โ”‚   โ””โ”€โ”€ rules                   # Contains Webpack loaders config.
โ”‚   โ””โ”€โ”€ config.js               # Main Webpack configuration.
โ”‚   โ””โ”€โ”€ devServer.js            # Development server configuration.
โ”‚   โ””โ”€โ”€ manifest.js             # Build system constants.
โ”‚
โ””โ”€โ”€ .babelrc                    # Babel ES6 transpiler configuration.
โ””โ”€โ”€ .editorconfig               # Code editor consistency settings.
โ””โ”€โ”€ eslint.config.mjs           # ESLint 9.x flat configuration.
โ””โ”€โ”€ .gitattributes              # Git attributes configuration.
โ””โ”€โ”€ .gitignore                  # Git ignore patterns.
โ””โ”€โ”€ .stylelintrc.json           # SCSS/CSS linting configuration.
โ””โ”€โ”€ browserslist                # Supported browsers configuration.
โ””โ”€โ”€ CHANGELOG.md                # Version history and updates.
โ””โ”€โ”€ package.json                # Node.js package configuration.
โ””โ”€โ”€ README.md                   # This documentation file.
โ””โ”€โ”€ webpack.config.js           # Webpack entry configuration.

Deployment

In deployment process, you have several commands:

  1. Production Build - Generate optimized assets for production:
npm run build
  1. Production Preview - Preview the production build locally:
npm run preview
  1. Custom Builds:
# Unminified production build (for debugging)
npm run release:unminified

# Minified production build (smallest size)
npm run release:minified

The built files will be available in the dist/ directory.

Built With

Core Framework & Build Tools

UI Components & Charts

JavaScript Libraries

Icons & Fonts

Additional Plugins

  • HTML5 Date Inputs - Enhanced native date pickers (replaces Bootstrap Datepicker)
  • Skycons - Animated weather icons
  • Load Google Maps API - Maps integration

Changelog

See CHANGELOG.md for detailed version history.

๐Ÿ“š Online Documentation includes comprehensive guides for all features.

Latest Release: V 2.7.1 (2025-07-10)

  • 100% jQuery-Free - Complete removal of jQuery dependency (~600KB reduction)
  • Modern Vanilla JavaScript - Class-based architecture with ES6+ features
  • Chart.js Integration - Replaced jQuery Sparkline with Chart.js
  • HTML5 Date Pickers - Enhanced native inputs with Day.js support
  • SVG Vector Maps - Pure JavaScript world maps with theme support
  • Zero Breaking Changes - All functionality preserved with better performance

Previous Releases

  • V 2.6.0: Complete Dark Mode System with theme switching
  • V 2.5.0: Updated all dependencies, ESLint 9.x, zero vulnerabilities
  • V 2.1.0: Upgraded all dependencies
  • V 2.0.0: Upgrade to Bootstrap 5
  • V 1.1.0: Upgrade to webpack 5
  • V 1.0.0: Initial Release

Authors

Colorlib

More info

License

Adminator is licensed under The MIT License (MIT). Which means that you can use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the final products. But you always need to state that Colorlib is the original author of this template.