Deployment

Package Mode#

This theme which >= v4.0.0 has integrated NPM package mode. Recommended way is remove local package file, and install the theme integration from NPM. If there’s some reason you want to change the package content, you should link local package to your theme template. A bun method is integrated. You should:

1. Add environment variable BUN_LINK_PKG=true.
2. Run bun pure check to link the package automatically.

This method can also work on other deployment platforms as needed. Add the environment variable to your platform’s build settings. The build command astro-pure check && astro check && astro build will automatically link the package.

Deployment Mode#

Cloudflare#

This site targets Cloudflare Workers/Pages. Refer to Astro’s Cloudflare guides for platform-specific settings.

Node server#

If you are deploying with Node.js locally, you need to install @astrojs/node first:

bun add '@astrojs/node'

Then follow the comments in astro.config.ts and configure Node:

import node from '@astrojs/node'

export default defineConfig({
  // ...
  adapter: node({ mode: 'standalone' })
})

Bun server#

Bun also support static method.

Check @nurodev/astro-bun ↗ for more.

Static#

Remove all server adapter configuration in astro.config.ts and set a static build:

export default defineConfig({
  // ...
  output: 'static'
})

GitHub Pages#

See Astro: Configure Astro for GitHub Pages ↗.