@teo-garcia/vitest-config-shared

Shared Vitest configuration for React and Next.js projects

Part of the @teo-garcia/templates ecosystem

Features

| Config | Target | Includes | | --------- | ---------- | ------------------------------------------------------------------- | | react | React/Vite | Browser mode (Playwright), React plugin, globals, coverage defaults | | next | Next.js | React config + vite-tsconfig-paths + Next-oriented test globs |

Requirements

• Vitest 4+
• Node.js 20+

Installation

pnpm add -D @teo-garcia/vitest-config-shared

# Peer dependencies
pnpm add -D vitest @vitejs/plugin-react @vitest/browser-playwright vite-tsconfig-paths

Usage

React projects

// vitest.config.ts
import sharedConfig from '@teo-garcia/vitest-config-shared'
import { defineConfig } from 'vitest/config'

export default defineConfig(sharedConfig)

Next.js projects

// vitest.config.ts
import sharedConfig from '@teo-garcia/vitest-config-shared/next'
import { defineConfig } from 'vitest/config'

export default defineConfig(sharedConfig)

Add local setup files (optional)

If your app needs extra setup (for example @testing-library/jest-dom), merge your local config:

import sharedConfig from '@teo-garcia/vitest-config-shared'
import { defineConfig, mergeConfig } from 'vitest/config'

export default mergeConfig(
  defineConfig(sharedConfig),
  defineConfig({
    test: {
      setupFiles: ['./vitest.setup.ts'],
    },
  })
)

Exports

| Export | Description | | --------------------------------------- | --------------------------- | | @teo-garcia/vitest-config-shared | React/Vite config (default) | | @teo-garcia/vitest-config-shared/next | Next.js optimized config |

Default behavior

• Enables Vitest globals.
• Runs tests in browser mode using Playwright + Chromium (headless).
• Sets sane timeouts for async/browser tests.
• Applies v8 coverage defaults for source files under src and app.

Scripts

{
  "scripts": {
    "test": "vitest",
    "test:browser": "vitest --browser",
    "test:ui": "vitest --ui",
    "coverage": "vitest run --coverage"
  }
}

Related Packages

| Package | Description | | ------------------------------------------------------------------------------------------ | ------------------- | | @teo-garcia/eslint-config-shared | ESLint rules | | @teo-garcia/prettier-config-shared | Prettier formatting | | @teo-garcia/tsconfig-shared | TypeScript settings | | @teo-garcia/react-shared | Shared React primitives |

License

MIT