Lux Docs

Frontend

Next.js 15 explorer frontend with Chakra UI

The explorer frontend is a Next.js 15 application using React 19 and Chakra UI v3 with a monochrome design system.

Technology

LibraryVersionPurpose
Next.js15React framework (Pages Router)
React19UI library
Chakra UIv3Component library
Wagmi2Wallet integration
Viem2Ethereum utilities
VitestUnit testing
PlaywrightE2E testing

Structure

explore/
├── pages/          # Next.js page routes (62 files)
├── ui/             # Feature-based UI (71 dirs)
├── lib/            # Business logic (192 files)
├── toolkit/        # Design system layer
├── configs/app/    # Runtime configuration
├── deploy/         # Docker + Helm + scripts
└── public/         # Static assets

Design System

  • Fonts: Geist Sans + Geist Mono
  • Theme: Dark mode default, monochrome palette
  • Icons: Lucide React
  • Colors: Semantic tokens in toolkit/theme/foundations/
  • ESLint: Enforces design system usage (no hardcoded colors, use toolkit components)

On this page