Skip to content

Adminator is easy to use and well design admin dashboard template based on Bootstrap 5 with dark mode for web apps, websites, services and more

License

Notifications You must be signed in to change notification settings

puikinsh/Adminator-admin-dashboard

Repository files navigation

Adminator Bootstrap 5 Admin Template v2.6.0

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.6.0): Complete Dark Mode System with smart theme switching, OS preference detection, and seamless component integration.

πŸŒ™ Dark Mode Features: Automatic theme detection, persistent user preferences, theme-aware components (charts, calendars, maps), and a beautiful toggle switch.

πŸ“š 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.6.0

πŸŒ™ Dark Mode Release - Complete dark mode system with seamless theme switching:

🎨 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

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.

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

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.

# 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

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

Quick Links:

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

Changelog

See CHANGELOG.md for detailed version history.

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

Latest Release: V 2.6.0 (2025-01-19)

  • πŸŒ™ Complete Dark Mode System with intelligent theme switching
  • 🎨 CSS Variables Architecture for comprehensive theming
  • πŸ“Š Component Integration - Charts, calendars, and maps are theme-aware
  • ⚑ Smart Toggle with OS preference detection
  • πŸ’Ύ Persistent Storage remembers user theme choice

Previous Releases

  • 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.

About

Adminator is easy to use and well design admin dashboard template based on Bootstrap 5 with dark mode for web apps, websites, services and more

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published