wix-cli-app-validation

Validates Wix CLI applications through installation, TypeScript compilation, build, and preview steps.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/yaelbro/Shelf-Control --skill wix-cli-app-validation-yaelbro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wix-cli-app-validation
Source: https://github.com/yaelbro/Shelf-Control/tree/main/.agents/skills/wix-cli-app-validation
Command: npx skills add https://github.com/yaelbro/Shelf-Control --skill wix-cli-app-validation-yaelbro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It verifies that a Wix CLI application is ready for release by running a sequential validation workflow, catching dependency, type, build, and preview errors before deployment. ## Core Features & Use Cases - Four-Step Validation Workflow: Runs package installation, TypeScript compilation check, build, and preview deployment in sequence, stopping at the first failure. - Targeted TypeScript Checks: Supports checking specific extension directories (dashboard pages, site widgets, modals, backend) for faster feedback during iterative development. - Debug Log Diagnostics: Reads .wix/debug.log when steps fail to surface full error traces and stack details. - Use Case: After implementing a new dashboard page extension, run validation to confirm TypeScript compiles, the build succeeds, and preview URLs are generated for manual verification. ## Quick Start Validate my Wix app and confirm it builds and previews successfully before release.

Frequently Asked Questions about wix-cli-app-validation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a Wix CLI app before release?

Run the four-step workflow: install dependencies with your detected package manager, check types with npx tsc --noEmit, build with npx wix build, and start the preview with npx wix preview. Stop and fix errors at whichever step fails.

How to run TypeScript checks on specific Wix extension files?

Use npx tsc --noEmit with targeted paths, such as src/extensions/dashboard/pages/**/*.ts, to check only the files you changed. This gives faster feedback during iterative development than a full project check.

Which package manager does Wix app validation use?

The package manager is detected from lock files: package-lock.json means npm, yarn.lock means yarn, and pnpm-lock.yaml means pnpm. If no lock file exists, npm is used by default.

Why does wix build fail without a clear error message?

Truncated terminal output can hide the real error. Read .wix/debug.log in the project root for the full error trace and stack details; the last 100 lines usually contain the most recent failure.

What should I do when the Wix preview server fails to start?

Check wix.config.json for configuration issues and port conflicts first. If the cause is unclear, read .wix/debug.log for details; for stale CLI state, delete the .wix directory and rebuild.