Export

Pagesmith can push your site’s source code to a GitHub repository. The exported code follows an Astro project structure. Portability depends on the project’s adapter, integrations, environment variables, and data services.

GitHub export is available on eligible plans. Check the current pricing page for plan availability.

GitHub Integration

Connect your GitHub account to push your site code to a repository.

Connecting GitHub

1. Open your project in the AI Editor
2. Go to Workspace → GitHub
3. Click Connect GitHub
4. Authorize Pagesmith to access your GitHub account
5. Select or create a repository for your project

Pushing Your Code

Once connected:

1. Go to Workspace → GitHub
2. Click Push to GitHub
3. Your site code is committed and pushed to the connected repository

Each push includes the selected project version from Pagesmith. Check the GitHub panel for branch and synchronization details before editing the same files in both places.

Two-Way Sync

Pagesmith also supports pulling changes back from GitHub. If you edit code locally and push to the connected repository, you can pull those changes into Pagesmith from the GitHub panel. See the GitHub integration guide for details on the bidirectional sync flow.

What Gets Exported

The repository contains the Astro project files, which can include:

• src/pages/: Page routes and Astro files
• src/components/: Reusable components
• src/layouts/: Page layouts
• src/content/: Content collections such as blog posts or documentation
• src/styles/: Project styles
• public/: Static assets such as images and fonts
• astro.config.mjs: Astro configuration
• package.json: Dependencies and scripts
• TypeScript configuration: Project types and compiler settings

Inspect astro.config.mjs and package.json to see the output mode, integrations, and adapter used by your project.

Using Your Exported Code

After pushing, you can:

• Clone the repository to your local machine
• Run locally with npm install && npm run dev
• Build the project with the package-manager command defined in the repository
• Customize the code in your preferred editor
• Continue development with your own team

Deployment Options

Choose a host that supports the project’s Astro output mode and required runtime.

Pagesmith hosting: No migration is required when you continue publishing from Pagesmith.

Other hosts: Netlify, Vercel, Cloudflare, and Node.js providers support different Astro output modes. You may need to change the adapter and service integrations.

See the Astro deployment documentation for current provider instructions.

Keeping Code in Sync

Use the GitHub panel to push later Pagesmith changes. Pull remote changes before editing the same files again in Pagesmith, and resolve any conflicts before publishing.