atelier-typescript-build-tools_skill

Overview

This skill provides a ready-to-use TypeScript build tooling stack using Bun, tsgo, Vitest, Biome, and Turborepo. It bundles best-practice package.json scripts, CI examples, and configuration snippets to speed up project setup and consistent developer workflows. Use it to standardize builds, typechecks, tests, linting/formatting, and monorepo orchestration.

How this skill works

The skill supplies script patterns and config templates that call Bun as the package manager and task runner, tsgo for fast typechecking, Vitest for tests and V8 coverage, Biome for linting and formatting, and Turborepo for monorepo orchestration. It includes example vitest.config, biome.json, tsconfig.json, turbo.json, and recommended CI job steps so you can copy, adapt, and run them immediately. Scripts are organized for single-package and monorepo roots, with watch, build, test, lint, and check flows.

When to use it

• Bootstrapping a new TypeScript project and wanting a modern, fast toolchain.
• Migrating existing projects from tsc/eslint/prettier to a unified stack.
• Setting up CI jobs that must be fast and reproducible with frozen lockfiles.
• Orchestrating builds and tests across a monorepo with Turborepo.
• Adding V8 coverage reporting and global test setup (e.g., DB migrations).
• Enforcing consistent formatting and linting across workspace packages.

Best practices

• Use bun install and bun run for package tasks; prefer bun run test to avoid Bun's native test runner.
• Run checks in order: typecheck, lint, then test so failures surface early.
• Use tsgo --noEmit for fast CI typechecking instead of tsc when possible.
• Enable Vitest V8 coverage and include/exclude patterns to get accurate reports.
• Share biome.json via a workspace package for consistent lint/format rules in monorepos.

Example use cases

• Single-package app: scripts for dev, build, typecheck, test, lint, format, and a composite check script.
• Monorepo root: turbo-powered dev, build, typecheck, test, lint pipelines and remote caching.
• CI pipeline: GitHub Actions example that installs Bun, runs bun install --frozen-lockfile, then typecheck, lint, and test.
• Integration tests with global setup: run DB migrations before tests via Vitest globalSetup.
• Cloudflare Workers and Vite: Vitest worker pool and vite config examples for Workers runtime.