English | 简体中文

Aurora Theme

A modern OpenWrt LuCI theme built with Vite and Tailwind CSS.

🏔️ Pure | 🦢 Elegant | 📱 Responsive | 🌗 Dark/Light Mode | ⚙️ Settable

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
• 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).

Preview

_{✨ Overview— Modern UI & Elegant Animations}

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

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.

• 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

Contributing

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.

Community

I've got a Discord server going - come hang out and chat! 👋 Join Discord

License & Credits

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.