Create GitHub Repository
varity_create_repoDestructive
Creates a GitHub repository and pushes your local project code to it for dynamic deployments, or generates a repo from a SaaS template when no path is given.
Instructions
Create a new GitHub repository and push the current project to it. For custom apps (the primary use case): pass the 'path' parameter with the local project directory, this creates an empty repo and pushes your actual code to GitHub. The GitHub URL is required for dynamic deployments, always call this before varity_deploy. For template-based quick-start: omit 'path' to create from the Varity SaaS template. Requires a GitHub personal access token (classic) with repo scope from https://github.com/settings/tokens.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Repository name (lowercase, hyphens allowed, e.g. 'my-app') | |
| path | No | Absolute path to the local project directory to push to GitHub (e.g. '/home/user/my-app'). When provided, pushes the actual project code. Required for custom apps that will use varity_deploy with dynamic hosting. If omitted, creates a repo from the Varity SaaS template instead. | |
| visibility | No | Repository visibility | public |
| description | No | Short description of your app (optional) | |
| github_token | No | GitHub personal access token (optional if GITHUB_TOKEN env var is set). Needs 'repo' scope. |