mirror of https://github.com/luxfi/explore.git synced 2026-09-24 00:28:18 +00:00

Files

T

zeekay de647bf4ba the face is Zen, and it ships from @hanzo/font

One family. Font stacks name Zen and fall back to the native faces, tokens
name the role rather than a face, and the packages that used to supply a
face now point at @hanzo/font.

Self-hosted @font-face blocks are removed rather than renamed: rewriting the
family in one would leave a src pointing at a file this repo no longer ships.
@hanzo/font carries the binaries and declares the faces, so the local copies
go with the declaration that used them.

Comments naming a face we no longer use are deleted, not reworded.

2026-09-01 08:25:40 -07:00

3.2 KiB

Raw Blame History

Blockchain Explorer Deployment Guide

This repository contains the frontend for blockchain explorers across the LUX ecosystem (LUX, ZOO, SPC, Hanzo networks).

Architecture

Each network has its own GitHub fork of this repository:

luxfi/explore - LUX Network explorer
luxfi/explore-zoo - ZOO Network explorer
luxfi/explore-spc - SPC Network explorer
luxfi/explore-hanzo - Hanzo Network explorer

Configuration

Minimal Changes Per Fork

Each fork only needs to modify:

Environment variables in .env or compose.prod.yml
Favicon in public/favicon/favicon.png
Network logo URLs in environment variables

Font Configuration

All networks use Inter font by default. This is configured via environment variables:

NEXT_PUBLIC_FONT_FAMILY_HEADING={"name": "Zen", "url": ""}
NEXT_PUBLIC_FONT_FAMILY_BODY={"name": "Zen", "url": ""}

Monospace fonts use Roboto Mono (hardcoded in theme/foundations/typography.ts).

All explorers share a network dropdown configured via public/networks.json. This file lists all available networks across the ecosystem.

Deployment

Each fork includes a compose.prod.yml file for production deployment:

# Deploy using Docker Compose
docker-compose -f compose.prod.yml up -d

Traefik Integration

The compose file includes Traefik labels for automatic SSL and routing:

traefik.http.routers.[network]-explorer.rule=Host(\explore.[network].network`)`
Automatic Let's Encrypt SSL certificates
Requires external traefik network

Example Deployment Commands

# Clone the appropriate fork
git clone https://github.com/luxfi/explore.git       # For LUX
git clone https://github.com/luxfi/explore-zoo.git   # For ZOO
git clone https://github.com/luxfi/explore-spc.git   # For SPC
git clone https://github.com/luxfi/explore-hanzo.git # For Hanzo

# Enter directory
cd explore

# Deploy
docker-compose -f compose.prod.yml up -d

Maintenance

Syncing with Upstream

To update from the upstream Blockscout repository:

# Add upstream remote (one time)
git remote add upstream https://github.com/blockscout/frontend.git

# Fetch and merge latest changes
git fetch upstream
git merge upstream/main

# Push to origin
git push origin main

Building Custom Images

If you need to build a custom Docker image:

docker build -t luxfi/explorer-frontend:latest .

Network-Specific Configuration

LUX Network

Domain: explore.lux.network
Chain ID: 96369 (mainnet), 96368 (testnet)
Currency: LUX

ZOO Network

Domain: explore.zoo.network
Chain ID: 200200 (mainnet), 200201 (testnet)
Currency: ZOO

SPC Network

Domain: explore.spc.network
Chain ID: 36911 (mainnet), 36912 (testnet)
Currency: SPC

Hanzo Network

Domain: explore.hanzo.network
Chain ID: 36963 (mainnet), 36962 (testnet)
Currency: HANZO

Environment Variables

See .env.example for all available configuration options. Key variables:

NEXT_PUBLIC_NETWORK_* - Network identification
NEXT_PUBLIC_API_HOST - Backend API host
NEXT_PUBLIC_FEATURED_NETWORKS - Path to networks dropdown config
NEXT_PUBLIC_COLOR_THEME_DEFAULT - Theme (dark/light)
NEXT_PUBLIC_FONT_FAMILY_* - Font configuration

3.2 KiB Raw Blame History