Once you’ve developed and tested your App locally, you’re ready to deploy it to production on Hypermode. This guide walks you through creating an app in the Hypermode console and deploying your Modus code.

​
Prerequisites

Before deploying, ensure you have:

  • A completed Modus app (see the Develop guide for setup)
  • A GitHub account and repository

​
Step 1: Create your workspace

Note: The hyp link command is currently turned off during migration. Manual configuration through the Hypermode console is required.

First, go to hypermode.com and create your workspace.

Enter a name for your workspace and click Create workspace. Workspaces are where you and your team manage apps in Hypermode.

​
Step 2: Create a New App

Note: The hyp link command is currently turned during migration. Manual configuration through the Hypermode console is required.

From the dashboard, click ‘Apps’

Click “Import your Modus app” to start creating your app.

​
Step 3: Configure Your App

Fill in the app configuration details:

Configure your app settings:

  • Modus app name: Enter your app name, for example my-modus-app
  • GitHub Repository: Select your existing repository from the dropdown
  • Modus app location: Choose your deployment region

If you don’t have a repository yet, you can create one first.

​
Step 4: Create your GitHub repository

If you need to create a new repository:

Fill in your repository details:

  • Choose the repository owner (your organization or personal account)
  • Enter a memorable repository name for example my-modus-app
  • Add an optional description

Then return to the app configuration and select your newly created repository.

​
Step 5: View your App configuration

Once your app is created, you’ll see your app’s configuration:

Once your app is created, you’ll see your app’s configuration:

Your app is now configured with:

  • Endpoint: Your production GraphQL endpoint
  • GitHub repository: Connected repository for deployments
  • API key: Authentication key for your app

​
Deployment options

You have one primary way to deploy your app to Hypermode:

​
Automatic deployment via GitHub Actions

Add a GitHub Actions workflow to your repository for automatic deployments.

Create .github/workflows/ci-modus-build.yml:

name: ci-modus-build

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: "22"

      - name: Setup Go
        uses: actions/setup-go@v5
        with:
          go-version: "1.23.1"

      - name: Setup TinyGo
        uses: acifani/setup-tinygo@v2
        with:
          tinygo-version: "0.34.0"

      - name: Build project
        run: npx -p @hypermode/modus-cli -y modus build

Once the workflow is added, any push to the main branch automatically deploys your app:

# Commit your changes
git add .
git commit -m "Deploy my Modus app"

# Push to trigger deployment
git push origin main

The deployment automatically:

  1. Builds your Modus app via GitHub Actions
  2. Deploys to your Hypermode endpoint
  3. Makes your functions available via GraphQL

Deployment output:

🚀 Deployment started for commit abc123d
📦 Building application...
✓ Functions compiled successfully
🌐 Deploying to production...
✓ Health checks passed
🎉 Deployment complete!

Endpoint: https://my-modus-app-my-workspace-hurx1.hypermode.app/graphql

​
Production features

Your deployed app includes:

  • Automatic scaling: Functions scale to zero when not in use
  • HTTPS endpoints: Secure GraphQL API
  • Bearer token auth: API key authentication
  • Real-time logs: Monitor function execution in the Activity tab
  • Environment variables: Manage secrets and configuration

​
Viewing function activity

Monitor your function executions in the Activity tab:

You can see:

  • Function execution history
  • Response times and duration
  • Success/error status
  • Execution timestamps

​
Environment variables

Configure environment variables in the Environment variables tab:

Set production environment variables for:

  • API keys and secrets
  • Database connection strings
  • Feature flags
  • External service configurations

​
Testing your deployment

Test your deployed functions via GraphQL:

curl -X POST https://your-app-endpoint.hypermode.app/graphql \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ sayHello(name: \"Production\") }"}'

​
Next steps

With your app deployed, your development workflow becomes:

  1. Develop and test locally with modus dev
  2. Commit and push changes to GitHub
  3. Automatic deployment to production
  4. Monitor via Hypermode console

Your Modus app is now live and ready to handle production traffic with automatic scaling, built-in observability, and secure endpoints.