Skill Store 33

Tanstack Cli

TanStack Config for shared build tooling, Vite plugins, and package configuration across TanStack…

by oakoss · MIT

The skill

TanStack Config for shared build tooling, Vite plugins, and package configuration across TanStack projects. Use when configuring TanStack library builds or contributing to TanStack packages. Use for tanstack-config, tanstack-cli, vite-plugin, package-config, library-build.

TanStack Config

Overview

TanStack Config provides opinionated tooling to build, version, and publish JavaScript/TypeScript packages with minimal configuration and consistent results. It uses Vite for library builds with automatic dual ESM/CJS output and type generation, plus automated publishing with conventional-commit-based versioning.

When to use: Building TanStack libraries or packages that follow TanStack conventions, contributing to TanStack open-source projects, setting up dual ESM/CJS library builds with Vite, automating package publishing with conventional commits.

When NOT to use: Application builds (use framework-specific tooling), non-library projects, projects not using pnpm, projects that need non-Vite build pipelines.

Quick Reference

Pattern API / Package Key Points
Vite build config tanstackViteConfig() from @tanstack/vite-config Merge with defineConfig via mergeConfig
Entry point entry: './src/index.ts' Single file or array of entry files
Source directory srcDir: './src' Used for declaration file generation
CJS output cjs: true (default) Generates .cjs and .d.cts alongside ESM
External deps externalDeps: [/^@internal\//] Auto-detected from package.json, extend with patterns
Bundled deps bundledDeps: ['tiny-invariant'] Bundle instead of externalize
Exclude from types exclude: ['./src/**/*.test.ts'] Patterns to skip during type generation
Custom tsconfig tsconfigPath: './tsconfig.build.json' Override default tsconfig for builds
Declaration hook beforeWriteDeclarationFile(path, content) Transform .d.ts content before write
Publish automation publish() from @tanstack/publish-config Conventional commits drive versioning
Branch configs branchConfigs: { main, beta, alpha } Control prerelease and stable channels
Package list packages: [{ name, packageDir }] Monorepo package definitions
Build script vite build && publint --strict Standard build with strict linting

Common Mistakes

Mistake Correct Pattern
Missing "type": "module" in package.json Set "type": "module" for ESM-first builds
Using defineConfig alone without mergeConfig Use mergeConfig(defineConfig({...}), tanstackViteConfig({...}))
Forgetting entry or srcDir options Both are required for tanstackViteConfig to work
Missing exports field in package.json Define import and require conditions with types
Not awaiting publish() promise Handle with .then() and .catch() for error reporting
Using npm or yarn instead of pnpm pnpm is the only supported package manager
Omitting publint --strict from build script Add publint --strict after vite build to catch packaging issues
Setting tag without v prefix Manual version tags must start with v (e.g., v1.0.0)
Wrong commit type for release level fix/refactor/perf = patch, feat = minor, BREAKING CHANGE = major

Requirements

  • Node.js v18.17+
  • pnpm v8+
  • Git CLI
  • GitHub CLI (pre-installed on GitHub Actions)
  • Vite (peer dependency for build config)
  • publint (recommended for build validation)

Delegation

  • Build configuration review: Use Task agent to verify Vite config and package.json exports
  • Publishing workflow setup: Use Explore agent to check CI/CD integration patterns
  • Package validation: Run publint --strict after builds to catch packaging issues

References

Use this skill

Connect your agent to the Skill Store MCP server and ask for it by ref: oakoss/tanstack-cli-29152143474.

Download SKILL.md · Markdown version

Details

Publisher
oakoss
Category
Software Development › Developer docs & tooling
License
MIT
Updated
2026-08-17

References

More from oakoss

  • Accessibility Build WCAG 2.2 AA compliant interfaces with semantic HTML, ARIA, keyboard navigation, focus manag…
  • Agent Patterns Multi-agent design patterns for Claude Code and AI development systems.
  • Agent Session Search Coding Agent Session Search - unified CLI/TUI to index and search local coding agent history from…
  • Agent Standards Defines behavioral and cognitive standards for senior AI engineering agents.

Related skills

  • Tanstack Devtools Centralized, extensible devtools panel for TanStack libraries with a plugin architecture.
  • Tanstack Config Opinionated toolkit for building, versioning, and publishing high-quality JavaScript/TypeScript p…
  • Tanstack Start Best practices for TanStack Start, the full-stack React framework built on TanStack Router and Vi…
  • Vite Vite build tool configuration and ecosystem.
  • Chat Mode Authoring Author Copilot chat modes and instructions