Getting Started with the Console

The Geog console is your central dashboard for managing organizations, API tokens, billing, and usage. This guide walks you through creating your account and getting set up.

Creating Your Account

  1. Go to geog.dev and click Sign Up
  2. Enter your email address and create a password
  3. Check your email for a verification code
  4. Enter the code on the verification page to confirm your account

You can also sign up using a magic link — enter your email on the login page and click "Sign in with magic link" to receive a one-time login link.

Your First Organization

After verifying your email, you'll be prompted to create your first organization:

  1. Choose a name for your organization (e.g., your company or project name)
  2. The system generates a unique slug (URL-friendly identifier) from your name
  3. Click Create Organization

You'll be assigned the owner role automatically, giving you full control over the organization.

Dashboard Overview

Once inside your organization, the dashboard shows:

  • Usage summary — Current tile and places API request counts
  • Rate limit status — Remaining requests for free tier organizations
  • Recent activity — Latest API usage and member activity
  • Quick actions — Links to create tokens, invite members, and set up billing

Getting Started Checklist

After creating your organization, here's what to do next:

1. Create an API Token

You need an API token to make requests to the Geog API.

  1. Go to Tokens in the sidebar
  2. Click Create Token
  3. Give it a descriptive name (e.g., "Development" or "Production")
  4. Select the scopes you need (e.g., tiles:read)
  5. Copy the token — it won't be shown again

See Token Management for details.

2. Make Your First API Request

Test your token with a simple vector tile request:

curl "https://api.geog.dev/v1/tiles/twin-cities/14/4680/6125.mvt" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

3. Invite Your Team

If you're working with others, invite them to your organization:

  1. Go to Members in the sidebar
  2. Click Invite Member
  3. Enter their email and select a role

See Organization Management for details.

4. Set Up Billing (Optional)

The free tier includes 2,000 tile requests and 1,000 places requests per day. If you need higher limits, set up billing:

  1. Go to Billing in the sidebar
  2. Follow the setup wizard

See Billing Setup for the full walkthrough.

Next Steps