update

Update an existing deployment with new content. The live URL stays the same.

npx based-page update --id <id> [options]

Options

Flag	Description
--id <id>	Deployment ID to update (required)
--html <string>	New inline HTML content
--file <path>	Path to a new HTML file
--title <title>	Update the page title
--description <text>	Update the meta description
--favicon <emoji>	Update the favicon emoji
--protect	Enable share-link protection
--unprotect	Remove protection
--password <pass>	Set or update the password gate
--remove-password	Remove the password while keeping share-link protection

Either --html or --file is required.

Examples

Update content from a file

npx based-page update --id dep_abc123 --file index.html

Update with inline HTML

npx based-page update --id dep_abc123 --html '<h1>Updated!</h1>'

Update metadata only

npx based-page update --id dep_abc123 --file index.html --title "New Title" --description "New description"

Finding the Deployment ID

Run npx based-page list to see all deployments with their IDs:

npx based-page list

Output

Updated successfully!

URL: https://my-site.based.page
ID:  dep_abc123

Notes

• The URL never changes - only the content updates.
• Updates go live immediately.
• You can switch from --html to --file (or vice versa) on any update.