README.md

May 15, 2026 · View on GitHub

English | 简体中文

Aurora Theme

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

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

OpenWrt Chrome Safari Firefox GitHub release Downloads Discord
Multi-Device Showcase

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

Theme Demo
✨ Overview— Modern UI & Elegant Animations

Dark and Light Preview Mobile Preview

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

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 to get started. Suggestions and PRs are always welcome.

discord.gg/EBncRrzfTw

License & Credits

Apache 2.0. Thanks to: