Repository navigation
feat(ui): Root Intelligence — modern UX/UI overhaul for CUPS WebAdmin - #1783
Closed
targino-tech wants to merge 2 commits into
Closed
targino-tech wants to merge 2 commits into
targino-tech wants to merge 2 commits into
Conversation
added 2 commits
October 20, 2026 21:56
[REVIEW REQUEST] This commit implements a comprehensive UX/UI redesign of the
OpenPrinting CUPS web administration interface, codename 'Root Intelligence'.
The goal is to modernize the look and feel for Linux beginners and enthusiasts
while preserving 100% of the original backend contracts, CGI routing, template
variable syntax, and CSRF tokens.
## What changed
### Design System (doc/cups.css)
- Dark glassmorphism theme: backdrop-filter blur(14px), semi-transparent panels
- Cohesive color palette: deep navy (#0d1117) + sage green (#a8c686) accents
- Smooth CSS transitions (0.3s ease) on all interactive elements
- Subtle glow borders and hover states throughout
- Full mobile/tablet responsive layout (360px to 1440px+)
- CSS custom properties for easy theming
### JavaScript Layer (doc/cups.js — NEW FILE)
- Zero external dependencies; runs fully offline (air-gapped environments)
- User Mode Toggle (Beginner vs Advanced) persisted via localStorage
- Onboarding Checklist with animated progress bar for first-time users
- Interactive 3-step Guided Tour modal explaining CUPS architecture
- Raycast/Spotlight-style Command Palette (Ctrl+K):
- Real-time fuzzy filter across quick actions, print queues, terminal commands
- Keyboard navigation (up/down, Enter, Esc)
- Copy-to-clipboard for lpstat, cupsenable, cancel -a commands
### Templates (templates/ + templates/pt_BR/)
- header.tmpl: Command Palette trigger button + Mode Switch toggle
- home.tmpl: Onboarding banner + Advanced telemetry bar
- All other templates: dark-mode cards, animated status badges,
accessible focus rings, semantic HTML improvements
### Tooling (tools/)
- cups_preview_server.py: local Python preview server simulating CUPS routing
- cups_template.py: template engine helper for offline preview
- capture_step*.py: automated screenshot scripts for visual regression
## What was NOT changed
- CGI backend logic (scheduler, ppd, ipp handlers)
- Template variable interpolation syntax ({variable}, {?condition})
- Form OP routing and org.cups.sid CSRF tokens
- Build system core — only doc/Makefile updated to include cups.js
## Tested
Locale coverage: en (templates/) and pt_BR (templates/pt_BR/)
Viewports: Desktop 1440x900, Tablet 768x1024, Mobile 360x800
Tools: Python preview server (tools/cups_preview_server.py)
Reviewers: please evaluate whether this modernization is suitable for
upstream consideration or as a reference implementation for community forks.
Documents the complete UX/UI overhaul conventions, color palette tokens, template rules, JS architecture, CSS section boundaries, and PR workflow.
Member
|
Sorry, but we really aren't looking to make more major changes to the CUPS web interface for 2.5, and 3.0 and later are based on PAPPL which has a completely different architecture. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This pull request introduces Root Intelligence, a progressive enhancement UX/UI overhaul for the CUPS Web Administration interface (
templates/anddoc/).The goal of this initiative is to provide a modern, accessible, and intuitive interface for both beginners and seasoned system administrators while preserving 100% compatibility with the existing CUPS daemon, CGI architecture, and IPP protocol.
Key Highlights
1. Modern Design System (
doc/cups.css)--ri-*) with high-contrast text and subtle accents.prefers-reduced-motion.2. Lightweight Interactive Layer (
doc/cups.js— New)Ctrl+K/⌘K): Fast launcher to jump to any printer, queue, admin action, or copy shell commands (such aslpstat -p -d,cupsenable,cancel -a).3. Template Modernization (
templates/&templates/pt_BR/)home.tmpl,printers.tmpl,printer.tmpl,jobs.tmpl,admin.tmpl,classes.tmpl, and error pages.{variable},{#array...},{?cond}).org.cups.sidCSRF tokens,OPparameter routing, and form actions.pt_BR) localization.4. Developer Tooling & Documentation
doc/Makefileto includecups.jsin installation targets.CHANGELOG.mdandCONTRIBUTING.mddocumenting architecture, conventions, and design tokens.tools/for rapid UI testing without running a live daemon.Backward Compatibility & Safety
cupsd), scheduler, IPP, or filter binaries were touched.Feedback & Collaboration
We would love to hear feedback from the OpenPrinting community regarding: