mirror of
https://github.com/kiddin9/op-packages.git
synced 2026-09-13 20:04:45 +08:00
156 lines
8.2 KiB
Markdown
156 lines
8.2 KiB
Markdown
<h4 align="right"><strong>English</strong> | <a href="README_zh.md">简体中文</a></h4>
|
||
<p align="center">
|
||
<img src="https://raw.githubusercontent.com/eamonxg/assets/master/aurora/logo/logo-lockup.png" width="360" alt="Aurora Theme"/>
|
||
</p>
|
||
<p align="center"><strong>A modern OpenWrt LuCI theme built with Vite and Tailwind CSS.</strong></p>
|
||
<h4 align="center">🏔️ Pure | 🦢 Elegant | 📱 Responsive | 🌗 Dark/Light Mode | ⚙️ Settable </h4>
|
||
<div align="center">
|
||
<a href="https://openwrt.org"><img alt="OpenWrt" src="https://img.shields.io/badge/OpenWrt-%E2%89%A523.05-00B5E2?logo=openwrt&logoColor=white"></a>
|
||
<a href="https://www.google.com/chrome/"><img alt="Chrome" src="https://img.shields.io/badge/Chrome-%E2%89%A5111-4285F4?logo=googlechrome&logoColor=white"></a>
|
||
<a href="https://www.apple.com/safari/"><img alt="Safari" src="https://img.shields.io/badge/Safari-%E2%89%A516.4-000000?logo=safari&logoColor=white"></a>
|
||
<a href="https://www.mozilla.org/firefox/"><img alt="Firefox" src="https://img.shields.io/badge/Firefox-%E2%89%A5128-FF7139?logo=firefoxbrowser&logoColor=white"></a>
|
||
<a href="https://github.com/eamonxg/luci-theme-aurora/releases/latest"><img alt="GitHub release" src="https://img.shields.io/github/v/release/eamonxg/luci-theme-aurora"></a>
|
||
<a href="https://github.com/eamonxg/luci-theme-aurora/releases"><img alt="Downloads" src="https://img.shields.io/github/downloads/eamonxg/luci-theme-aurora/total"></a>
|
||
<a href="https://discord.gg/EBncRrzfTw"><img alt="Discord" src="https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white"></a>
|
||
<a href="#contributing"><img alt="Contributors" src="https://img.shields.io/github/contributors/eamonxg/luci-theme-aurora?color=orange"></a>
|
||
</div>
|
||
|
||
<div align="center">
|
||
<img src="https://raw.githubusercontent.com/eamonxg/assets/master/aurora/preview/theme/multi-device-showcase.png" alt="Multi-Device Showcase" width="100%">
|
||
</div>
|
||
|
||
|
||
## Features
|
||
|
||
- **Modern**: Modern, content-first UI design with a clean layout and elegant animations.
|
||
- **Mobile-friendly**: Optimized for mobile interactions and display, supporting both smartphones and tablets.
|
||
- **Theme Switcher**: Built-in theme switcher with seamless switching between Auto (system), Light, and Dark modes.
|
||
- **Floating Toolbar**: Clickable button icons for quick access to frequently used pages.
|
||
- **Installable (PWA)**: Ships a web app manifest and app icons, so LuCI can be installed to your home screen and launched like a native app.
|
||
- **Customizable**: The [luci-app-aurora-config](https://github.com/eamonxg/luci-app-aurora-config) plugin includes multiple built‑in theme presets you can switch between, and lets you customize Light/Dark color tokens, the navigation layout (Mega Menu, Dropdown, Sidebar), layout density, typography, branding (logo, favicons, login background), and the floating toolbar (add or edit frequently used pages).
|
||
|
||
## Preview
|
||
|
||
<div align="center">
|
||
<img src="https://raw.githubusercontent.com/eamonxg/assets/master/aurora/preview/theme/preview-demo.gif" alt="Theme Demo" width="100%">
|
||
<br>
|
||
<sub><strong>✨ Overview</strong>— Modern UI & Elegant Animations</sub>
|
||
</div>
|
||
|
||
<br>
|
||
|
||
<div align="center">
|
||
<img src="https://raw.githubusercontent.com/eamonxg/assets/master/aurora/preview/theme/dark-light-preview.png" alt="Dark and Light Preview" width="49%">
|
||
<img src="https://raw.githubusercontent.com/eamonxg/assets/master/aurora/preview/theme/mobile-preview.png" alt="Mobile Preview" width="49%">
|
||
</div>
|
||
|
||
## Compatibility
|
||
|
||
- **OpenWrt**: Requires OpenWrt 23.05.0 or later, as the theme uses ucode templates and LuCI JavaScript APIs.
|
||
- **Browsers**: Built with **TailwindCSS v4**. Compatible with the following modern browsers:
|
||
- **Chrome/Edge 111+** _(released March 2023)_
|
||
- **Safari 16.4+** _(released March 2023)_
|
||
- **Firefox 128+** _(released July 2024)_
|
||
|
||
## Installation
|
||
|
||
Run these commands on the router itself (e.g. over an SSH session).
|
||
|
||
### Via the eamonxg package feed
|
||
|
||
```sh
|
||
wget -qO- https://openwrt.eamonxg.fun/install.sh | sh
|
||
```
|
||
|
||
That is the whole installation — the script adds the feed and installs whatever you tick from the list it shows. Upgrade later with the usual commands: `apk update && apk upgrade luci-theme-aurora`, or `opkg update && opkg upgrade luci-theme-aurora`. Details: [openwrt.eamonxg.fun](https://openwrt.eamonxg.fun/).
|
||
|
||
### Via a GitHub release
|
||
|
||
OpenWrt 25.12+ and snapshots use `apk`; other versions use `opkg`:
|
||
|
||
> **Tip**: You can confirm your package manager by running `opkg --version` or `apk --version`. If it returns output (not "not found"), that's your package manager.
|
||
|
||
```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.1.0-r20260711_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.1.0-r20260711.apk
|
||
apk add --allow-untrusted luci-theme-aurora.apk
|
||
```
|
||
|
||
## Build from source
|
||
|
||
Build the package yourself with the OpenWrt build system. Host prerequisites: [Build system setup](https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem). The build writes the package to `bin/packages/<arch>/base/` (e.g. `bin/packages/x86_64/base/luci-theme-aurora_*_all.ipk`); copy it to your router and install it as above.
|
||
|
||
### Via the full source tree or SDK
|
||
|
||
Get set up — clone the full source tree:
|
||
|
||
```sh
|
||
# Full source tree — the openwrt-24.10 branch builds an .ipk, the main branch builds an .apk
|
||
git clone https://github.com/openwrt/openwrt.git
|
||
cd openwrt
|
||
git checkout openwrt-24.10
|
||
```
|
||
|
||
Or the [prebuilt SDK](https://openwrt.org/docs/guide-developer/toolchain/using_the_sdk) (faster: skips building the toolchain). Grab the archive for your target from [downloads.openwrt.org](https://downloads.openwrt.org), which splits SDKs into Release and Snapshot builds — Release 24.10.x and earlier build `.ipk`; Release 25.12+ and Snapshot build `.apk` (filename, arch and compression vary by target):
|
||
|
||
```sh
|
||
wget <sdk-archive-url-from-downloads.openwrt.org>
|
||
tar -xf openwrt-sdk-*.tar.*
|
||
cd openwrt-sdk-*/
|
||
```
|
||
|
||
Then, from that directory:
|
||
|
||
```sh
|
||
# Add this package and install feeds (provides luci-base)
|
||
git clone https://github.com/eamonxg/luci-theme-aurora.git package/luci-theme-aurora
|
||
./scripts/feeds update -a
|
||
./scripts/feeds install -a
|
||
|
||
# Select the theme in menuconfig: LuCI → Themes → luci-theme-aurora
|
||
make menuconfig
|
||
|
||
# Skip these two lines with the SDK — it already ships a built toolchain
|
||
make tools/install -j$(nproc)
|
||
make toolchain/install -j$(nproc)
|
||
|
||
make package/luci-theme-aurora/compile -j$(nproc) V=s
|
||
```
|
||
|
||
## Contributing
|
||
|
||
Aurora uses **Vite** and a modern front-end toolchain, and is experimenting with end-to-end AI integration across the full development workflow. See [Development Documentation](.dev/docs/DEVELOPMENT.md) to get started. Suggestions and PRs are always welcome.
|
||
|
||
[discord.gg/EBncRrzfTw](https://discord.gg/EBncRrzfTw)
|
||
|
||
Thanks goes to these wonderful people:
|
||
|
||
<!-- contributors:start -->
|
||
<table>
|
||
<tbody>
|
||
<tr>
|
||
<td align="center" valign="top" width="14.29%"><a href="https://github.com/eamonxg"><img src="https://avatars.githubusercontent.com/u/114069097?v=4&s=160" width="80px;" alt="eamonxg"/><br /><sub><b>eamonxg</b></sub></a></td>
|
||
<td align="center" valign="top" width="14.29%"><a href="https://github.com/cjayacopra"><img src="https://avatars.githubusercontent.com/u/83209495?v=4&s=160" width="80px;" alt="cjayacopra"/><br /><sub><b>cjayacopra</b></sub></a></td>
|
||
<td align="center" valign="top" width="14.29%"><a href="https://github.com/chillykidd"><img src="https://avatars.githubusercontent.com/u/197483577?v=4&s=160" width="80px;" alt="chillykidd"/><br /><sub><b>chillykidd</b></sub></a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<!-- contributors:end -->
|
||
|
||
## License & Credits
|
||
|
||
[Apache 2.0](LICENSE). Thanks to:
|
||
|
||
- [luci-theme-bootstrap](https://github.com/openwrt/luci/tree/master/themes/luci-theme-bootstrap)
|
||
- [Vite](https://vitejs.dev/)
|
||
- [Tailwind CSS](https://tailwindcss.com/)
|
||
- [Tabler Icons](https://tabler.io/icons) — the interface icon set
|
||
- [Claude Code](https://claude.ai/code)
|
||
- [Apple](https://www.apple.com/) and [Vercel](https://vercel.com/) — design inspiration
|