Skip to content

puikinsh/Bootstrap-Admin-Template

Repository files navigation

Metis - Modern Bootstrap 5 Admin Dashboard Template

A completely modernized, powerful, and free Bootstrap 5 admin dashboard template built with cutting-edge web technologies.

⚑ Major Version 3.0 Release - Complete rewrite with Bootstrap 5, modern JavaScript (ES6+), Alpine.js, SCSS, and Vite build system.

Metis Bootstrap Admin Dashboard

πŸš€ View Live Demo

License: MIT Bootstrap Node.js

✨ Features

🎨 Modern Design System

  • Bootstrap 5.3.7 - Latest version with all modern utilities
  • CSS Custom Properties - Full theme customization support
  • Dark/Light Mode - Seamless theme switching with localStorage persistence
  • Responsive First - Mobile-optimized layouts across all devices
  • Modern Typography - Inter font family for enhanced readability

πŸš€ Advanced Technology Stack

  • Alpine.js - Lightweight reactive framework for modern interactions
  • ES6+ JavaScript - Modern JavaScript with modules and async/await
  • Vite Build System - Lightning-fast development and optimized production builds
  • SCSS Architecture - Organized, scalable stylesheet structure
  • Bootstrap Icons - 1,800+ high-quality SVG icons

πŸ“Š Comprehensive Dashboard Pages

  • πŸ“ˆ Analytics Dashboard - Charts, KPIs, and data visualization
  • πŸ‘₯ User Management - Complete CRUD operations with modern forms
  • πŸ“¦ Product Management - E-commerce ready product listings
  • πŸ›’ Order Management - Order tracking and status management
  • πŸ“ File Manager - Modern file browser with upload/download
  • πŸ“… Calendar - Full-featured event management
  • πŸ’¬ Messages - Chat interface with real-time styling
  • πŸ“Š Reports - Data tables with filtering and export
  • βš™οΈ Settings - Comprehensive admin configuration
  • πŸ”’ Security - User permissions and security settings
  • ❓ Help & Support - FAQ, documentation, and support tickets

πŸ› οΈ Developer Experience

  • Hot Module Replacement - Instant development feedback
  • TypeScript Ready - Full TypeScript support (optional)
  • Component Architecture - Modular, reusable JavaScript components
  • Modern Build Pipeline - Optimized assets with automatic minification
  • Developer Tools - Source maps, linting, and debugging support

πŸš€ Quick Start

Prerequisites

  • Node.js 18+ (recommend using nvm)
  • npm or yarn package manager

Installation

# Clone the repository
git clone https://github.com/puikinsh/Bootstrap-Admin-Template.git metis-admin
cd metis-admin

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

πŸ“ Project Structure

metis-admin/
β”œβ”€β”€ src-modern/                 # Modern source files
β”‚   β”œβ”€β”€ *.html                 # Page templates
β”‚   β”œβ”€β”€ scripts/               # JavaScript modules
β”‚   β”‚   β”œβ”€β”€ components/        # Page-specific components
β”‚   β”‚   β”œβ”€β”€ utils/            # Utility functions
β”‚   β”‚   └── main.js           # Application entry point
β”‚   β”œβ”€β”€ styles/               # SCSS stylesheets
β”‚   β”‚   β”œβ”€β”€ abstracts/        # Variables, mixins, utilities
β”‚   β”‚   β”œβ”€β”€ components/       # UI component styles
β”‚   β”‚   β”œβ”€β”€ layout/          # Layout-specific styles
β”‚   β”‚   β”œβ”€β”€ pages/           # Page-specific styles
β”‚   β”‚   └── themes/          # Theme variants
β”‚   └── assets/              # Static assets
β”œβ”€β”€ dist-modern/             # Production build output
β”œβ”€β”€ node_modules/           # Dependencies
β”œβ”€β”€ package.json           # Project configuration
β”œβ”€β”€ vite.config.js         # Build configuration
└── README.md              # This file

🎯 Available Scripts

# Development
npm run dev          # Start development server with HMR
npm run dev:host     # Start dev server accessible on network

# Production
npm run build        # Create optimized production build
npm run preview      # Preview production build locally

# Maintenance
npm run clean        # Clean build artifacts

🎨 Customization

Theme Customization

Edit src-modern/styles/scss/abstracts/_variables.scss:

// Brand Colors
$primary: #6366f1;    // Your brand primary color
$secondary: #64748b;  // Secondary color
$success: #10b981;    // Success state color

// Typography
$font-family-sans-serif: "Inter", system-ui, sans-serif;
$font-size-base: 0.9rem;

// Spacing & Layout
$border-radius: 0.75rem;
$box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);

Adding New Pages

  1. Create HTML file in src-modern/
  2. Add corresponding SCSS in src-modern/styles/scss/pages/
  3. Create JavaScript component in src-modern/scripts/components/
  4. Register in src-modern/scripts/main.js

Component Development

// src-modern/scripts/components/example.js
import Alpine from 'alpinejs';

document.addEventListener('alpine:init', () => {
  Alpine.data('exampleComponent', () => ({
    // Component state and methods
    init() {
      console.log('Example component initialized');
    }
  }));
});

🌟 Key Improvements in v3.0

From v2.x to v3.0

  • βœ… Bootstrap 3 β†’ Bootstrap 5 - Complete framework upgrade
  • βœ… jQuery β†’ Alpine.js - Modern, lightweight reactive framework
  • βœ… LESS β†’ SCSS - More powerful styling with better tooling
  • βœ… Gulp β†’ Vite - Lightning-fast build system with HMR
  • βœ… ES5 β†’ ES6+ - Modern JavaScript with modules and async/await
  • βœ… Old Icons β†’ Bootstrap Icons - 1,800+ modern SVG icons
  • βœ… Static β†’ Interactive - Rich, app-like user interactions
  • βœ… Fixed β†’ Responsive - Mobile-first, adaptive layouts
  • βœ… Basic β†’ Advanced - Professional dashboard features

Performance Improvements

  • 90%+ Lighthouse Score - Optimized for Core Web Vitals
  • Tree Shaking - Only load code you actually use
  • Code Splitting - Lazy load components for faster initial loads
  • Asset Optimization - Automatic image and CSS optimization
  • Modern Bundle - ES6+ for modern browsers with optimal tree-shaking

πŸ›‘οΈ Browser Support

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

IE11 is not supported.

πŸ“š Documentation & Resources

🀝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Copyright (c) 2025 Aigars Silkalns & Colorlib

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

πŸ™ Credits & Attribution

Core Technologies

Design Resources

  • Inter Font - Modern typeface designed for computer screens
  • Heroicons - Additional beautiful hand-crafted SVG icons

πŸ‘₯ About the Authors

Colorlib - The most popular source for free WordPress themes and HTML templates.

Aigars Silkalns - Project maintainer and founder of Colorlib.

πŸ”— Related Projects


⭐ Star this repository if you found it helpful!

Built with ❀️ by the Colorlib team