Access & Setup
GGNomad is a managed platform — there is nothing to install to use it. The web app is the complete product surface, and developers reach the same data through the GraphQL API. This page explains how to get access and set up a developer environment.
Mobile apps, CLI, and SDKs are roadmap.
Get access
Create an account
- Go to app.ggnomad.com
- Sign up for an account
- Sign in to the web app with single sign-on (OIDC)
Workspaces
GGNomad runs inside a Burdenoff workspace — the container that owns members, roles, listings, bookings, trips, billing, and audit. One identity can hold multiple roles (traveler, host/operator, administrator); every action is scoped by role. Partners can request a dedicated tenant.
Surfaces
| Surface | What it's for | Status |
|---|---|---|
| Web app | The full product — discovery, itinerary, checkout, trips, host tools, admin | Primary |
| Burdenoff workspace app | GGNomad available alongside your other Burdenoff products in one workspace | Available |
| GraphQL API | Programmatic access for partners and integrations | Available |
| Mobile app | iOS and Android for on-the-go discovery and trips | Roadmap |
| CLI / SDKs / MCP | Terminal, Node/Python, and AI-agent access | Roadmap |
Environment selection
All GGNomad tools default to production endpoints. To target a different
environment, set BURDENOFF_ENV before installing or running any tool:
BURDENOFF_ENV | Workspace gateway | Global gateway | Web app |
|---|---|---|---|
prod (default) | https://graphqlworkspaces.burdenoff.com/workspaces/graphql | https://graphql.burdenoff.com/global/graphql | https://app.ggnomad.com |
alpha | https://alphagraphqlworkspaces.burdenoff.com/workspaces/graphql | https://alphagraphql.burdenoff.com/global/graphql | https://alphaapp.ggnomad.com |
local | http://localhost:4003/workspaces/graphql | http://localhost:4000/global/graphql | http://localhost:3000 |
export BURDENOFF_ENV=alpha # Target alpha
export BURDENOFF_ENV=local # Target local stack
Developer setup
You do not deploy GGNomad yourself — you connect to the hosted API.
1. Get a credential
Issue an OAuth client or workspace-scoped API key from the developer portal.
2. Point at the API endpoint
All GraphQL operations go to a single endpoint, which authenticates and permission-checks every request:
POST /workspaces/graphql
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
3. Confirm connectivity
Run a read query to verify your token and workspace scope:
query Ping {
ggnomadProperties(pagination: { skip: 0, take: 1 }) { id name }
}
If this returns inventory, you're set up — head to the Quick Start and API Reference.
Recommended developer environment
- A recent Node.js LTS (v20 or later) for tooling and the future SDKs
- A GraphQL client (or
curl) for ad-hoc queries - A development workspace and test data so you never touch live inventory
Next steps
- Quick Start — discover, plan, book, and query the API
- Core Concepts — the entities behind the product
- Developer Guide — build and integrate