gitwtfhub

wtf is luci-theme-footstrap?

vizzletf/luci-theme-footstrap — explained in plain English

Analysis updated 2026-05-18

71CSSAudience · ops devopsComplexity · 2/5LicenseSetup · easy

TL;DR

Footstrap is a fast, customizable theme for the LuCI web admin interface used by OpenWrt routers, with browser-side appearance settings and self-update support.

Mindmap

mindmap
  root((Footstrap))
    What it does
      Fast LuCI theme
      Mobile friendly UI
      Browser side settings
    Tech stack
      CSS
      LuCI
      OpenWrt
    Use cases
      Router admin UI
      Custom app styling
      Self updating theme
    Setup
      SSH one line install
      apk or opkg
      Signature verification

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Replace the default OpenWrt router admin interface with a faster, mobile-friendly theme.

REASON 2

Customize the router UI's colors, layout, and dark mode from a browser menu without touching the router.

REASON 3

Style a custom luci-app package so it automatically matches the Footstrap theme.

What's in the stack?

CSSLuCIOpenWrtucode

How it stacks up

vizzletf/luci-theme-footstrapzhibeigg/ai-api-relay-guideballwictb/besur-themes
Stars717558
LanguageCSSCSSCSS
Setup difficultyeasyeasyeasy
Complexity2/51/51/5
Audienceops devopsgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires an OpenWrt 24.10+ router, installed with a single SSH command.

Apache 2.0 license, use freely including commercially, keep the license notices, bundled fonts have their own separate license.

Wtf does this do

Footstrap is a theme for LuCI, the web interface used by OpenWrt, the open source router firmware. It replaces the look of the default admin panel with something lighter, faster, and more consistent, and it works on OpenWrt 24.10 and newer. Rather than restyling individual pages one by one, Footstrap applies its look to LuCI's shared building blocks, so third party packages that use those same components automatically pick up the new style without any extra work, unless they bring their own custom styles. The interface adapts to any screen width, so tables collapse into cards and forms stack into a single column on a phone. Navigation runs as a single page app instead of reloading the whole page each time, which the README says makes it roughly three times faster than the default luci-theme-bootstrap theme across a 38 page benchmark, with far fewer network requests per page. Once installed, the only thing you set on the router itself is which theme to use. Everything else, including light or dark mode, color palette, accent color, corner rounding, and layout, lives in an Appearance menu in the browser and applies instantly without writing anything back to the router, so preferences are a browser setting rather than a router setting. The theme can also check GitHub for new releases and update itself from the same menu, or you can turn that check off. Installing it is a single command run over SSH, which detects whether your OpenWrt version uses apk or opkg and installs the matching package after verifying it with a cryptographic signature, not just a checksum. There is also a manual install path using the package files from GitHub releases. The theme itself is licensed under Apache-2.0, since parts of it are derived from the original luci-theme-bootstrap and from LuCI's own code, though the bundled fonts carry a separate open font license. This project is aimed at people who already run OpenWrt on a router and want a faster, more customizable admin interface.

Yoink these prompts

Prompt 1
Walk me through installing luci-theme-footstrap on my OpenWrt router over SSH.
Prompt 2
Explain how Footstrap's browser-side Appearance settings work versus router-side settings.
Prompt 3
How does Footstrap verify a package during install, and what does --allow-untrusted actually mean?
Prompt 4
Summarize how to style a custom luci-app so it works correctly under this theme.

Frequently asked questions

wtf is luci-theme-footstrap?

Footstrap is a fast, customizable theme for the LuCI web admin interface used by OpenWrt routers, with browser-side appearance settings and self-update support.

What language is luci-theme-footstrap written in?

Mainly CSS. The stack also includes CSS, LuCI, OpenWrt.

What license does luci-theme-footstrap use?

Apache 2.0 license, use freely including commercially, keep the license notices, bundled fonts have their own separate license.

How hard is luci-theme-footstrap to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is luci-theme-footstrap for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.