Waymaker
Waymaker Host

Hosting Apps

Learn about Hosting Apps in WaymakerOS.

AppsHostingFrameworks

Apps are web applications deployed through Waymaker Host — from static sites to full server-rendered apps with API routes and sign-ins. Host detects which kind yours is and deploys it to the right runtime automatically, on Waymaker's global edge network — 330+ cities, sub-50ms latency, automatic SSL and DDoS protection. Every app gets automatic builds from GitHub.

Creating an App

Required Fields

  • name — Used to generate the URL slug (e.g., "Customer Portal" becomes customer-portal)

Optional Fields

  • repository_url — GitHub repo URL (e.g., https://github.com/org/repo)
  • repository_branch — Branch to deploy from (default: main)
  • framework — Framework preset: next, react, vue, astro, svelte, remix, nuxt, gatsby, docusaurus, angular, solid
  • build_command — Custom build command (e.g., npm run build)
  • root_dir — Root directory for monorepo projects (e.g., apps/my-app)
  • output_dir — Build output directory (e.g., dist, .next, build)
  • workspace_id — Associate with a specific workspace

CLI Example

This can also be done from the Waymaker CLI — see the command reference in the developer docs.

MCP Example

"Create an app called customer-portal from github.com/acme/portal, it's a Next.js app in the apps/portal directory"

Framework Detection

If you don't specify a framework, Waymaker can auto-detect it from your repository. It checks for:

  • next.config.js / next.config.ts → Next.js
  • nuxt.config.ts → Nuxt
  • remix.config.js → Remix
  • astro.config.mjs → Astro
  • gatsby-config.js → Gatsby
  • svelte.config.js → SvelteKit
  • angular.json → Angular
  • vite.config.ts with Vue → Vue
  • vite.config.ts with React → React (Vite)
  • vite.config.ts with Solid → Solid

Monorepo Support

For monorepo projects, set the root_dir to point to your app's directory:

This can also be done from the Waymaker CLI — see the command reference in the developer docs.

The build runner will cd into the root directory before running your build command.

App Lifecycle

StatusMeaning
pendingCreated, no deployment yet
buildingBuild in progress
activeSuccessfully deployed and live
errorLast build failed
archivedSoft-deleted

Updating an App

Change any configuration field after creation:

This can also be done from the Waymaker CLI — see the command reference in the developer docs.

Deleting an App

Apps are soft-deleted (archived). The hosting project remains but stops receiving new deployments:

This can also be done from the Waymaker CLI — see the command reference in the developer docs.

Only the creator can archive an app.

Restoring an Archived App

If you archived an app and want to bring it back:

  1. Open Host and find the archived app
  2. Go to Settings
  3. Click Restore
  4. Push to your repository to trigger a new deployment

Team & Collaboration

Every app has team members with different access levels:

RoleAccess
CreatorFull access — deploy, settings, team, archive/restore
CollaboratorDeploy, edit settings, manage environment variables
ViewerRead-only — cannot see environment variable values

See App Team & Collaboration for details on managing your team.

Next Steps