> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ilyama.golain.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Console overview

> Navigate the Golain web console — org scope, modules, and mock development mode.

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:

```bash theme={null}
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`.

## Related tools

Many console actions have CLI equivalents in [platform-tui](/tools/platform-tui/overview) — useful for scripting and CI.

<CardGroup cols={2}>
  <Card title="Fleets & devices" icon="server" href="/console/fleets-and-devices">
    Create fleets, register devices, view MQTT details.
  </Card>

  <Card title="Edge Sync" icon="database" href="/console/edge-sync">
    Replicate SQLite from devices — policies, bundles, governance.
  </Card>
</CardGroup>