PHPackages resofire/cosmos-theme - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. resofire/cosmos-theme ActiveFlarum-extension resofire/cosmos-theme ===================== Deep Cosmos — a dark, modern theme for Flarum. v2.0.3(1mo ago)073↑1050.7%MITCSS Since Mar 15Pushed 1mo agoCompare [ Source](https://github.com/ResofireV2/cosmos-theme)[ Packagist](https://packagist.org/packages/resofire/cosmos-theme)[ RSS](/packages/resofire-cosmos-theme/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (1)Versions (204)Used By (0) Cosmos Theme ============ [](#cosmos-theme) A deep-space dark theme for [Flarum](https://flarum.org/) with a built-in day/night toggle, ambient star fields, and a fully styled post interaction system. --- Features -------- [](#features) ### Palette & Typography [](#palette--typography) - Deep space dark palette (`#080c14` background, teal `#69c6b9` primary accent) - Matching **day mode** (light) stylesheet that mirrors all structure — only colours flip - **Font picker** in admin: choose from Outfit (default), Space Grotesk, DM Sans, Sora, Plus Jakarta Sans, Nunito, or System UI. Code blocks always use DM Mono regardless of font choice ### Day / Night Toggle [](#day--night-toggle) - Self-contained theme switcher — **no dependency on fof/nightmode** - Three modes: **Auto** (follows OS dark/light preference), **Day**, **Night** - Preference persisted per user account via Flarum's prefs API; falls back to a cookie for guests - Admin can set the forum-wide default mode (Auto / Day / Night) - Toggle button always visible in the header; also accessible from the session dropdown and user settings page ### Visual Effects [](#visual-effects) - Ambient radial glow bloom behind the hero and page - CSS star field (box-shadow technique, no images) on hero and discussion page - Star fields and glow effects can be **disabled globally** from admin settings (e.g. for accessibility or performance) - Avatar ring glow that picks up the user's avatar colour - Connector line between posts in the avatar column on desktop ### Hero / Welcome Area [](#hero--welcome-area) - Cosmos-styled hero with star field layer and gradient wash - Optional **image slider** replacing the hero — configurable entirely from admin: - Enable/disable globally - Disable on mobile (falls back to default hero) - Hide on tag/category pages - Desktop and mobile height (px) - Autoplay interval (0 = manual only) ### Discussion List [](#discussion-list) - Unread indicator via left accent band - Styled discussion item controls (3-dot menu) - Pinned discussion highlighting (compatible with flarum/sticky) - Styled "Load more" button ### User Profile Hero [](#user-profile-hero) The profile hero is redesigned to match the rest of the Cosmos aesthetic: - Background gradient blended from the user's avatar colour into the Cosmos dark, using the same technique as the discussion hero - Animated star field tinted from the avatar colour (suppressed when the effects toggle is off) - Ambient glow bloom from the avatar colour on the left, teal counter-bloom on the right - Avatar ring glow using the avatar's dominant colour - **Stat pills** displayed below the user info: posts, discussions, and likes received (likes shown only when `flarum/likes` is active) - Both dark and light mode fully themed ### Post Stream [](#post-stream) - Styled post headers, body, blockquotes, code blocks, tables, and images - Event posts (renamed, tagged, etc.) in muted style - Post number accent in secondary colour ### Post Controls (flarum/likes + fof/reactions) [](#post-controls-flarumlikes--fofreactions) Fully styled to match the Cosmos aesthetic: - **Reply button** — dimmed at rest, teal on hover - **Like button** — dimmed at rest, teal on hover and when active (already liked) - **Reaction count pills** — rounded-rect pills with a subtle border; teal tint on hover; stronger teal border + fill for your own active reaction - **React smiley button** — ghost button, teal on hover; inline SVG icon inherits `currentColor` - **Reaction picker dropdown** — dark surface card (`#131b2e`) with deep shadow in night mode; white card with soft shadow in day mode - **Emoji buttons inside picker** — teal-tinted background + scale pop on hover - All styles applied in both dark (`forum.css`) and light (`forum-day.css`) ### Extension Compatibility [](#extension-compatibility) Tested and styled for: - `flarum/tags` — tag pills styled as flat dark pills; white text overrides in hero - `flarum/sticky` — pinned discussion highlight - `flarum/likes` — like button with active state - `fof/reactions` — reaction pills, picker dropdown, emoji buttons, react trigger - `fof/user-directory` — 2-column card grid with star field, avatar glow, ambient colour bloom per card - Blog/cards extensions — card grid layout with image wrapper, body, footer, author, controls ### Admin Settings [](#admin-settings) All settings are available in **Admin → Extensions → Cosmos Theme**: SettingDescriptionForum FontFont applied globally (code blocks always use DM Mono)Default Colour ThemeForum-wide default: Auto, Day, or NightStar Fields & Glow EffectsEnable/disable all star and glow visual effectsAlways Show Post ControlsShow Like, Reply, and Reactions buttons permanently on every post (default: visible on hover only)Enable Cosmos SliderReplace the hero with an image sliderDisable Slider on MobileShow default hero on mobile instead of sliderHide Slider on Tag PagesShow default hero on tag/category pagesSlider Height — Desktop (px)Height of the slider on desktop viewportsSlider Height — Mobile (px)Height of the slider on mobile viewportsAutoplay Interval (seconds)Slide autoplay speed; 0 disables autoplay--- ### Mobile (acpl/mobile-tab compatible) [](#mobile-acplmobile-tab-compatible) The theme includes a full mobile pass targeting phone viewports (≤844px): - **MobileTab bar** — Cosmos surface treatment with top border and shadow, Outfit font on labels - **Profile tab highlight fix** — the session dropdown toggle no longer inherits the desktop `.Dropdown-toggle` border/background, so the Profile tab only highlights when active - **Reaction picker overflow** — the picker is anchored to the right edge of its trigger and capped to the viewport width so it never clips on narrow screens - **Touch reaction state** — `.mobile-show` receives the same Cosmos card styling as the hover state - **Body bottom padding** — page content clears the 54px tab bar (+ safe area inset) so the last post is never hidden behind it - **Discussion hero** — star field animation paused on phone for performance - **Post stream connector line** — hidden on phone where the avatar column layout doesn't apply - **User profile stat pills** — tighter sizing and gap for narrow viewports Requirements ------------ [](#requirements) - Flarum `^1.8` - PHP 8.3+ Installation ------------ [](#installation) Install via Composer: ``` composer require resofire/cosmos-theme ``` Then enable the extension in your Flarum admin panel. Optional Extensions ------------------- [](#optional-extensions) The theme works without these but includes explicit styling for them: - `flarum/likes` - `fof/reactions` - `fof/user-directory` - `flarum/sticky` - `flarum/tags` License ------- [](#license) MIT ### Health Score 43 — FairBetter than 91% of packages Maintenance90 Actively maintained with recent releases Popularity13 Limited adoption so far Community6 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 203 Last Release 52d ago Major Versions v0.9.9 → v1.0.02026-03-20 v1.9.9 → v2.0.02026-03-22 ### Community Maintainers ![](https://www.gravatar.com/avatar/ce3b79a1a273ec4db4bf7390fdb50584c02c4e69a55c032ef67746fb13b6c3c3?d=identicon)[ResofireV2](/maintainers/ResofireV2) --- Top Contributors [![ResofireV2](https://avatars.githubusercontent.com/u/266603343?v=4)](https://github.com/ResofireV2 "ResofireV2 (203 commits)") ### Embed Badge ![Health badge](/badges/resofire-cosmos-theme/health.svg) ``` [![Health](https://phpackages.com/badges/resofire-cosmos-theme/health.svg)](https://phpackages.com/packages/resofire-cosmos-theme) ``` ### Alternatives [fof/upload The file upload extension for the Flarum forum with insane intelligence. 188171.7k15](/packages/fof-upload)[fof/byobu Well integrated, advanced private discussions. 61105.8k9](/packages/fof-byobu)[fof/gamification Upvotes and downvotes for your Flarum community 4157.1k6](/packages/fof-gamification)[flarum/suspend Suspend users so they can't post. 10404.5k16](/packages/flarum-suspend)[fof/user-bio Add a user bio to user profiles 2196.5k9](/packages/fof-user-bio)[flarum/extension-manager An extension manager to install, update and remove extension packages from the interface (Wrapper around composer). 12211.5k](/packages/flarum-extension-manager) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)