WaymakerOS Help Center

Deploy your first app in 5 minutes. This guide walks you through the fastest path from zero to live.

Prerequisites

A Waymaker account with an organization
A GitHub account with a repository to deploy
The Waymaker GitHub App installed (we'll do this in step 1)

Step 1: Connect GitHub

Before you can deploy apps, connect your GitHub account to Waymaker:

Go to Host in Commander
Click Connect GitHub
Authorize the Waymaker GitHub App
Select which repositories to grant access to

This creates a secure connection between your GitHub repos and the Waymaker build pipeline.

Step 2: Create Your App

Using the CLI

waymaker auth login
waymaker host apps create \
  --name "my-first-app" \
  --repo https://github.com/yourorg/your-repo \
  --branch main \
  --framework react

Using Claude Desktop

"Create a new app called my-first-app from my GitHub repo https://github.com/yourorg/your-repo"

What Happens

Waymaker provisions your app on Cloudflare's global CDN
Links it to your GitHub repository
Auto-detects your framework and build settings
Triggers the first deployment

Step 3: Watch Your Build

Your app is now building. Check status:

waymaker host apps get <app-id>

Or ask Claude: "What's the status of my app my-first-app?"

The first build typically takes 1-3 minutes depending on your project size.

Step 4: Visit Your App

Once deployed, your app is live at:

https://<slug>.waymakerapp.com

Every app gets a free *.waymakerapp.com subdomain with automatic SSL.

Step 5: Set Up a Custom Domain (Optional)

Want your own domain? Three steps:

# 1. Start domain setup
waymaker host domains setup <app-id> --domain app.yourdomain.com

# 2. Add DNS records (shown in output)
# CNAME: app → <slug>.waymakerapp.com
# TXT: _waymaker-verify.app → waymaker-verify=<token>

# 3. Verify DNS
waymaker host domains verify <app-id>

SSL is provisioned automatically after DNS verification.

What's Next

Add environment variables — waymaker host env set <app-id> --var API_KEY=abc123
Set up auto-deploy — Every push to your branch triggers a build automatically
Add a custom domain — Custom Domains guide
Build an ambassador — Serverless Functions guide

Getting Started with Waymaker Host