Overview

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

Installation

Install the adapter in your Astro project:

npm install @iga-pages/astro

Usage

Enable the adapter in astro.config.mjs:

import { defineConfig } from "astro/config";
import igaAdapter from "@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 IGA Pages CLI:

iga pages deploy

License

MIT © Beijing Volcano Engine Technology Co., Ltd.