Volcanic Ember Theme Plugin

A warm, fiery dark UI theme for Phlix built on the midnight base with ember orange accents evoking volcanic lava and glowing coals.

Theme Tokens

Color Palette

Token	Hex	Usage
--accent	#ff6b4a	Primary ember accent
--accent-hover	#ff8a70	Hover state
--accent-active	#e54f2e	Active/pressed state
--accent-soft	rgba(255, 107, 74, 0.14)	Soft accent for backgrounds
--accent-ring	rgba(255, 107, 74, 0.50)	Focus rings
--accent-text	#0a0605	Text on accent

Background Stack

Token	Hex	Usage
--bg	#0d0705	Page background
--surface	#1a0d0a	Card/panel background
--surface-2	#261310	Elevated surface
--surface-3	#331a14	Highest elevation
--surface-glass	rgba(30, 12, 10, 0.62)	Glass effect background
--surface-glass-strong	rgba(15, 5, 3, 0.82)	Strong glass effect

Text Ramp

Token	Hex	Usage
--text	#f0e6e4	Primary text (warm off-white)
--text-muted	#c4a8a4	Secondary text
--text-subtle	#8a7270	Tertiary text
--text-faint	#5a4a48	Disabled/hint text
--text-on-accent	#0a0605	Text on accent color

Borders

Token	Hex	Usage
--border	#2a1814	Default border
--border-subtle	#1a0e0c	Subtle border
--border-strong	#3a2220	Strong/emphasis border

Atmosphere

Token	Value	Usage
--ambient	rgba(255, 107, 74, 0.12)	Ambient glow effect
--vignette	rgba(0, 0, 0, 0.5)	Vignette overlay
--grain-opacity	0.035	Film grain effect

Installation

composer require detain/phlix-plugin-volcanic-ember-theme

Requirements

• PHP 8.3+
• Phlix 0.44.0+

Development

composer install

Run the test suite. phpunit.xml bootstraps tests/bootstrap.php, which loads the dev-stubs/ interfaces when the host's Phlix\Shared\Plugin\LifecycleInterface and Phlix\Theming\ThemeSourceInterface are absent:

vendor/bin/phpunit --colors=always

Static analysis and coding standards. Both scripts pass the config file explicitly so phpstan.neon picks up dev-stubs/ via scanDirectories and phpcs.xml checks src, tests, and dev-stubs:

composer phpstan
composer phpcs

.github/workflows/test.yml runs all three on PHP 8.3 and 8.4, and uploads the coverage.xml cobertura report to Codacy from the 8.3 leg.

License

MIT License - see LICENSE for details.