Shipany Page Builder

---
name: shipany-page-builder
description: Create new dynamic pages from a short spec (keywords, route/path, reference content).
---

# ShipAny Page Builder (Dynamic Pages)

This skill creates **new pages** using ShipAny’s **dynamic page builder** approach: a page is rendered from a JSON file (per-locale), and activated by registering that JSON path in `localeMessagesPaths`.

This skill is intentionally **much simpler** than `shipany-quick-start`: it only creates new dynamic pages.

## v1 edit scope (hard limit)

For v1, you may **only**:

- Add **new** multi-language dynamic page JSON files:
  - `src/config/locale/messages/en/pages/**` (new page JSON files only)
  - `src/config/locale/messages/zh/pages/**` (new page JSON files only)
- Update `src/config/locale/index.ts`:
  - Append the new `'pages/<slug>'` entry to `localeMessagesPaths` (do not duplicate)

Hard rules:

- Do **not** modify any existing page JSON files (only create new ones).
- Do **not** touch routing code, layouts, components, or theme blocks.
- Do **not** add or edit any images under `public/`. **Use placeholder images in JSON only.**

## Inputs (normalize first)

Normalize the user request into:

- `route`: string (e.g. `/features/ai-image-generator`)
- `slug`: string (derived from route, e.g. `features/ai-image-generator`)
- `keywords`: string[] (3–10)
- `referenceCopy`: optional raw text snippets, bullets, competitor copy, or notes
- `sectionsWanted`: optional list of section keys (default: `["hero","introduce","benefits","features","faq","cta"]`)

See `references/00-guide.md`.

## Execution order

1. Normalize input + decide route/slug: `references/00-guide.md`
2. Generate locale files (based on configured `localeNames`) and register `'pages/<slug>'`:
   - Use `scripts/create_dynamic_page.py`
3. Quick validation checklist: `references/01-checklist.md`
4. Validate build (required):
   - Build: `pnpm build`

## Bundled script (recommended)

Use the bundled script to create files + register the message path:

- `scripts/create_dynamic_page.py`

It is intentionally conservative:

- Creates missing folders
- Refuses to overwrite unless `--force`
- Adds `TODO:` markers for missing translations/content