tanstack/maintain-custom-addons-dev-watch
packages/cli/skills/maintain-custom-addons-dev-watch/SKILL.md
Build and iterate custom add-ons/templates with tanstack add-on init, add-on compile, add-on dev, and tanstack create --dev-watch, including sync loop preconditions, watch-path validation, and project metadata constraints.
$ install --global
skillsauthnpx skillsauth add tanstack/cli maintain-custom-addons-dev-watchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 4:54 AM37.6s1 file scanned
SKILL.md
- name:
- maintain-custom-addons-dev-watch
- description:
- >
- type:
- lifecycle
- library:
- tanstack-cli
- library_version:
- 0.62.1
Maintain Custom Add-ons In Dev Watch
Use this skill for local add-on authoring workflows where you continuously compile and sync package output into a target app.
Setup
npx @tanstack/cli add-on init
npx @tanstack/cli add-on compile
Core Patterns
Run add-on dev loop while editing source
npx @tanstack/cli add-on dev
Sync watched framework directory into a sandbox target app
# --dev-watch is a flag on `create`, not on `dev`
npx @tanstack/cli create my-sandbox --dev-watch ../path/to/framework-dir
Re-run compile before apply when changing metadata
npx @tanstack/cli add-on compile
npx @tanstack/cli add my-custom-addon
Common Mistakes
HIGH Use --dev-watch with --no-install
Wrong:
npx @tanstack/cli create my-sandbox --dev-watch ../my-addon-package --no-install
Correct:
npx @tanstack/cli create my-sandbox --dev-watch ../my-addon-package
Dev-watch rejects --no-install, so automated loops fail before any sync work starts.
Source: packages/cli/src/dev-watch.ts:112
HIGH Start dev-watch without valid framework directory
Wrong:
npx @tanstack/cli create my-sandbox --dev-watch ../missing-or-invalid-dir
Correct:
npx @tanstack/cli create my-sandbox --dev-watch ../valid-framework-dir
Watch setup validates that the path exists, is a directory, and contains at least one of add-ons/, assets/, or framework.json. Invalid targets fail before file syncing begins.
Source: packages/cli/src/command-line.ts:599
CRITICAL Author add-on from code-router project
Wrong:
npx @tanstack/cli add-on init
Correct:
# Run add-on init from a file-router project
npx @tanstack/cli add-on init
Custom add-on authoring expects file-router mode and exits when run from incompatible project modes.
Source: packages/create/src/custom-add-ons/add-on.ts
HIGH Run add-on workflows without scaffold metadata
Wrong:
npx @tanstack/cli add-on dev
Correct:
# Run in a project scaffolded by TanStack CLI (contains .cta.json), then:
npx @tanstack/cli add-on dev
Custom add-on flows rely on persisted scaffold options, so missing metadata blocks initialization and update paths.
Source: packages/create/src/custom-add-ons/shared.ts:158
HIGH Tension: Backwards support vs deterministic automation
This domain's patterns conflict with add-addons-existing-app. Tooling assumes reusable automation, but hidden metadata preconditions from legacy support make add-on loops non-portable across repositories.
See also: add-addons-existing-app/SKILL.md § Common Mistakes
Related Skills
tanstack/query-docs-library-metadata
development
VerifiedTrustedCommunity
Retrieve machine-readable context with tanstack libraries, tanstack doc, tanstack search-docs, tanstack create --list-add-ons --json, and --addon-details for agent-safe discovery and preflight validation.
1,230SKILL.mdUpdated Apr 15, 2026
tanstack/create-app-scaffold
tools
VerifiedTrustedCommunity
Scaffold a TanStack app with tanstack create using --framework, --template, --toolchain, --deployment, --add-ons, and --router-only. Covers flag compatibility, non-interactive defaults, and intent-preserving command construction.
1,230SKILL.mdUpdated Apr 15, 2026
tanstack/choose-ecosystem-integrations
development
VerifiedTrustedCommunity
Map tanstack ecosystem partner metadata to installable add-on ids using tanstack ecosystem --json, tanstack create --list-add-ons --json, and tanstack create --addon-details --json. Covers exclusive categories, provider options, and router-only compatibility constraints.
1,230SKILL.mdUpdated Apr 15, 2026
tanstack/add-addons-existing-app
data-ai
VerifiedTrustedCommunity
Apply integrations to existing projects with tanstack add, including add-on id resolution, dependency chains, option prompts, and .cta.json project metadata preconditions.
1,230SKILL.mdUpdated Apr 15, 2026