# shipany-page-builder

> Create new dynamic pages from a short spec (keywords, route/path, reference content).

- Author: weykon
- Repository: weykon/unified-building-agents
- Version: 20260112185313
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/weykon/unified-building-agents
- Web: https://mule.run/skillshub/@@weykon/unified-building-agents~shipany-page-builder:20260112185313

---

---
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 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.**

## Dev workflow (required)

- Before starting: Ensure project skeleton is available
- Before starting: Verify route/slug parameters are normalized
- After finishing:
  - Clear Next.js cache: `rm -rf .next`
  - Run `pnpm build` to validate (ensure no errors)
  - Verify new page is accessible

## Inputs (normalize first)

Normalize 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 bundled script to create files + register 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