English | 简体中文
A modern OpenWrt LuCI theme built with Vite and Tailwind CSS.
Note
🤖 Exploring AI Workflows...
Hey everyone — I've been pretty busy with work lately, so my time for Aurora has been limited. But I don't want the project to stall, so I've been exploring AI-assisted workflows to help pick up the slack, especially on the debugging side.
There's a backlog of open issues right now, and honestly, most of them are styling compatibility problems with third-party plugins. These aren't huge issues individually, but they're incredibly time-consuming to track down — you have to install the plugin, sometimes set up specific conditions on the router just to reproduce the problem.
The root cause is that LuCI only provides a basic set of web components. When plugin authors need more complex UI, they end up rolling their own HTML/CSS/JS with no shared conventions, so compatibility headaches are inevitable. With the sheer number of LuCI plugins out there, getting them all to play nicely is a massive undertaking — especially when some plugins don't even follow LuCI's own JS conventions.
So I'm bringing AI into the loop to handle these tedious but important tasks, and ideally automate as much of it as possible. If you have better ideas or suggestions, I'd love to hear them — come chat on Discord.
- 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
- Customizable: The luci-app-aurora-config plugin includes multiple built‑in theme presets you can switch between, and lets you customize colors, navigation submenu styles, the theme logo, and the floating toolbar (add or edit frequently used pages).
✨ Overview— Modern UI & Elegant Animations
- 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)
OpenWrt 25.12+ and snapshots use apk; other versions use opkg:
Tip: You can confirm your package manager by running
opkg --versionorapk --version. If it returns output (not "not found"), that's your package manager.
-
opkg (OpenWrt < 25.12):
cd /tmp && uclient-fetch -O luci-theme-aurora.ipk https://github.com/eamonxg/luci-theme-aurora/releases/latest/download/luci-theme-aurora_0.11.0-r20260208_all.ipk && opkg install luci-theme-aurora.ipk
-
apk (OpenWrt 25.12+ and snapshots):
cd /tmp && uclient-fetch -O luci-theme-aurora.apk https://github.com/eamonxg/luci-theme-aurora/releases/latest/download/luci-theme-aurora-0.11.0-r20260208.apk && apk add --allow-untrusted luci-theme-aurora.apk
Development
As we step into 2026, front-end toolchains have become mature and advanced, and modern browsers now support a wide range of exciting new features. Fully embracing the modern front-end ecosystem is at the core of the Aurora theme.
Aurora uses Vite as the build tool.
- During development, you can freely choose and integrate any CSS toolchain.
- In production, multiple strategies are available to optimize bundled assets.
- Most importantly, with the help of a local proxy server, style changes can be previewed in real time!
For more development information, see Development Documentation.
I've got a Discord server going - come hang out and chat! 👋 Join Discord
This project is licensed under the Apache License 2.0.
The production build structure is based on the official OpenWrt theme luci-theme-bootstrap.
Visual style and some implementations are influenced by Apple and Vercel.
The project is developed using a modern front-end stack, including Vite and Tailwind CSS.