feat: theme-specific white-label logos

.env.example

@@ -44,6 +44,8 @@ ENABLE_DA_TRACKING=false
 
 # Branding / white-label (all optional)
 # CHAIN_LOGO_URL=                      # URL or path to logo (e.g., /branding/logo.svg). Default: bundled logo
+# CHAIN_LOGO_URL_LIGHT=                # URL or path to logo used in light theme
+# CHAIN_LOGO_URL_DARK=                 # URL or path to logo used in dark theme
 # ACCENT_COLOR=                        # Primary accent hex (e.g. #3b82f6). Default: #dc2626 (red)
 # BACKGROUND_COLOR_DARK=               # Dark mode base background hex. Default: #050505
 # BACKGROUND_COLOR_LIGHT=              # Light mode base background hex. Default: #f4ede6

backend/crates/atlas-server/src/api/handlers/config.rs

@@ -10,6 +10,10 @@ pub struct BrandingConfig {
     #[serde(skip_serializing_if = "Option::is_none")]
     pub logo_url: Option<String>,
     #[serde(skip_serializing_if = "Option::is_none")]
+    pub logo_url_light: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub logo_url_dark: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
     pub accent_color: Option<String>,
     #[serde(skip_serializing_if = "Option::is_none")]
     pub background_color_dark: Option<String>,
@@ -27,6 +31,8 @@ pub async fn get_config(State(state): State<Arc<AppState>>) -> Json<BrandingConf
     Json(BrandingConfig {
         chain_name: state.chain_name.clone(),
         logo_url: state.chain_logo_url.clone(),
+        logo_url_light: state.chain_logo_url_light.clone(),
+        logo_url_dark: state.chain_logo_url_dark.clone(),
         accent_color: state.accent_color.clone(),
         background_color_dark: state.background_color_dark.clone(),
         background_color_light: state.background_color_light.clone(),
@@ -44,6 +50,8 @@ mod tests {
         let config = BrandingConfig {
             chain_name: "TestChain".to_string(),
             logo_url: None,
+            logo_url_light: None,
+            logo_url_dark: None,
             accent_color: Some("#3b82f6".to_string()),
             background_color_dark: None,
             background_color_light: None,
@@ -55,6 +63,8 @@ mod tests {
         assert_eq!(json["chain_name"], "TestChain");
         assert_eq!(json["accent_color"], "#3b82f6");
         assert!(json.get("logo_url").is_none());
+        assert!(json.get("logo_url_light").is_none());
+        assert!(json.get("logo_url_dark").is_none());
         assert!(json.get("background_color_dark").is_none());
         assert!(json.get("success_color").is_none());
         assert!(json.get("error_color").is_none());
@@ -65,6 +75,8 @@ mod tests {
         let config = BrandingConfig {
             chain_name: "MyChain".to_string(),
             logo_url: Some("/branding/logo.svg".to_string()),
+            logo_url_light: Some("/branding/logo-light.svg".to_string()),
+            logo_url_dark: Some("/branding/logo-dark.svg".to_string()),
             accent_color: Some("#3b82f6".to_string()),
             background_color_dark: Some("#0a0a0f".to_string()),
             background_color_light: Some("#faf5ef".to_string()),
@@ -75,6 +87,8 @@ mod tests {
         let json = serde_json::to_value(&config).unwrap();
         assert_eq!(json["chain_name"], "MyChain");
         assert_eq!(json["logo_url"], "/branding/logo.svg");
+        assert_eq!(json["logo_url_light"], "/branding/logo-light.svg");
+        assert_eq!(json["logo_url_dark"], "/branding/logo-dark.svg");
         assert_eq!(json["accent_color"], "#3b82f6");
         assert_eq!(json["background_color_dark"], "#0a0a0f");
         assert_eq!(json["background_color_light"], "#faf5ef");

backend/crates/atlas-server/src/api/handlers/faucet.rs

@@ -173,6 +173,8 @@ mod tests {
             chain_id: 1,
             chain_name: "Test Chain".to_string(),
             chain_logo_url: None,
+            chain_logo_url_light: None,
+            chain_logo_url_dark: None,
             accent_color: None,
             background_color_dark: None,
             background_color_light: None,

backend/crates/atlas-server/src/api/handlers/status.rs

@@ -115,6 +115,8 @@ mod tests {
             chain_id: 1,
             chain_name: "Test Chain".to_string(),
             chain_logo_url: None,
+            chain_logo_url_light: None,
+            chain_logo_url_dark: None,
             accent_color: None,
             background_color_dark: None,
             background_color_light: None,

backend/crates/atlas-server/src/api/mod.rs

@@ -25,6 +25,8 @@ pub struct AppState {
     pub chain_id: u64,
     pub chain_name: String,
     pub chain_logo_url: Option<String>,
+    pub chain_logo_url_light: Option<String>,
+    pub chain_logo_url_dark: Option<String>,
     pub accent_color: Option<String>,
     pub background_color_dark: Option<String>,
     pub background_color_light: Option<String>,
@@ -273,6 +275,8 @@ mod tests {
             chain_id: 1,
             chain_name: "Test Chain".to_string(),
             chain_logo_url: None,
+            chain_logo_url_light: None,
+            chain_logo_url_dark: None,
             accent_color: None,
             background_color_dark: None,
             background_color_light: None,

backend/crates/atlas-server/src/cli.rs

@@ -243,6 +243,22 @@ pub struct ChainArgs {
         help = "URL to the chain logo image"
     )]
     pub logo_url: Option<String>,
+
+    #[arg(
+        long = "atlas.chain.logo-url-light",
+        env = "CHAIN_LOGO_URL_LIGHT",
+        value_name = "URL",
+        help = "URL to the chain logo image used in light theme"
+    )]
+    pub logo_url_light: Option<String>,
+
+    #[arg(
+        long = "atlas.chain.logo-url-dark",
+        env = "CHAIN_LOGO_URL_DARK",
+        value_name = "URL",
+        help = "URL to the chain logo image used in dark theme"
+    )]
+    pub logo_url_dark: Option<String>,
 }
 
 #[derive(Args, Clone)]

backend/crates/atlas-server/src/config.rs

@@ -48,6 +48,8 @@ pub struct Config {
 
     // Branding / white-label
     pub chain_logo_url: Option<String>,
+    pub chain_logo_url_light: Option<String>,
+    pub chain_logo_url_dark: Option<String>,
     pub accent_color: Option<String>,
     pub background_color_dark: Option<String>,
     pub background_color_light: Option<String>,
@@ -198,6 +200,8 @@ impl Config {
                 .filter(|s| !s.is_empty())
                 .unwrap_or_else(|| "Unknown".to_string()),
             chain_logo_url: parse_optional_env(env::var("CHAIN_LOGO_URL").ok()),
+            chain_logo_url_light: parse_optional_env(env::var("CHAIN_LOGO_URL_LIGHT").ok()),
+            chain_logo_url_dark: parse_optional_env(env::var("CHAIN_LOGO_URL_DARK").ok()),
             accent_color: parse_optional_env(env::var("ACCENT_COLOR").ok()),
             background_color_dark: parse_optional_env(env::var("BACKGROUND_COLOR_DARK").ok()),
             background_color_light: parse_optional_env(env::var("BACKGROUND_COLOR_LIGHT").ok()),
@@ -324,6 +328,8 @@ impl Config {
             sse_replay_buffer_blocks,
             chain_name,
             chain_logo_url: parse_optional_env(args.chain.logo_url),
+            chain_logo_url_light: parse_optional_env(args.chain.logo_url_light),
+            chain_logo_url_dark: parse_optional_env(args.chain.logo_url_dark),
             accent_color: parse_optional_env(args.branding.accent_color),
             background_color_dark: parse_optional_env(args.branding.background_dark),
             background_color_light: parse_optional_env(args.branding.background_light),
@@ -461,6 +467,8 @@ mod tests_from_run_args {
             chain: cli::ChainArgs {
                 name: "TestChain".to_string(),
                 logo_url: None,
+                logo_url_light: None,
+                logo_url_dark: None,
             },
             da: cli::DaArgs {
                 enabled: false,
@@ -572,12 +580,30 @@ mod tests_from_run_args {
     #[test]
     fn branding_blank_strings_become_none() {
         let mut args = minimal_run_args();
-        args.branding.accent_color = Some("   ".to_string());
+        args.chain.logo_url_light = Some("   ".to_string());
         args.branding.success_color = Some("#00ff00".to_string());
         let config = Config::from_run_args(args).unwrap();
-        assert!(config.accent_color.is_none());
+        assert!(config.chain_logo_url_light.is_none());
         assert_eq!(config.success_color.as_deref(), Some("#00ff00"));
     }
+
+    #[test]
+    fn theme_specific_logo_urls_are_trimmed() {
+        let mut args = minimal_run_args();
+        args.chain.logo_url_light = Some("  /branding/light.svg  ".to_string());
+        args.chain.logo_url_dark = Some("  /branding/dark.svg  ".to_string());
+
+        let config = Config::from_run_args(args).unwrap();
+
+        assert_eq!(
+            config.chain_logo_url_light.as_deref(),
+            Some("/branding/light.svg")
+        );
+        assert_eq!(
+            config.chain_logo_url_dark.as_deref(),
+            Some("/branding/dark.svg")
+        );
+    }
 }
 
 #[cfg(test)]
@@ -606,6 +632,12 @@ mod tests {
         env::remove_var("FAUCET_COOLDOWN_MINUTES");
     }
 
+    fn clear_branding_env() {
+        env::remove_var("CHAIN_LOGO_URL");
+        env::remove_var("CHAIN_LOGO_URL_LIGHT");
+        env::remove_var("CHAIN_LOGO_URL_DARK");
+    }
+
     fn set_valid_faucet_env() {
         env::set_var("FAUCET_ENABLED", "true");
         env::set_var(
@@ -620,6 +652,7 @@ mod tests {
     fn chain_name_defaults_to_unknown_when_unset() {
         let _lock = ENV_LOCK.lock().unwrap();
         set_required_env();
+        clear_branding_env();
         env::remove_var("CHAIN_NAME");
         assert_eq!(Config::from_env().unwrap().chain_name, "Unknown");
     }
@@ -628,6 +661,7 @@ mod tests {
     fn chain_name_defaults_to_unknown_when_empty() {
         let _lock = ENV_LOCK.lock().unwrap();
         set_required_env();
+        clear_branding_env();
         env::set_var("CHAIN_NAME", "");
         assert_eq!(Config::from_env().unwrap().chain_name, "Unknown");
         env::remove_var("CHAIN_NAME");
@@ -637,6 +671,7 @@ mod tests {
     fn chain_name_defaults_to_unknown_when_whitespace_only() {
         let _lock = ENV_LOCK.lock().unwrap();
         set_required_env();
+        clear_branding_env();
         env::set_var("CHAIN_NAME", "   ");
         assert_eq!(Config::from_env().unwrap().chain_name, "Unknown");
         env::remove_var("CHAIN_NAME");
@@ -646,6 +681,7 @@ mod tests {
     fn chain_name_uses_provided_value() {
         let _lock = ENV_LOCK.lock().unwrap();
         set_required_env();
+        clear_branding_env();
         env::set_var("CHAIN_NAME", "MyChain");
         assert_eq!(Config::from_env().unwrap().chain_name, "MyChain");
         env::remove_var("CHAIN_NAME");
@@ -655,11 +691,34 @@ mod tests {
     fn chain_name_trims_surrounding_whitespace() {
         let _lock = ENV_LOCK.lock().unwrap();
         set_required_env();
+        clear_branding_env();
         env::set_var("CHAIN_NAME", "  MyChain  ");
         assert_eq!(Config::from_env().unwrap().chain_name, "MyChain");
         env::remove_var("CHAIN_NAME");
     }
 
+    #[test]
+    fn theme_specific_logo_urls_are_read_from_env() {
+        let _lock = ENV_LOCK.lock().unwrap();
+        set_required_env();
+        clear_branding_env();
+        env::set_var("CHAIN_LOGO_URL_LIGHT", "  /branding/light.svg  ");
+        env::set_var("CHAIN_LOGO_URL_DARK", "  /branding/dark.svg  ");
+
+        let config = Config::from_env().unwrap();
+
+        assert_eq!(
+            config.chain_logo_url_light.as_deref(),
+            Some("/branding/light.svg")
+        );
+        assert_eq!(
+            config.chain_logo_url_dark.as_deref(),
+            Some("/branding/dark.svg")
+        );
+
+        clear_branding_env();
+    }
+
     #[test]
     fn optional_env_returns_none_when_unset() {
         assert_eq!(parse_optional_env(None), None);

backend/crates/atlas-server/src/main.rs

@@ -280,6 +280,8 @@ async fn run(args: cli::RunArgs) -> Result<()> {
         chain_id,
         chain_name: config.chain_name.clone(),
         chain_logo_url: config.chain_logo_url.clone(),
+        chain_logo_url_light: config.chain_logo_url_light.clone(),
+        chain_logo_url_dark: config.chain_logo_url_dark.clone(),
         accent_color: config.accent_color.clone(),
         background_color_dark: config.background_color_dark.clone(),
         background_color_light: config.background_color_light.clone(),

backend/crates/atlas-server/tests/integration/common.rs

@@ -73,6 +73,8 @@ pub fn test_router() -> Router {
         chain_id: 42,
         chain_name: "Test Chain".to_string(),
         chain_logo_url: None,
+        chain_logo_url_light: None,
+        chain_logo_url_dark: None,
         accent_color: None,
         background_color_dark: None,
         background_color_light: None,

frontend/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "vite",
-    "build": "tsc -b && vite build",
+    "build": "bunx vite build",
     "lint": "eslint .",
     "preview": "vite preview"
   },
@@ -19,6 +19,7 @@
   "devDependencies": {
     "@eslint/js": "^9.39.1",
     "@preact/preset-vite": "^2.10.4",
+    "@types/bun": "^1.3.2",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.5",
     "@types/react-dom": "^19.2.3",

frontend/src/api/config.ts

@@ -3,6 +3,8 @@ import client from './client';
 export interface BrandingConfig {
   chain_name: string;
   logo_url?: string;
+  logo_url_light?: string;
+  logo_url_dark?: string;
   accent_color?: string;
   background_color_dark?: string;
   background_color_light?: string;