wp-cinematic-init

/wp-cinematic-init

Use this when the demo is not a standard sectioned page but a cinematic scroll-driven reel: persistent video stage, N scenes that crossfade/scrub as the user scrolls, mobile autoplay-loop fork, motion-toggle, reduced-motion guard.

This command is a thin shim. It does three things and hands off:

Step 0 — Detect kit

Check in order:

1. Globally-installed skill: ~/.skills/yojahny55/cinematic-scroll-kit/schemas/scene.json
2. Project-local: ./.cinematic-kit/schemas/scene.json
3. Vendored fallback inside the plugin: <plugin>/starter-theme/__cinematic__/assets/cinematic-kit/schemas/scene.json

If none found AND --skip-kit-install not set → run:

npx skills add yojahny55/cinematic-scroll-kit -g -y

If npx skills is unavailable, fall back to:

git clone --depth 1 https://github.com/yojahny55/cinematic-scroll-kit .cinematic-kit

If both fail → use vendored fallback and log: "Using vendored kit copy (offline mode). Update later with /wp-cinematic-init --update-kit."

Step 1 — Hand off to /wp-init

Invoke /wp-init --path=<path> --mode=cinematic --starter=__cinematic__ --acf-flavor=<scf|acf-pro> and let the standard bootstrap run:

• Project name/slug/text domain/languages
• Server choice (Nginx native, Docker, etc.)
• Database
• ACF flavor

When /wp-init reaches the "section scaffolding" phase, it skips the usual /wp-section loop and instead dispatches to step 2 below.

Step 2 — Cinematic scaffold (dispatch wp-cinematic agent)

Pass to the wp-cinematic agent:

{
  "schema_path": "<resolved kit path>/schemas/scene.json",
  "project_slug": "<from /wp-init>",
  "text_domain": "<from /wp-init>",
  "languages": ["en", "es"],
  "acf_flavor": "<scf|acf-pro>",
  "scene_count": 9,
  "hybrid": true
}

The agent produces every file listed in its Outputs you produce table.

Step 3 — Wire and seed

1. Activate the theme via wp theme activate <slug>.
2. Run wp eval-file inc/seed-cinematic.php to populate the placeholder scenes.
3. Run wp eval-file inc/seed-menus.php if menus haven't been seeded yet.
4. Print next steps:
   • Replace placeholder videos: /wp-cinematic-encode <input.mp4> --scene=N
   • Author scene content: /wp-cinematic-scene <n>
   • Add trailing sections (pricing/contact): /wp-section <name> --hybrid
   • Preview demo: /wp-cinematic-demo