detain / phlix-plugin-jade-theme
A deep emerald UI theme for Phlix with luminous jade accent tones
Package info
github.com/detain/phlix-plugin-jade-theme
Type:phlix-plugin
pkg:composer/detain/phlix-plugin-jade-theme
Requires
- php: >=8.3
- detain/phlix-shared: ^0.21
- psr/container: ^1.1 || ^2.0
Requires (Dev)
- phpstan/phpstan: ^1.10
- phpunit/phpunit: ^10.0
- squizlabs/php_codesniffer: ^3.7
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-19 15:34:27 UTC
README
A deep emerald UI theme for Phlix with luminous jade accent tones.
Theme Tokens
Color Palette
| Token | Hex/Value | Usage |
|---|---|---|
| Accent | #50c878 |
Primary jade green accent |
| Background | #050a07 |
Deepest background layer |
| Surface | #0a1410 |
Card and panel backgrounds |
| Surface 2 | #101e18 |
Elevated surface elements |
| Surface 3 | #192a24 |
Highest elevation surfaces |
| Surface Glass | rgba(10, 20, 16, 0.65) |
Translucent frosted backdrop for overlaying panels (consumed via var(--surface-glass) by the web UI) |
| Surface Glass Strong | rgba(5, 10, 7, 0.82) |
Opaque-tier glass: mini-player dock, auth card, player overlay panels |
| Text | #e8f5ec |
Primary text color |
| Text Muted | #9ab8a8 |
Secondary/muted text |
| Text Subtle | #708a7c |
Tertiary/subtle text (AA ≥4.5:1 on bg/surface/surface-2 and the 80% input composite — the graded set pinned by TokenContrastTest; --surface-3 carries no subtle text) |
| Text Faint | #6a8473 |
Faintest text tier; auth-form placeholder (AA ≥4.5:1 on its grounds) |
| Border | #1e2e28 |
Default border color |
| Border Subtle | #141e1a |
Subtle divider lines |
| Border Strong | #2d4238 |
Emphasized borders |
Atmosphere Effects
| Token | Value | Usage |
|---|---|---|
| Ambient | rgba(80, 200, 120, 0.12) |
Subtle green glow effects |
| Vignette | rgba(0, 0, 0, 0.55) |
Edge darkening overlay |
| Grain Opacity | 0.035 |
Film grain texture intensity |
Accent Variants
| Token | Hex/Value | Usage |
|---|---|---|
| Accent Hover | #6ee89a |
Hover state accent |
| Accent Active | #3da85e |
Active/pressed state |
| Accent Soft | rgba(80, 200, 120, 0.15) |
Soft background fills |
| Accent Ring | rgba(110, 232, 154, 0.55) |
Focus ring color (composites ≥3:1 on every ground) |
| Accent Text | #e8fff0 |
Accent-colored foreground text and icons on bg/surfaces (the accent as ink) |
| Text on Accent | #050a07 |
Dark ink drawn on accent fills (buttons, badges) |
Semantic Status Colors
| Token | Hex/Value | Usage |
|---|---|---|
| Success | #2fb98e |
Success status ink (badges, checkmarks, status text). Jade overrides the inherited midnight #61c073: against a green accent the base value sat 1.062:1 away from --accent — a success badge indistinguishable from an accent chip (accessibility review N1). #2fb98e holds AA ≥4.5:1 on every jade ground (6.05–8.03) while separating 1.168:1 / 21.3° hue from the accent; pinned by TokenContrastTest |
| Success Background | rgba(47, 185, 142, 0.16) |
Status-chip tint behind --success text, re-hued to match the override (base rgba sat warm against the cool text) |
Legacy Aliases
The manifest also ships five of the legacy --color-* names from
phlix-tokens src/css/colors.css, each mirroring its modern token
byte-exactly. They are five of the aliases the shipped SPA reads, not the
whole set it reads:
| Token | Mirrors | Value |
|---|---|---|
--color-bg |
--bg |
#050a07 |
--color-surface |
--surface |
#0a1410 |
--color-text |
--text |
#e8f5ec |
--color-text-muted |
--text-muted |
#9ab8a8 |
--color-border |
--border |
#1e2e28 |
colors.css declares each alias as var(--modern-token) inside every
theme block, so these would follow the overrides above through the
cascade alone; they are set explicitly anyway — that is one fewer cascade
assumption between a plugin author and a correct render.
The other --color-* aliases that colors.css declares (for example
--color-text-secondary, --color-primary, and the status aliases) are not
set in this manifest. They stay inherited through extends: midnight. The SPA
also reads a few --color-* names (for example --color-muted, --color-fg
and --color-accent) that neither colors.css nor any theme declares. Those
are a gap in phlix-ui/phlix-tokens, and no theme manifest, this one
included, can close it.
Installation
A theme plugin only registers while enabled — a fresh install lands disabled, so plan on both steps. There are two supported routes:
Admin UI — Admin → Plugins (/app/admin/plugins), find the Jade Theme
card in the catalog (the card shows the catalog title; the manifest name
phlix-plugin-jade-theme is what the CLI and the enable/disable toasts use),
press Install, then flip its switch to enable it.
CLI — from the server root:
php bin/phlix plugin:install https://github.com/detain/phlix-plugin-jade-theme php bin/phlix plugin:enable phlix-plugin-jade-theme
Pass the repository URL to plugin:install: the server resolves it through
the plugin catalog (plugins.json), which pins the exact commit and tarball
sha256 it verifies before extracting. A bare plugin name is not something the
installer can download.
Once enabled, Settings → Appearance shows the Jade swatch next to the
built-ins; picking it applies live. If the swatch is missing, the plugin is
installed but not enabled — php bin/phlix plugin:list shows which state
it's in.
A note on the wrong route: composer require detain/phlix-plugin-jade-theme
does not install the theme. That is the library-dependency path, and the
server loads plugins from its own store (var/plugins/, populated by
PluginLoader), never from an application's vendor/ tree. This repo's
composer.json exists so the catalog tooling and this suite can resolve the
package — running composer install inside a checkout is for development of
the theme itself (see Development below).
Theme Details
- Theme ID:
jade - Theme Name: Jade
- Extends:
midnight - Type: UI Theme
- Dark Mode: Yes
Requirements
- PHP 8.3+
- Phlix 0.44.0+
Development
Install dependencies:
composer install
Run the test suite (phpunit.xml, bootstrapped by tests/bootstrap.php):
composer test
Run static analysis (phpstan.neon, level 9) and coding standards (phpcs.xml, PSR-12):
composer phpstan composer phpcs
Both static gates cover scripts/security-audit-check.php as well as the
PHP source: the S440 gate script is analyzed at level 9 with zero ignores
and checked under PSR-12 (two sniffs are scoped off for scripts/ only —
the reasons are pinned in phpcs.xml). The script is a per-repo port of the
S440 reference gate in phlix-plugin-sample-theme. Its executable code is
byte-identical to that reference, and only its header docblocks carry
jade-specific prose. It is not edited here, so the scoped sniff exclusions
are the fix instead of a rewrite.
tests/bootstrap.php loads dev-stubs/LifecycleInterface.php and dev-stubs/ThemeSourceInterface.php only when the real host contracts are absent, so the suite runs outside a Phlix server checkout. .github/workflows/test.yml runs the same three checks on PHP 8.3, 8.4 and 8.5, plus the S440 dependency-audit leg (composer-audit job — php scripts/security-audit-check.php, locked down by tests/SecurityAuditCheckTest.php).
License
MIT License - see LICENSE file for details.