Deploy

Deploy your Apps to production with Hypermode

Once you’ve developed and tested your App locally, you’re ready to deploy it to production on Hypermode. This guide walks you through setting up automatic deployment for your Modus app.

Prerequisites

Before deploying, ensure you have:

• A completed Modus app (see the Develop guide for setup)
• A GitHub account and repository
• Your app configured in the Hypermode console (see the Create Your App guide)

Automatic deployment via GitHub Actions

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

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

This workflow can stray out of date as new Golang releases are made. If you encounter issues, checkout our open source recipes repo.

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.24.5"

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

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

      - name: Publish GitHub artifact
        uses: actions/upload-artifact@v4
        with:
          name: build
          path: ./build/*
          retention-days: 7

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

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.