Overview

@byteplus-iga-pages/astro is the official Astro adapter for BytePlus IGA Pages. It converts Astro build output into an BytePlus IGA Pages-compatible deployment format, supporting static sites, hybrid rendering, and server-side rendering.

Installation

Install the adapter in your Astro project:

npm install @byteplus-iga-pages/astro

Usage

Enable the adapter in astro.config.mjs:

import { defineConfig } from "astro/config";
import igaAdapter from "@byteplus-iga-pages/astro";

export default defineConfig({
  adapter: igaAdapter(),
});

Options

Use includeFiles and excludeFiles to adjust files copied into the server bundle:

export default defineConfig({
  adapter: igaAdapter({
    includeFiles: ["./extra/runtime-file.json"],
    excludeFiles: ["./node_modules/example/large-file.bin"],
  }),
});

Deployment

After building, deploy the project with the BytePlus IGA Pages CLI:

bp-iga pages deploy

License

SEE LICENSE IN LICENSE