major app manages apps: Next.js projects backed by a GitHub repository and deployed on Major. Most subcommands act on the app in the current directory, so run them from inside the app’s folder.
Every
major app subcommand checks that Node.js 22.12 or later and pnpm are installed before it runs.major app create
Create a new Next.js app with its own GitHub repository.major user gitconfig.
major app clone
Select and clone an app repository from your organization, then generate its.env file and resource clients.
major app start
Start the app locally. The command regenerates.env, syncs theme files, runs pnpm install, then runs pnpm dev. It warns if your local branch is behind origin/main.
major app deploy
Create a new version by committing and pushing your changes, then deploying it to Major. The command waits and reports the deployment status unless you pass--no-wait.
major app deploy-status
Show the current deployment status for a version.major app info
Show the app in the current directory, including its application ID, deploy status, and URL.major app logs
Show logs for the app in the current directory, newest first. By default you get the deployed app’s logs. Pass--preview to read the sandbox dev server’s logs instead.
major app errors
Inspect the app’s runtime errors.major app errors list
List recent runtime errors. Active errors are returned by default.major app errors get
Show one error’s full detail, including its stack trace.major app errors resolve
Mark an error fixed.major app errors enable
Mark the app as having runtime error reporting enabled. This drives the “monitoring active” state in the dashboard. Run it only after the Major error-reporter scaffolding is committed to the repository. Running it more than once has no extra effect.major app configure
Open the current app’s settings in your default browser.major app theme
Read and apply your organization’s saved brand themes.major app theme list
List your organization’s saved themes.major app theme get
Print the app’s design system, as guidance to follow before frontend work.major app theme apply
Re-brand the app to one of your organization’s saved themes. The command pins the theme on the app, then writes the generated files into your checkout:app/theme.css, lib/theme.ts, and components/ui/logo.tsx. It works in any checkout of the repository, including a plain local clone.
major app ai-proxy
Inspect and enable the app’s AI proxy.major app ai-proxy status
Show whether the AI proxy is enabled and this month’s spend.major app ai-proxy enable
Enable the AI proxy for the app. It starts with a default spending limit of $10 per month, charged to the organization. Requires theapplication:edit permission.
major app browser
Drive the browser in an app sandbox. Navigation is limited to the preview server atlocalhost:3000.