@zokugun/configdotts-merge

@zokugun/configdotts-merge is a TypeScript library for merging multiple configuration files (such as Vite, ESLint, Prettier, etc.) written in .ts, while preserving comments.

• Supports export default {...}, export default anyFunction({...}), export default variable, and function/arrow-based configs.
• Preserves comments.
• Uses TypeScript’s AST for safe, reliable merging.

Features

• Comment Preservation: No more lost documentation in your config files!
• Smart Merging: Last value wins for conflicts; merges arrays and objects intelligently.
• TypeScript Native: Built on TypeScript’s AST for perfect .ts compatibility.
• Supports Major Tools: Vite, ESLint, Prettier, Tailwind, and more.

Getting Started

With node previously installed:

npm install @zokugun/configdotts-merge

import { readFileSync } from 'fs';
import { merge } from '@zokugun/configdotts-merge';

const baseConfig = readFileSync('vite.base.config.ts', 'utf-8');
const siteConfig = readFileSync('vite.site.config.ts', 'utf-8');
const mergedConfig = merge(baseConfig, siteConfig);
console.log(mergedConfig); // Merged config, comments intact!

Donations

Support this project by becoming a financial contributor.

License

Copyright © 2025-present Baptiste Augrain

Licensed under the MIT license.