Search by

detain / phlix-plugin-emerald-abyss-theme

detain

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

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.0 2026-10-30 13:33 UTC

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:

  1. Log in as an admin user.
  2. Open Admin → Plugins (/app/admin/plugins).
  3. 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