Configuration

Environment variables and build settings

Development Setup

1

Clone and install

git clone https://github.com/calimero-network/admin-dashboard
cd admin-dashboard
pnpm install
2

Start dev server

pnpm dev
# Starts at http://localhost:5173
3

Build for production

pnpm build
# Output in dist/

Vite Configuration

Key settings in vite.config.ts:

base
Set to '/' for local deployment or '/admin-dashboard/' for GitHub Pages hosting at a subpath.
server.proxy
In development, can proxy /api to the local node URL to avoid CORS issues during development.
build.outDir
Default: dist/. This directory is deployed to GitHub Pages.

Node Connection

The node URL is entered by the user on first use and stored in localStorage under calimeroNodeUrl. There is no build-time environment variable for the node URL — it is runtime-configurable.

This allows a single deployed build to connect to any Calimero node — local, staging, or production — by changing the stored URL.