Pages Deploy Skill#

Overview#

One-click deployment of static website code to BytePlus / VolcEngine Edge Pages platform. Designed for use in Coding Agents (Cursor, Claude Code, Trae, etc.) to quickly complete hosting, building, and CDN integration after generating static web pages.

Use Cases#

• Deploy static web code generated by Coding Agent
• Deploy local static sites to global CDN
• Bind custom domains to deployed sites
• Iteratively update existing Pages projects

Prerequisites#

1. AK/SK Configuration: Requires BytePlus / VolcEngine Access Key and Secret Key

   • Mira client: Stored in secrets/byteplus.json, format: {"access_key": "xxx", "secret_key": "xxx"}
   • Manual config: nest config set -g cloud.access_key YOUR_AK && nest config set -g cloud.secret_key YOUR_SK

2. Static site directory: A directory containing index.html

CLI Commands#

Full Deployment (Auto-detects create vs. update)#

bash

# Auto-detect: creates project if not exists, updates deployment if exists
bash /path/to/scripts/deploy.sh --name my-site --dir ./dist

# Specify description and acceleration region
bash /path/to/scripts/deploy.sh --name my-site --dir ./dist --desc "AI generated site" --region global

# Bind custom domain
bash /path/to/scripts/deploy.sh --name my-site --dir ./dist --domain www.example.com

Parameters#

ParameterRequiredDescription--nameYesPages project name--dirYesStatic site resource directory (must contain index.html)--descNoProject description--regionNoAcceleration region: global / chinese_mainland / outside_chinese_mainland``--domainNoCustom domain--build-cmdNoBuild command to run before deployment (e.g. npm run build)--secrets-fileNoAK/SK config file path (default: secrets/byteplus.json)

Other Operations#

bash

# List projects
bash /path/to/scripts/manage.sh list

# Show project details
bash /path/to/scripts/manage.sh get --pages p-xxx

# Show deployment history
bash /path/to/scripts/manage.sh deployments --pages p-xxx

# Local preview
bash /path/to/scripts/manage.sh serve --dir ./dist --port 8080

# Domain management
bash /path/to/scripts/manage.sh domain-list --pages p-xxx
bash /path/to/scripts/manage.sh domain-add --pages p-xxx --domain www.example.com
bash /path/to/scripts/manage.sh domain-verify --pages p-xxx --domain www.example.com

# Offline / Delete
bash /path/to/scripts/manage.sh offline --pages p-xxx
bash /path/to/scripts/manage.sh delete --pages p-xxx

Complete Workflow#

text

Step 0: Environment Setup (one-time) → Install CLI + Configure AK/SK
Step 1: Coding Agent generates code → ./my-site/
Step 2: Local preview → nest pages serve ./my-site
Step 3: Deploy → deploy.sh --name xxx --dir ./my-site
Step 4: Check domain → manage.sh get --pages p-xxx
Step 5: Bind domain → deploy.sh --name xxx --dir ./my-site --domain www.example.com
Step 6: Iterative update → deploy.sh --name xxx --dir ./my-site
Step 7: Manage → manage.sh list / deployments / offline

Notes#

• China mainland production does not provide a default domain; a custom domain must be bound for access
• CLI package name is @byteplus/nest (not @byted/nest)
• CDN propagation takes 1-5 minutes after deployment
• Custom domains require adding a CNAME record at your DNS provider