CI/CD

API keys for automated deploys, and GitHub push-to-deploy.

API Keys

Create long-lived API keys for automated deployments in CI/CD pipelines:

# Create a new key
spky token create

# List keys
spky token list

# Revoke a key
spky token revoke <key-id>

Use the key in CI by setting the environment variable:

export SPOOKY_API_KEY=spk_live_...
spky deploy

No browser login is required when SPOOKY_API_KEY is set.

GitHub Integration

Link a GitHub repository for automated deployments on push:

# Set up auto-deploy
spky link connect

# Check link status
spky link status

# Configure settings
spky link settings --branch main --auto-deploy true

# Manually trigger a deploy
spky link trigger

# View recent build runs
spky link runs

# Remove the link
spky link disconnect

Note

GitHub integration installs a GitHub App on your repository. Pushes to the configured branch automatically trigger a build and deploy.

A linked build reads sp00ky.yml from the pushed commit the same way spky deploy reads it locally: the apps and their deploy: blocks, the surrealdb: block, anonymousLiveQueries, deployment.env and sync:. Keep the committed manifest in step with what you last deployed by hand, because the push is what the next deployment is built from.