​

runtm validate

runtm validate [path] [options]

​

Arguments

​

Options

​

What Gets Validated

​

1. Manifest (runtm.yaml)

• Required fields present (name, template)
• runtime required for standard templates (not for docker template)
• Valid template type (backend-service, static-site, web-app, docker)
• Valid runtime type (python, node, fullstack)
• Valid port number
• Tier requirements (fullstack needs standard+)
• Feature requirements (auth needs database)

​

2. Lockfile

• Lockfile exists and matches dependencies
• No drift between pyproject.toml/package.json and lockfile

​

3. Python Imports (for Python projects)

• All imports in production code are resolvable
• Dependencies are in [project] dependencies, not dev deps

​

4. Artifact Size

• Project zips to under 20MB (respecting .runtmignore)

​

Examples

# Validate current directory
runtm validate

# Validate specific project
runtm validate ./my-project

# JSON output for AI agents
runtm validate --json

​

JSON Output

runtm validate --json

{
  "valid": true,
  "errors": [],
  "warnings": ["No runtm.discovery.yaml found"]
}

{
  "valid": false,
  "errors": ["Missing runtm.yaml - run `runtm init backend-service`"],
  "warnings": []
}

​

Output

​

Success

✓ Manifest valid
✓ Lockfile in sync
✓ Python imports verified
✓ Artifact size: 2.1 MB

Ready to deploy!

​

Failure

✗ Validation failed

Errors:
  • Manifest: tier must be 'standard' or higher for fullstack runtime
  • Lockfile: bun.lockb is out of sync. Run 'runtm fix' or 'bun install'
  • Import: Cannot import 'httpx' - add to [project] dependencies

​

Common Issues

runtm fix

bun install  # Node.js
uv lock      # Python

# ✓ Correct
[project]
dependencies = [
    "httpx>=0.24",
]

# ✗ Wrong - these won't be installed in production
[project.optional-dependencies]
dev = [
    "httpx>=0.24",
]

# runtm.yaml
tier: standard  # Not starter

# runtm.yaml
features:
  database: true  # Required
  auth: true

node_modules/
.venv/
__pycache__/
.git/
dist/
build/

​

Validation Cache

runtm deploy --force-validation

​

Skip Validation

runtm deploy --skip-validation

​

Related Commands

• runtm fix - Auto-fix common issues
• runtm deploy - Deploy after validation