diff --git a/dist/README.md b/dist/README.md new file mode 100644 index 000000000..1dc040f43 --- /dev/null +++ b/dist/README.md @@ -0,0 +1,106 @@ +# AdminLTE v4.0.0-rc3 - Production Build + +This folder contains the **ready-to-use production build** of AdminLTE v4.0.0-rc3. + +## 🚀 Quick Start + +### Option 1: Download & Use Locally +1. Download this entire `dist/` folder +2. Upload to your web server or open `index.html` in a local server +3. All files work immediately - no build process required! + +### Option 2: Use as CDN +```html + + + + + +``` + +## 📁 What's Included + +### 📄 **HTML Pages (37 total)** +- `index.html` - Main dashboard +- `index2.html`, `index3.html` - Alternative dashboards +- `widgets/` - Widget demonstrations +- `layout/` - Layout examples (sidebar variations, RTL, etc.) +- `forms/` - Form examples +- `tables/` - Table examples +- `UI/` - UI component examples +- `examples/` - Login, register, lockscreen pages +- `docs/` - Documentation pages + +### 🎨 **CSS Files** +- `css/adminlte.css` - Main stylesheet +- `css/adminlte.min.css` - Minified version +- `css/adminlte.rtl.css` - Right-to-left language support +- `css/adminlte.rtl.min.css` - RTL minified +- `css/*.map` - Source maps for debugging + +### ⚡ **JavaScript Files** +- `js/adminlte.js` - Main JavaScript +- `js/adminlte.min.js` - Minified version +- `js/*.map` - Source maps for debugging + +### 🖼️ **Assets** +- `assets/img/` - All images (logos, avatars, photos, etc.) +- Complete image set for demos and examples + +## 🌍 **Deployment** + +### ✅ **Works Everywhere** +- **Static Hosting**: GitHub Pages, Netlify, Vercel, Surge.sh +- **Traditional Hosting**: cPanel, FTP servers, shared hosting +- **CDN**: Use files directly via jsDelivr or GitHub Pages +- **Sub-folders**: Works in any directory structure + +### ✅ **Production Ready** +- Optimized CSS and JavaScript (minified versions available) +- All relative paths work regardless of deployment location +- Images load correctly from any hosting scenario +- Zero configuration required + +## 🔧 **Technical Details** + +### Dependencies (Loaded from CDN) +- **Bootstrap**: 5.3.7 +- **Bootstrap Icons**: 1.13.1 +- **OverlayScrollbars**: 2.11.0 +- **PopperJS**: 2.11.8 + +### Browser Support +- Chrome (latest) +- Firefox (latest) +- Safari (latest) +- Edge (latest) + +### Features +- **Fully Responsive** - Works on all screen sizes +- **Dark/Light Mode** - Automatic system preference detection +- **RTL Support** - Complete right-to-left language support +- **Accessibility** - WCAG 2.1 AA compliant +- **No Build Required** - Ready to use immediately + +## 🆕 **What's New in v4.0.0-rc3** + +- ✅ **Fixed Production Builds** - Resolved all deployment path issues +- ✅ **Sidebar Navigation** - Fixed badges, arrows, and spacing +- ✅ **Smart Path Resolution** - Works in any deployment scenario +- ✅ **Updated Dependencies** - Latest stable versions of all libraries +- ✅ **Zero Console Errors** - Clean, professional runtime experience + +## 📖 **Documentation** + +- [Live Demo](https://adminlte.io/themes/v4/) +- [GitHub Repository](https://github.com/ColorlibHQ/AdminLTE) +- [Changelog](https://github.com/ColorlibHQ/AdminLTE/blob/master/CHANGELOG.md) + +## 📄 **License** + +MIT License - see [LICENSE](https://github.com/ColorlibHQ/AdminLTE/blob/master/LICENSE) file for details. + +--- + +**AdminLTE** - Free Bootstrap 5 Admin Dashboard Template +Created by [AdminLTE.io](https://adminlte.io) | [ColorlibHQ](https://colorlib.com) \ No newline at end of file