CLI Configuration

Local files, credentials, and environment variables

Project file layout

your-project/
├── analytics/
│   ├── events.ts
│   └── dashboards/
│       └── overview.ts
└── .realanalytics/
    ├── credentials.json
    ├── events.json          # generated by build/deploy
    └── dashboards.json      # generated by build/deploy

Project credentials file

Created by realanalytics init at.realanalytics/credentials.json.

{
  "projectId": "proj_xxx",
  "projectSlug": "my-project-ab12cd",
  "publicKey": "pk_live_xxx",
  "secretKey": "sk_live_xxx"
}

Keep this file private. The secretKey is used for deploy.

User auth file

Stored outside the repo at ~/.realanalytics/auth.json afterrealanalytics login.

{
  "userId": "user_xxx",
  "token": "cli_live_xxx",
  "expiresAt": 1735689600000,
  "authenticatedAt": "2026-02-03T12:00:00.000Z"
}

Environment variables

Variable	Used by	Purpose
`REALANALYTICS_TOKEN`	init / deploy / status / whoami	Use a CLI access token without interactive login
`REALANALYTICS_DASHBOARD_URL`	login / init / deploy	Override dashboard API host
`REALANALYTICS_INGEST_URL`	deploy output	Override ingest URL shown after deploy

.gitignore

# Realanalytics secrets + generated files
.realanalytics/

Manual safety checks