Syncing

Keep your Versoly site in sync with your codebase

Versoly acts as the source of truth for synced components, pages and site settings.

Using the CLI

pnpm dlx @versoly/cli sync

The CLI pulls all files into your configured directories based on your Versoly config file.

Note syncing is one way from Versoly to your codebase. Local changes will not be synced to Versoly. On the next sync Versoly will override these changes. You can disable syncing for components. In the future we may add the ability to sync back to Versoly.

Disabling sync

If you decide it is easier for you to maintain a component or page yourself at the top of the file you can add

// @versoly/sync-disable

When the CLI is ran it will skip those files.

For more advanced disabling you can add exclude to Versoly config file

export default defineConfig({
  // ... other config options
  "exclude": ["public/robots.txt"],
});

This will disable robots.txt syncing in the public folder.

© 2026 Versoly

Powered proudly by Versoly