FAQ

Can I use Pagewell with Astro?

Yes. Pagewell can generate Astro pages by reading PAGEWELL.md, DESIGN.md, and the Astro adapter, then following the repo's existing routes, layouts, components, metadata, and static build conventions.

bunx skills add ReScienceLab/pagewell --skill pagewell

Installs the Pagewell agent skill via skills.sh.

Read setup doc

How it works

The Astro adapter keeps generation inside existing conventions.

For an Astro repo, Pagewell should inspect astro.config.*, src/pages, content collections, layouts, components, metadata helpers, and discovery files before creating a route.

  • If similar pages use file-based .astro routes, Pagewell creates a route under src/pages.
  • If similar pages use content collections and dynamic routes, Pagewell adds content to that system.
  • If the page is a free tool, Pagewell prefers Astro plus a small framework-free script instead of adding React or another client framework.

Example

This page uses Astro file routing.

generated route
site/src/pages/faq/can-i-use-pagewell-with-astro.astro
imports:
  - BaseLayout via GeneratedPage.astro
  - FAQPage JSON-LD
  - BreadcrumbList JSON-LD
context:
  - PAGEWELL.md
  - DESIGN.md
  - adapters/astro.md

FAQ

Common questions, answered directly.

Can I use Pagewell with Astro?

Yes. Pagewell can generate Astro pages by reading PAGEWELL.md, DESIGN.md, and the Astro adapter, then following the repo's existing routes, layouts, components, metadata, and static build conventions.

Install Pagewell

Ready to add Pagewell to your Astro site?

Install Pagewell and let the Astro adapter generate routes that follow your existing layouts and components.

bunx skills add ReScienceLab/pagewell --skill pagewell

Installs the Pagewell agent skill via skills.sh.

Read install docs