# Shipany Quick Start

> Automate first-pass customization of a new ShipAny (ShipAny Two) project from a short project brief (app name, domain/app URL, product description/features, reference links, and branding preferences). Use when the user says they are starting a new project.

- Skill: `majiayu000/shipany-quick-start` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/shipany-quick-start`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/shipany-quick-start/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/shipany-quick-start

---


# ShipAny Quick Start (Project Bootstrap)

This skill is intentionally split into small reference modules. Load only the module(s) you need.

## v1 edit scope (hard limit)

For the first pass, **only modify the files listed in** `references/09-checklist.md`.

- Do **not** change any other files (no routing, no components, no templates, no extra locale message files).
- Do **not** introduce login/auth/payment features unless explicitly requested.

## Dev workflow (required)

- Before starting edits: run `pnpm install` (once) to ensure dependencies are installed.
- After finishing all edits: **clear Next.js cache** before validation, otherwise you may see stale assets (e.g. old `logo.png`):
  - macOS/Linux: `rm -rf .next`
  - Windows (PowerShell): `Remove-Item -Recurse -Force .next`
  - Windows (cmd): `rmdir /s /q .next`
- Then run `pnpm build` to validate the project (build + lint checks). If it fails, fix issues **only within the v1 allowlist** unless the user expands scope.

## Project brief

Normalize the user’s request first:

- `references/00-project-brief.md`

## Execution order (ShipAny Two)

1. App basics (env-driven): `references/01-env-app-info.md`
2. SEO metadata: `references/02-seo-metadata.md`
3. Landing page (EN/ZH): `references/03-landing-page.md`
   - Page sections live in `src/config/locale/messages/{locale}/pages/index.json`
   - Header/footer/nav live in `src/config/locale/messages/{locale}/landing.json`
4. Theme styles: `references/04-theme-styles.md`
5. Logo + favicon: `references/05-logo-favicon.md`
6. Sitemap: `references/06-sitemap.md`
7. Legal pages: `references/07-legal-pages.md`
8. Images (extract from links or use Picsum placeholders): `references/08-images.md`
9. Minimal checklist: `references/09-checklist.md`

## Bundled script

- `scripts/fetch_og_image.py`: Best-effort OG/Twitter preview image downloader for a reference link.