detain / phlix-plugin-phantom-mint-theme
Phantom Mint — a deep-sea mint UI theme for Phlix
Package info
github.com/detain/phlix-plugin-phantom-mint-theme
Type:phlix-plugin
pkg:composer/detain/phlix-plugin-phantom-mint-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:25 UTC
README
A deep-sea mint UI theme for Phlix, built on the midnight base theme.
Overview
Phantom Mint features a dark, aquatic aesthetic with teal-mint accent colors that evoke the bioluminescence of deep ocean waters. The theme extends the built-in midnight base to inherit its robust foundation while adding a distinctive mint-forward visual identity.
Theme Details
- Theme ID:
phantom-mint - Theme Name: Phantom Mint
- Type: Dark UI Theme
- Extends:
midnight(built-in base) - Author: Detain
- License: MIT
Color Palette
Every row below is keyed by the CSS custom property it documents, so the table
can be diffed directly against the served token payload from providedThemes().
Accent Colors
| Token | Value | Description |
|---|---|---|
--accent |
#00e5a0 |
Primary accent — vibrant mint green |
--accent-hover |
#33ebb3 |
Lighter mint on hover |
--accent-active |
#00c289 |
Deeper mint when pressed |
--accent-soft |
rgba(0, 229, 160, 0.12) |
Subtle mint backgrounds |
--accent-ring |
rgba(0, 229, 160, 0.55) |
Focus ring color |
--accent-text |
#00e5a0 |
The accent mint AS foreground text/icon, AA (≥4.5:1) on dark surfaces (wordmark dot, avatar initials, selected-state text) |
Background & Surface
| Token | Value | Description |
|---|---|---|
--bg |
#03080a |
Page background — near-black with green undertone |
--surface |
#081113 |
Elevated surface color |
--surface-2 |
#0f1a1d |
Higher elevation |
--surface-3 |
#162325 |
Highest elevation |
--surface-glass |
rgba(8, 17, 19, 0.65) |
Glass panel overlay |
--surface-glass-strong |
rgba(3, 8, 10, 0.88) |
Strong glass effect |
Text Colors
| Token | Value | Description |
|---|---|---|
--text |
#e8f4f0 |
Primary text — high contrast mint-tinted white |
--text-muted |
#8fa8a4 |
Secondary text |
--text-subtle |
#77928c |
Tertiary text |
--text-faint |
#374a47 |
Disabled/hint text |
--text-on-accent |
#001a12 |
Dark ink painted on accent-filled surfaces — a different role from --accent-text, which is mint-on-dark |
Border Colors
| Token | Value | Description |
|---|---|---|
--border |
#1a2d2b |
Default border |
--border-subtle |
#0f1d1b |
Subtle dividers |
--border-strong |
#2a4542 |
Emphasized borders |
Effects
| Token | Value | Description |
|---|---|---|
--grain-opacity |
0.03 |
Subtle film grain overlay |
--vignette |
rgba(0, 20, 15, 0.7) |
Edge darkening |
--ambient |
rgba(0, 229, 160, 0.18) |
Ambient glow effect |
Legacy --color-* aliases
Five tokens above are deliberately duplicated under their legacy --color-*
alias names. The alias family predates the modern tokens and the shipped SPA
still reads it — var() consumers live in the PhotoView/PhotoAlbum pages and
the admin WebhookLogs page:
| Alias | Value | Modern twin |
|---|---|---|
--color-bg |
#03080a |
--bg |
--color-surface |
#081113 |
--surface |
--color-text |
#e8f4f0 |
--text |
--color-text-muted |
#8fa8a4 |
--text-muted |
--color-border |
#1a2d2b |
--border |
These duplicates are load-bearing, not decorative: if you raise --bg you
must raise --color-bg in the same edit, or the un-migrated components keep
the old color underneath the new theme. The four status aliases
(--color-error* and friends) are omitted on purpose — this theme overrides no
status colors, so the aliases correctly fall through to the midnight base. The
remaining thirteen --color-* names on the allowlist have no var()
consumers at all; setting them would be a no-op, so they stay omitted.
Installation
The supported route: the plugin catalog
The Phlix server installs plugins from a catalog (plugins.json). A catalog
entry pins an exact commit (ref) and the sha256 of that commit's tarball
(artifactSha256), and the server verifies those bytes before it extracts
anything. Without a pin, PluginLoader::install() refuses outright — that is a
deliberate default-deny, not a bug to work around.
Admin UI — Admin → Plugins (/app/admin/plugins), find Phantom Mint
Theme, press Install, then flip its switch to enable it.
CLI — from the server root, pass the repository URL, not the plugin name (the URL is what gets rewritten to the pinned tarball):
php bin/phlix plugin:install https://github.com/detain/phlix-plugin-phantom-mint-theme php bin/phlix plugin:enable phlix-plugin-phantom-mint-theme
While iterating on a local fork (no catalog entry yet), build an archive and
install it over file://, which is exempt from the pin requirement because the
bytes are already yours. The tar path is relative, so run it from the
directory that contains your checkout; run the php bin/phlix lines from the
server root:
cd /path/to/parent-of-checkout # the directory holding phlix-plugin-phantom-mint-theme/ tar --exclude=vendor --exclude=.git -czf /tmp/phantom-mint.tar.gz phlix-plugin-phantom-mint-theme/ cd /path/to/phlix-server # the server root php bin/phlix plugin:install file:///tmp/phantom-mint.tar.gz php bin/phlix plugin:enable phlix-plugin-phantom-mint-theme
What does not work
composer require detain/phlix-plugin-phantom-mint-theme into the server, or
cloning this repository into the plugins directory, does not register anything —
the plugin loader installs catalog-pinned archives or local tarballs, never an
ambient vendor checkout or a bare directory.
Install, enable, and selection are three different acts
Installing downloads and stages the plugin. Enabling it is what registers
the theme: PluginLoader::enable() finds the ThemeSourceInterface on the
entry class and contributes the phantom-mint theme id. Choosing the theme is
a per-user preference, not an admin action — each user picks Phantom Mint
under Settings → Appearance. None of the three steps implies the next.
Requirements
- PHP 8.3 or higher
- Phlix server 0.44.0 or higher
- PSR Container 1.1 or 2.0
Development
Running Tests
composer install ./vendor/bin/phpunit
Code Quality
# Static analysis with PHPStan (level 9 over src/ and scripts/; dev-stubs/ # scanned for the host interfaces, zero ignores) ./vendor/bin/phpstan analyse # Coding standards with PHPCS ./vendor/bin/phpcs # Fix coding standards automatically ./vendor/bin/phpcbf
CI Pipeline
The single GitHub Actions workflow (.github/workflows/test.yml) runs:
- PHPUnit tests on PHP 8.3 and 8.4, with coverage (pcov → Codacy)
- PHPStan static analysis at level 9
- PHPCS code style checking
- Security Audit (
composer-audit): the whole committed lock — runtime and development dependencies — checked against the Packagist advisory corpus byscripts/security-audit-check.php, pinned by its guard testtests/SecurityAuditCheckTest.php
Theme Rules
-
Token Keys: All token keys must be on the Phlix theme token allowlist
-
Token Values: Must be literal values — hex colors, rgb/rgba/hsl/hsla with numeric arguments, bare numbers,
transparent, orcurrentColor -
Forbidden Values: a token value must be one literal, and must not contain any of:
- a
var()orurl()reference, - a
;,{,}, or backslash, - a newline, tab, or CSS comment.
The host parser accepts only complete literals per value, so these are rejected rather than stripped — the whole payload fails to register.
- a
File Structure
phlix-plugin-phantom-mint-theme/
├── src/
│ └── PhantomMintPlugin.php # Main plugin class
├── dev-stubs/
│ ├── LifecycleInterface.php # Host interface stub
│ └── ThemeSourceInterface.php # Host interface stub
├── tests/
│ ├── bootstrap.php # Test bootstrap (loads dev-stubs when host absent)
│ ├── PhantomMintPluginTest.php # Plugin tests
│ ├── SecurityAuditCheckTest.php # S440 anti-neutering guard for the audit gate
│ └── TokenContrastTest.php # WCAG contrast contract law for the palette
├── scripts/
│ └── security-audit-check.php # Whole-lock audit gate (CI `composer-audit`)
├── .github/
│ └── workflows/
│ └── test.yml # CI workflow
├── composer.json # Package definition
├── composer.lock # Locked dependency versions
├── plugin.json # Plugin manifest
├── phpunit.xml # PHPUnit config
├── phpstan.neon # PHPStan config
├── phpcs.xml # PHPCS config
├── README.md # This file
└── LICENSE # MIT license
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Run the test suite
- Submit a pull request
License
MIT License — see LICENSE for details.