Console overview

The Golain Platform Web (pw) is the browser UI for managing organizations, projects, fleets, devices, edge replication, integrations, and settings.

Access the console

Environment	URL
Production	`https://web.ilyama.golain.io` (or your operator URL)
Local dev	`http://localhost:5173` after `npm run dev`

Sign in with Zitadel OIDC. After login the app stores your access token and sends it on every API request together with the active ORG-ID header.

Layout

┌─────────────────────────────────────────────────────────┐
│  Header — org switcher, project switcher, user menu      │
├──────────────┬──────────────────────────────────────────┤
│  Sidebar     │  Main content (lazy-loaded feature)      │
│  (per        │                                          │
│   project)   │                                          │
└──────────────┴──────────────────────────────────────────┘

Routes follow /:org_id/:project_id/<feature>. Changing org or project updates the URL and reloads scoped data.

Feature modules

Module	Purpose
Home	Project dashboard and shortcuts
Fleets & devices	Fleet CRUD, device list, device detail, certificates
Edge Sync	SQLite replication policies, governance, lineages
Connections	Integration accounts and bindings
Dashboard	Panel visualizations
Rule engine / Quick rules	Automation pipelines
Logs & activities	Audit and alert views
Settings	Org and project configuration
User authentication	Members and access
Analysis / Reports / Query builder	Data exploration

Each module loads on demand for faster initial page load.

Local development with mock data

Developers can run the UI without a live backend:

cd pw
npm install
cp .env.example .env   # VITE_MOCK_AUTH=true by default
npm run mock:server    # terminal 1 — Hono API on :8899
npm run dev            # terminal 2 — Vite on :5173

Mock mode seeds a fake Dev User and realistic sample fleets/devices. Switch to real auth by setting VITE_MOCK_AUTH=false and configuring Zitadel variables in .env. Many console actions have CLI equivalents in platform-tui — useful for scripting and CI.

Fleets & devices

Create fleets, register devices, view MQTT details.

Edge Sync

Replicate SQLite from devices — policies, bundles, governance.

​Access the console

​Layout

​Feature modules

​Local development with mock data

​Related tools