Links
Comment on page

Branding Configs

This page is currently in development. See the ENV Variables page for more info on specific variables mentioned below.
Note: if you've previously deployed and are updating your BlockScout version with new assets, be sure to remove static assets from the previous build (use mix phx.digest.cleanor manually delete assets located in apps/block_scout_web/priv/static folder) before updating current files and restarting/rebuilding BlockScout.
In order to rebuild new front-end assets run the following. Note: If preferred, use npm ci rather than npm install to strictly follow all package versions in package-lock.json
  1. 1.
    cd apps/block_scout_web/assets; npm install && node_modules/webpack/bin/webpack.js --mode production; cd -
  2. 2.
    mix phx.digest
  1. 1.
    Theme Colors and other CSS-based attributes: See CSS Configs and Presets to set your instance to the stylesheet you want to use.
  2. 2.
    Logos: Use the LOGO and FOOTER_LOGO env variables to direct to your uploaded logos. Logos and other assets are located in the apps/block_scout_web/assets/static/images folder.
  3. 3.
    Coin: Customize the coin symbol using the COIN & COINGECKO_COIN_ID env variables.
  4. 4.
    MetaData: MetaTags can be adjusted for various pages in the templates area. For the home page, tag data is rendered from here: /apps/block_scout_web/lib/block_scout_web/templates/chain/_metatags.html.eex
  5. 5.
    Titles / Subtitles: Browser tab displays the title from the 2 SUBNETWORK + NETWORK env variables.
  6. 6.
    Favicon: replace the current favicons located in the apps/block_scout_web/assets/static/images folder.
  7. 7.
    Menus: Use the APPS_MENU env variable to include an apps menu and EXTERNAL_APPS to populate the menu.
  8. 8.
    Top navigation bar: Data is rendered from here:
    /apps/block_scout_web/lib/block_scout_web/templates/layout/_topnav.html.eex
  9. 9.
    Footer: Data is rendered from here: /apps/block_scout_web/lib/block_scout_web/templates/layout/_footer.html.eex ENV variables for footer links
    1. 1.
      FOOTER_CHAT_LINK ​
    2. 2.
      FOOTER_FORUM_LINK
    3. 3.
      FOOTER_GITHUB_LINK
  10. 10.
    Custom Theming: Custom theming is available from the BlockScout team. Learn More.
Last modified 7mo ago