Faceplate
LuCI theme for OpenWrt 25.12+

Your router, finally easy to read.

Faceplate replaces LuCI's dated look with a fast, mobile-first design and adds a live dashboard that shows what's connected, what's slow and what's insecure.

Try the live demo → Install in one command
  • ~255 KiBinstalled
  • 0runtime dependencies
  • 0external requests
  • EveryLuCI page restyled
Faceplate dashboard in dark mode: internet status, live traffic graph, device, CPU, memory and connection tiles

What you get

Everything you check, on one screen.

Faceplate keeps all of LuCI's power and gives it a home page that answers the questions you actually log in for.

A dashboard that's live

The home page shows whether you're online, how fast traffic is moving, and how hard the router is working, updated every few seconds.

  • Live download and upload graph with a table view
  • WAN, IPv6, gateway and DNS with one-click copy
  • Devices, CPU, memory and connection-table tiles
  • Front-panel port view with link speeds
Live WAN traffic chart with hover tooltip

A security check in plain English

The router checks its own setup and explains what it found, with a button that takes you straight to the fix.

  • Weak or reused Wi-Fi and admin passwords
  • Risky port forwards and SSH or the web interface exposed to the internet
  • Encryption, HTTPS, NTP and DNS-rebind checks
  • Runs on the router, so passwords never reach the browser
Security and health report listing warnings and suggestions

Who's connected and which channel to use

See every device with its name, IP, band and signal strength. One click scans nearby networks, charts how crowded each channel is, and recommends a quieter one.

  • Filter devices by name, IP or MAC
  • Weak-signal warnings for distant clients
  • Channel advice that skips DFS channels
Connected devices list next to a Wi-Fi channel congestion chart

Find any setting in a second

Press Ctrl K or /. Search understands everyday words: "wifi password", "port forward" and "factory reset" each take you to the right page.

  • Searches every LuCI page and tab, including installed apps
  • Recent pages are listed first
  • Ctrl Enter pins a page to the sidebar
Command palette searching for wifi

Light and dark

Follows your device, or your preference.

Auto, light or dark, switched from the top bar and remembered per browser. Both themes are designed for good contrast, not just inverted colours.

Login page in dark mode, styled like the label on the bottom of a router Login page in light mode

Mobile-first

Built for fixing Wi-Fi from the couch.

Touch-sized controls, a slide-out menu and a dashboard that fits on one screen. No pinch-zooming tiny tables.

Mobile dashboard in dark mode
Dashboard
Mobile navigation drawer
Menu and shortcuts
Search on mobile
Search
Mobile dashboard in light mode
Light mode

Under the hood

Small, private, and polite to your router.

Designed for routers with 16 MB of flash, not for a showroom.

Tiny footprint

About 255 KiB installed. Icons are inlined at build time and the CSS and JS are minified.

No phoning home

Fonts are self-hosted. No CDNs, analytics or external requests of any kind.

Works with every app

It's a theme, not a fork. Stock and third-party LuCI pages keep working and pick up the new look.

Read-only dashboard

The dashboard never changes your config. "Fix" buttons only take you to the right page.

Light on the CPU

Traffic history is kept in your browser, so the router does no extra logging.

Accessible

Keyboard navigation, visible focus, ARIA roles and a table view for every chart.

Install

Two minutes, fully reversible.

You need OpenWrt 25.12 or later with LuCI, SSH access to the router, and python3 and Node.js on your computer for the build step.

your computer
$ git clone https://github.com/rammanokar/luci-theme-faceplate.git faceplate
$ cd faceplate/luci-theme-faceplate
$ ./install.sh root@192.168.1.1
Faceplate installed; previous theme: /luci-static/bootstrap

# changed your mind?
$ ./uninstall.sh root@192.168.1.1
  1. Builds a small copy of the theme with the icons inlined.
  2. Copies it to the router over SSH. Nothing is downloaded on the router.
  3. Health-checks the security plugin and removes it automatically if it misbehaves, so LuCI always stays reachable.
  4. Remembers your current theme, then makes Faceplate the default. uninstall.sh restores it.

Already logged in? Log out and back in once so your session can open the new dashboard.

FAQ

Questions people ask

Will it break my other LuCI apps?

No. Faceplate supplies the header, footer, login page and a stylesheet. Every page, including third-party apps, renders as before with the new styling.

Does it slow down my router?

No. The dashboard uses the same ubus calls as LuCI's own status page, and traffic history lives in your browser. The security check only runs when you open the dashboard or click "Check again".

Which routers does it support?

Any router running OpenWrt 25.12 or later with LuCI. It's been tested on MediaTek MT7621 (D-Link DIR-2660) and aarch64 (D-Link AQUILA PRO AI M30).

Can I switch back?

Yes. Run ./uninstall.sh to restore your previous theme, or pick another theme under System → System → Language and Style.

Is the demo running on a real router?

No. The demo runs the real theme CSS and JavaScript in your browser, fed with made-up data. Only the dashboard is live in the demo; on a router, every LuCI page is restyled.

Give your router a better face.

Try it in your browser now, then install it in two minutes.

Open the live demo → Star on GitHub