English | 简体中文

一款基于 Vite 和 Tailwind CSS 构建的现代 OpenWrt LuCI 主题。

🏔️ 纯净 | 🦢 优雅 | 📱 响应式 | 🌗 深色/浅色模式 | ⚙️ 可配置

## 特性 - **现代化**：内容优先的现代化 UI 设计，布局整洁，动画优雅。 - **快且丝滑的导航体验**：在支持的浏览器上，切换页面时只更新内容、不整页刷新，切换起来丝滑流畅，加载速度大幅提升——实测页面切换中位数快约 67%（详见[路由文档](.dev/docs/router_zh.md#收益实测)）。这套无刷新切换的思路参考了 [luci-theme-footstrap](https://github.com/VizzleTF/luci-theme-footstrap)。 - **移动端友好**：针对移动端的交互和显示进行了优化，适配手机和平板设备。 - **主题切换**：内置主题切换器，支持在自动（跟随系统）、浅色和深色模式之间无缝切换。 - **命令面板（⌘K）**：在顶栏一键搜索并跳转到任意页面。 - **自定义背景**：为登录页和管理界面设置自己的壁纸。 - **悬浮工具栏**：提供可点击的图标按钮，用于快速访问常用页面。 - **可安装（PWA）**：内置 Web 应用清单（manifest）与应用图标，可将 LuCI 安装到主屏幕，像原生应用一样启动。 - **高度可定制**：[luci-app-aurora-config](https://github.com/eamonxg/luci-app-aurora-config) 插件内置 5 套主题预设，并支持自定义浅色/深色色彩令牌、导航布局（Mega Menu、下拉菜单、侧边栏）、布局间距、字体排版、品牌标识、页面背景与悬浮工具栏；还内置主题商店，可浏览与分享整套主题。 ## 预览

_{✨ 概览 — 现代 UI 与优雅动效}

## 兼容性 - **OpenWrt**：需要 OpenWrt 23.05.0 或更高版本，因为本主题使用了 ucode 模板和 LuCI JavaScript APIs。 - **浏览器**：基于 **TailwindCSS v4** 构建。兼容以下现代浏览器： - **Chrome/Edge 111+** _(2023 年 3 月发布)_ - **Safari 16.4+** _(2023 年 3 月发布)_ - **Firefox 128+** _(2024 年 7 月发布)_ - _可选增强，非必需：_ 页面间的同文档导航（点菜单不整页刷新）在支持的浏览器上使用 [Navigation API](https://developer.mozilla.org/en-US/docs/Web/API/Navigation_API)——Chrome/Edge 105+、Safari 26.2+、Firefox 147+；不支持的浏览器自动保持传统整页跳转，功能不受影响。 ## 安装以下命令均在路由器本机执行（例如通过 SSH 会话）。 ### 通过 eamonxg 软件源 ```sh wget -qO- https://openwrt.eamonxg.fun/install.sh | sh ``` 这就是全部安装步骤——脚本会添加软件源，并安装您从列表中勾选的软件包。之后用常规命令升级即可：`apk update && apk upgrade luci-theme-aurora`，或 `opkg update && opkg upgrade luci-theme-aurora`。详细信息见 [openwrt.eamonxg.fun](https://openwrt.eamonxg.fun/)。 > **apk**：若此前是从下载的 `.apk` 文件安装的，该文件会把软件包钉死在 `/etc/apk/world` 里，此后 `apk upgrade` 会静默地什么都不做——报告成功，版本却没变。执行一次 `apk add luci-theme-aurora`（只写包名，不带路径）即可解除。上面的脚本已自动处理这一步。 ### 通过 GitHub Release OpenWrt 25.12+ 和 Snapshot 版本使用 `apk`；其他版本使用 `opkg`： > **提示**：您可以运行 `opkg --version` 或 `apk --version` 来确认您的包管理器。如果有输出内容（而非 "not found"），那就是您的包管理器。 ```sh cd /tmp # opkg uclient-fetch -O luci-theme-aurora.ipk https://github.com/eamonxg/luci-theme-aurora/releases/latest/download/luci-theme-aurora_1.4.1-r20261031_all.ipk opkg install luci-theme-aurora.ipk # apk uclient-fetch -O luci-theme-aurora.apk https://github.com/eamonxg/luci-theme-aurora/releases/latest/download/luci-theme-aurora-1.4.1-r20261031.apk apk add --allow-untrusted luci-theme-aurora.apk ``` ## 从源码构建使用 OpenWrt 构建系统自行编译。主机前置条件见 [Build system setup](https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem)。产物位于 `bin/packages//base/`（例如 `bin/packages/x86_64/base/luci-theme-aurora_*_all.ipk`），拷贝到路由器后按上文方式安装即可。 ### 通过完整源码或 SDK 准备环境——克隆完整源码： ```sh # 完整源码——openwrt-24.10 分支构建 .ipk，main 分支构建 .apk git clone https://github.com/openwrt/openwrt.git cd openwrt git checkout openwrt-24.10 ``` 或 [预编译 SDK](https://openwrt.org/docs/guide-developer/toolchain/using_the_sdk)（更快，省去编译工具链）。从 [downloads.openwrt.org](https://downloads.openwrt.org) 下载与目标匹配的压缩包，下载页面按 Release 和 Snapshot 分类——Release 24.10.x 及以下构建 `.ipk`；Release 25.12+ 和 Snapshot 构建 `.apk`（文件名、架构、压缩格式因目标而异）： ```sh wget <从 downloads.openwrt.org 获取的 SDK 压缩包地址> tar -xf openwrt-sdk-*.tar.* cd openwrt-sdk-*/ ``` 然后在该目录下： ```sh # 加入本软件包并安装 feeds（提供 luci-base） git clone https://github.com/eamonxg/luci-theme-aurora.git package/luci-theme-aurora ./scripts/feeds update -a ./scripts/feeds install -a # 在 menuconfig 中勾选主题：LuCI → Themes → luci-theme-aurora make menuconfig # 用 SDK 时跳过这两行——它已自带编译好的工具链 make tools/install -j$(nproc) make toolchain/install -j$(nproc) make package/luci-theme-aurora/compile -j$(nproc) V=s ``` ## 加入贡献 Aurora 使用 **Vite** 与现代前端工具链构建，并尝试将 AI 融入开发全链路。详见[开发文档](.dev/docs/DEVELOPMENT_zh.md)。欢迎提交建议或 PR。 [discord.gg/EBncRrzfTw](https://discord.gg/EBncRrzfTw) 感谢这些出色的贡献者：

_eamonxg

_cjayacopra

_chillykidd

## 许可与致谢 [Apache 2.0](LICENSE)。致谢： - [luci-theme-bootstrap](https://github.com/openwrt/luci/tree/master/themes/luci-theme-bootstrap) - [luci-theme-footstrap](https://github.com/VizzleTF/luci-theme-footstrap) — 一个自带客户端路由的 LuCI 主题。Aurora 的同文档导航借鉴了它的部分思路，并改用 Navigation API 实现——见[路由文档](.dev/docs/router_zh.md) - [Vite](https://vitejs.dev/) - [Tailwind CSS](https://tailwindcss.com/) - [Tabler Icons](https://tabler.io/icons) — 界面图标集 - [Claude Code](https://claude.ai/code) - [Apple](https://www.apple.com/) 和 [Vercel](https://vercel.com/) — 设计灵感