프로젝트 소개

AdminLTE는 AdminLTE.io에서 MIT 라이선스로 배포하는 오픈 소스 관리자 대시보드 UI 템플릿입니다. 본 저장소는 HTML/Bootstrap 코어 에디션이며, 동일한 디자인이 다른 스택을 위한 별도의 저장소로도 유지 관리됩니다. 기술 및 레이아웃 - Bootstrap 5.3과 vanilla JavaScript를 기반으로 구축되었으며, v4에서는 jQuery 의존성이 제거되었습니다. - 소형 모바일 화면부터 대형 데스크톱까지 적합하도록 설계된 반응형 레이아웃을 제공합니다. - 다크 모드는 커스텀 body 클래스 대신 Bootstrap 5.3의 네이티브 data-bs-theme 속성을 사용합니다. - RTL 지원 및 선택 가능한 컬러 스타일시트를 제공합니다: dist/css/adminlte-colors.css(재설계된 색상, 흰색 텍스트 가독성, 17가지 스킨 프리셋 및 브랜딩을 위한 data-lte-primary 훅) 또는 AdminLTE 3의 18가지 색상을 유지하는 dist/css/adminlte-colors-v3.css를 사용할 수 있습니다. adminlte.css에는 아무것도 추가되지 않습니다. 설치 및 개발 - CDN: jsDelivr에서 admin-lte@4 CSS 및 JS를 링크하여 빌드 단계 없이 사용 가능합니다. - npm: npm install admin-lte@4. - Composer: composer require almasaeed2010/adminlte. - AdminLTE 자체 개발: npm install 후 npm start를 통해 3000번 포트에서 라이브 리로드 개발 서버를 실행합니다. 개발 자산은 npm run build, 전체 린트, 최적화 및 bundlewatch 파이프라인은 npm run production으로 실행합니다. 별도의 npm run css, npm run js, npm run lint 작업이 문서화되어 있습니다. v4 변경 사항 v4 라인은 README에서 jQuery 없이 Bootstrap 5.3으로 완전히 새로 작성된 것으로 설명됩니다. 18개의 데모 페이지가 추가되었으며 문서가 개편되었습니다. 데모 페이지에는 앱(FullCalendar 기반 캘린더, SortableJS 기반 칸반, 채팅, 파일 관리자, 프로젝트, 메일함), 폼(유효성 검사가 포함된 4단계 위저드), 테이블(jQuery 없는 Tabulator 기반 데이터 테이블), 페이지(프로필, 설정, 송장, 가격 책정, FAQ) 및 에러 페이지(404, 500, 유지보수)가 포함됩니다. 4.3 릴리스 노트에서는 입력 시 사이드바 메뉴를 필터링하고 일치하는 서브메뉴를 확장하며 초기화 시 메뉴를 복구하는 SidebarSearch 플러그인, RTL에서 미러링되는 세 가지 크기의 리본 코너 배너, 소셜 및 포스트 위젯(.user-block, .post, .widget-user, .widget-user-2, .description-block), 그리고 세 가지 새로운 데모 페이지(갤러리, 검색 결과, 리본)를 언급합니다. 일반 UI 쇼케이스에 내비게이션 탭, 모달, 오프캔버스가 추가되었으며, CSS가 제공되는 모든 컴포넌트에 참조 페이지가 있도록 카드, 기타 및 언어 전환 페이지가 문서에 추가되었습니다. v3에서 마이그레이션 README에는 다음과 같은 파괴적 변경 사항이 나열되어 있습니다: .wrapper → .app-wrapper, .main-header → .app-header, .main-sidebar → .app-sidebar, .content-wrapper → .app-main과 같은 클래스 이름 변경; data-toggle → data-bs-toggle, data-widget="pushmenu" → data-lte-toggle="sidebar" 및 트리뷰에 대한 동일한 변경과 같은 데이터 속성 변경; 다크 모드의 data-bs-theme 이동 등이 있습니다. 번들된 plugins/ 폴더가 제거되었으며, 각 v3 jQuery 위젯을 vanilla-JS 후속 제품으로 매핑하는 대체 테이블이 제공됩니다(예: Select2 → Tom Select, DataTables → Tabulator, Summernote → Quill). 프레임워크 에디션 별도의 저장소를 통해 React 및 Next.js, Vue 3 및 Nuxt, Laravel(Blade 컴포넌트, 설정 기반 메뉴, 인증 스캐폴딩), Django(재사용 가능한 앱, 메뉴 필터 파이프라인, 테마 적용된 관리자), Symfony(Twig 컴포넌트, AssetMapper, EasyAdmin 테마), Angular, ASP.NET Core(Blazor 컴포넌트 및 MVC/Razor Pages 태그 헬퍼) 및 Drupal에 동일한 대시보드가 통합되어 있습니다. 각 에디션은 자체 패키지 관리자 진입점을 통해 설치됩니다. 배포 및 보안 AdminLTE는 UI 템플릿입니다. 운영 배포 시에는 컴파일된 dist 자산과 애플리케이션 파일만 배포해야 하며, node_modules, 데모 HTML 페이지 또는 src/는 절대 배포해서는 안 됩니다. README에서는 CVE-2021-36471이 논쟁 중이며, 이는 예제 파일이 잘못 배포되었을 때 데모 페이지에 접근 가능한 상황을 지칭한다고 명시하고 있습니다. 또한 SECURITY.md에 인증 및 모범 사례에 대한 상세 가이드가 포함되어 있습니다. 브라우저 지원, 기여 및 라이선스 Bootstrap 5.3은 최신 버전의 Chrome, Firefox, Safari 및 Edge를 지원하며, 빌드 스크립트는 Windows, macOS, Linux 전반에서 교차 플랫폼으로 작동합니다. 기여는 master 브랜치를 대상으로 하며, Node.js LTS 설치, npm install 및 npm start 실행, 커밋 전 린트 수행 후 풀 리퀘스트를 생성합니다. 프로젝트는 MIT 라이선스를 따르며, README에는 무료 에디션과 함께 프리미엄 템플릿, GitHub Sponsors 또는 PayPal 기부 옵션이 안내되어 있습니다.