detain / phlix-plugin-emerald-abyss-theme
Emerald Abyss — a deep oceanic ui-theme plugin for Phlix with teal accents.
Package info
github.com/detain/phlix-plugin-emerald-abyss-theme
Type:phlix-plugin
pkg:composer/detain/phlix-plugin-emerald-abyss-theme
Requires
- php: >=8.3
- detain/phlix-shared: ^0.21
- psr/container: ^1.1 || ^2.0
Requires (Dev)
- phpstan/phpstan: ^2.2
- phpunit/phpunit: ^10.0
- squizlabs/php_codesniffer: ^4.0
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 oceanic ui-theme plugin for Phlix with teal accents.
Theme Identity
| Field | Value | Description |
|---|---|---|
| ID | emerald-abyss |
Theme identifier |
| Name | Emerald Abyss | Display name |
| Extends | midnight |
Base theme |
| Accent | #2dd4a8 |
Primary teal accent |
| Dark | true |
Dark theme |
Color Palette
Background & Surfaces
- Background:
#061009- Deepest dark (kept clear of the OLED/TV black-crush floor) - Surface:
#0b1913- Primary surface - Surface 2:
#12251e- Elevated surface - Surface 3:
#142d25- Highest elevation - Surface Glass:
rgba(11, 25, 19, 0.65)- Translucent surface (tracks Surface) - Surface Glass Strong:
rgba(6, 16, 9, 0.85)- Backdrop variant (tracks Background)
Text
- Text:
#e8f5f0- Primary text (bright mint white) - Text Muted:
#8fbcaa- Secondary text - Text Subtle:
#679a86- Tertiary text (>= 4.5:1 on bg/surface/surface-2 per R6.5b) - Text Faint:
#3a574a- Disabled/hint text (placeholder tier, house-exempt from AA) - Text On Accent:
#030807- Ink for text and icons that sit on accent fills
Borders
- Border:
#1a3329- Default border - Border Subtle:
#0f211b- Subtle dividers - Border Strong:
#2a4d3e- Emphasized borders
Atmosphere Effects
- Ambient:
rgba(45, 212, 168, 0.18)- Teal ambient glow - Vignette:
rgba(0, 0, 0, 0.65)- Edge darkening - Grain Opacity:
0.035- Film grain intensity
Accent Ramp
| Token | Value |
|---|---|
--accent |
#2dd4a8 |
--accent-hover |
#5eead4 |
--accent-active |
#14b8a6 |
--accent-soft |
rgba(45, 212, 168, 0.15) |
--accent-ring |
rgba(45, 212, 168, 0.50) |
--accent-text |
#2dd4a8 |
Legacy Aliases
The five --color-* names from phlix-tokens src/css/colors.css this
theme explicitly overrides, each mirroring its modern token byte-exactly —
a tested law (tests/TokenContrastTest.php). The remaining --color-*
names the SPA reads (--color-error, --color-primary, --color-success,
--color-warning, --color-info) stay intentionally unset here and arrive
inherited through extends: midnight.
| Token | Mirrors | Value |
|---|---|---|
--color-bg |
--bg |
#061009 |
--color-surface |
--surface |
#0b1913 |
--color-text |
--text |
#e8f5f0 |
--color-text-muted |
--text-muted |
#8fbcaa |
--color-border |
--border |
#1a3329 |
Installation
This package is not published to Packagist (its
repo.packagist.org/p2/detain/phlix-plugin-emerald-abyss-theme.json metadata
endpoint answers 404, verified 2026-11-12), so a plain
composer require detain/phlix-plugin-emerald-abyss-theme
resolves nothing — and it was never the install route anyway: the Phlix server
does not scan Composer's vendor/ for plugins. The plugin loader stages
plugins under the server's var/plugins/ from digest-pinned sources and
verifies the bytes before extracting anything (remote sources without a pin are
refused by design, not by accident).
The supported route is the official plugin catalog — this repo is listed in
detain/phlix-plugins with a pinned
ref + artifactSha256:
- Log in as an admin user.
- Open Admin → Plugins (
/app/admin/plugins). - Find Emerald Abyss Theme in the catalog and press Install.
Requirements
- PHP 8.3+
- Phlix Server 0.44.0+
Development
Install dependencies and run the PHPUnit suite (phpunit.xml, bootstrapped by tests/bootstrap.php):
composer install vendor/bin/phpunit --colors=always
Static analysis at level 9 over src/, tests/ and scripts/ — composer phpstan
already passes -c phpstan.neon, whose scanDirectories registers the dev-stubs/
contracts. Of those two stubs, only Phlix\Theming\ThemeSourceInterface is host-only
(declared by the server, in no Composer package at all); Phlix\Shared\Plugin\LifecycleInterface
ships in detain/phlix-shared and is stubbed here only for the case where that package
is absent:
composer phpstan
PSR-12 coding standard over src/, tests/, dev-stubs/, and scripts/:
composer phpcs
CI (.github/workflows/test.yml) runs all three checks on PHP 8.3 and 8.4, and uploads coverage to Codacy from the 8.3 leg. A dedicated Security Audit job additionally checks the committed lock (runtime and development dependencies) via scripts/security-audit-check.php.
License
MIT License - see LICENSE for details.
Links
Author
Joe Huss detain@interserver.net