7d4c893296
🎉 Major modernization release bringing AdminLTE to current standards ## Key Improvements: - 🔒 Zero security vulnerabilities (all dependencies updated) - ⚡ ESLint v9 with modern flat configuration - 📦 Astro 5.x, Bootstrap 5.3.7, 50+ package updates - 🛠️ New npm scripts: 'npm start', 'npm run build' - 🧹 700+ linting issues resolved, technical debt cleaned - 🎯 ES modules, modern tooling, optimal bundles ## Infrastructure: - Upgraded to ES modules with proper configurations - Migrated ESLint to v9 flat config format - Enhanced build scripts and developer experience - Added comprehensive CHANGELOG.md - Updated README.md with v4.0.0-rc1 highlights ## Quality & Security: - All npm vulnerabilities resolved - Zero linting errors across JS/TS/CSS/Astro - Updated browserslist and build dependencies - Removed deprecated patterns and dead code ## Compatibility: - No breaking changes for end users - Full Bootstrap 5.3.7 compatibility maintained - All HTML templates remain compatible - Enhanced developer experience with modern tooling See CHANGELOG.md for complete details.
100 lines
4.3 KiB
Markdown
100 lines
4.3 KiB
Markdown
# [AdminLTE - Bootstrap 5 Admin Dashboard](https://adminlte.io)
|
|
|
|
[](https://www.npmjs.com/package/admin-lte)
|
|
[](https://packagist.org/packages/almasaeed2010/adminlte)
|
|
[](https://www.jsdelivr.com/package/npm/admin-lte)
|
|
[](https://discord.gg/jfdvjwFqfz)
|
|
[](https://app.netlify.com/sites/adminlte-v4/deploys)
|
|
|
|
**AdminLTE** is a fully responsive administration template. Based on **[Bootstrap 5](https://getbootstrap.com/)** framework and also the JavaScript plugins.
|
|
Highly customizable and easy to use. Fits many screen resolutions from small mobile devices to large desktops.
|
|
|
|
## ✨ What's New in v4.0.0-rc1
|
|
|
|
🚀 **Major Modernization Release** - AdminLTE has been completely modernized with:
|
|
|
|
- **🔒 Zero Security Vulnerabilities** - All dependencies updated and vulnerabilities resolved
|
|
- **⚡ Modern Tooling** - ESLint v9, Astro 5.x, latest Stylelint and build tools
|
|
- **🛠️ Better Developer Experience** - New `npm start` command, improved scripts, cleaner builds
|
|
- **📦 Latest Dependencies** - Bootstrap 5.3.7, Node.js ES modules, 50+ package updates
|
|
- **🧹 Code Quality** - Zero linting errors, removed technical debt, standardized formatting
|
|
- **🎯 Future-Ready** - Modern configuration patterns, optimal bundle sizes, enhanced maintainability
|
|
|
|
See the [CHANGELOG.md](CHANGELOG.md) for complete details.
|
|
|
|
## Looking for Premium Templates?
|
|
|
|
AdminLTE.io just opened a new premium templates page. Hand picked to ensure the best quality and the most affordable
|
|
prices. Visit <https://adminlte.io/premium> for more information.
|
|
|
|
|
|
|
|
**AdminLTE** has been carefully coded with clear comments in all of its JS, SCSS and HTML files.
|
|
SCSS has been used to increase code customizability.
|
|
|
|
## Quick start
|
|
|
|
### Development
|
|
|
|
To start developing with AdminLTE:
|
|
|
|
1. **Install dependencies:** `npm install`
|
|
2. **Start development server:** `npm start` *(opens browser at http://localhost:3000)*
|
|
3. **Start coding!** Files auto-compile and refresh on changes
|
|
|
|
### Production Build
|
|
|
|
To build for production:
|
|
|
|
1. **Full production build:** `npm run production` *(includes linting and optimization)*
|
|
2. **Quick build:** `npm run build` *(faster for development/testing)*
|
|
|
|
### Available Scripts
|
|
|
|
- `npm start` - Start development server with file watching
|
|
- `npm run build` - Build all assets for development
|
|
- `npm run production` - Full production build with linting and bundlewatch
|
|
- `npm run lint` - Run all linters (JS, CSS, docs, lockfile)
|
|
- `npm run css` - Build CSS only
|
|
- `npm run js` - Build JavaScript only
|
|
|
|
## Browser Support
|
|
|
|
AdminLTE supports all modern browsers with the latest Bootstrap 5.3.7:
|
|
- Chrome (latest)
|
|
- Firefox (latest)
|
|
- Safari (latest)
|
|
- Edge (latest)
|
|
|
|
## Contributing
|
|
|
|
- Highly welcome.
|
|
- For your extra reference check [AdminLTE v4 Contribution Guide](https://github.com/ColorlibHQ/AdminLTE#contributing)
|
|
- First thing first, you should have bit knowledge about NodeJS.
|
|
- Github Knowledge.
|
|
- Install NodeJS LTS version.
|
|
- Clone this Repository to your machine and change to `master` branch.
|
|
- Go to Cloned Folder.
|
|
- In cli/bash run `npm install` it will install dependency from `package.json`.
|
|
- After installation completes, run `npm start`
|
|
- Cool, Send your changes in PR to `master` branch.
|
|
|
|
## Sponsorship
|
|
|
|
Support AdminLTE development by becoming a sponsor.
|
|
[Github Sponsors](https://github.com/sponsors/danny007in) or
|
|
[PayPal](https://www.paypal.me/daniel007in)
|
|
|
|
## License
|
|
|
|
AdminLTE is an open source project by [AdminLTE.io](https://adminlte.io) that is licensed under [MIT](https://opensource.org/licenses/MIT).
|
|
AdminLTE.io reserves the right to change the license of future releases.
|
|
|
|
## Image Credits
|
|
|
|
- [Pixeden](http://www.pixeden.com/psd-web-elements/flat-responsive-showcase-psd)
|
|
- [Graphicsfuel](https://www.graphicsfuel.com/2013/02/13-high-resolution-blur-backgrounds/)
|
|
- [Pickaface](https://pickaface.net/)
|
|
- [Unsplash](https://unsplash.com/)
|
|
- [Uifaces](http://uifaces.com/)
|