@savvy-web/templates

@savvy-web/templates

Pure TypeScript templates for Silk Suite project scaffolding. Each template takes typed options (validated with Effect Schema) and returns TemplateEntry[] -- a list of { name, filename, content } records. No filesystem calls; you decide where and how to write the output.

Features

• Generate config files for package.json, tsconfig, Biome, Turborepo, pnpm, changesets, VS Code, gitignore, and README
• Validate all inputs at runtime with Effect Schema
• Compose an entire workspace scaffold from a single createWorkspace call
• Zero side effects -- templates return plain strings, never touch disk

Installation

pnpm add @savvy-web/templates effect

effect is a peer dependency.

Quick Start

import { createPackageJson } from "@savvy-web/templates";

const entries = createPackageJson({
  name: "@my-org/my-lib",
  description: "A useful library",
  type: "module",
  license: "MIT",
  exports: { ".": "./src/index.ts" },
});

for (const entry of entries) {
  console.log(entry.filename); // "package.json"
  console.log(entry.content);  // sorted, formatted JSON
}

API

Every create* function accepts an options object (or unknown -- Schema validates at runtime) and returns TemplateEntry[].

TemplateEntry

interface TemplateEntry {
  readonly name: string;     // logical name, e.g. "tsconfig"
  readonly filename: string; // suggested path, e.g. "tsconfig.json"
  readonly content: string;  // generated file content
}

Templates

Function	Output file	Key options
createPackageJson	package.json	name, version, type, exports, scripts, dependencies, engines, publishConfig
createTsConfig	tsconfig.json	extends, composite, include, exclude, references
createBiome	biome.jsonc	version, extends, root
createTurboRoot	turbo.json	tasks, globalDependencies, globalEnv, ui, concurrency
createTurboWorkspace	turbo.json	tasks (extends root with ["//"])
createPnpmWorkspace	pnpm-workspace.yaml	packages, autoInstallPeers, catalogMode, catalog
createChangeset	.changeset/config.json	access, baseBranch, changelog, repo
createVsCode	.vscode/settings.json, .vscode/extensions.json	settings (biome, turbo, vitest), extensions
createGitignore	.gitignore	sections (node, build, env, os, silk), additional
createReadme	README.md	name, description

Workspace Compositor

createWorkspace composes multiple templates into a full monorepo scaffold:

import { createWorkspace } from "@savvy-web/templates";

const entries = createWorkspace({
  name: "my-monorepo",
  packageManager: "pnpm",
  packageManagerVersion: "10.33.0",
  nodeVersion: "24.11.0",
  features: {
    biome: true,
    turbo: true,
    changesets: true,
    vscode: true,
    vitest: true,
  },
});

// entries contains: package.json, tsconfig.json, .gitignore, README.md,
// pnpm-workspace.yaml, biome.jsonc, turbo.json, .changeset/config.json,
// .vscode/settings.json, .vscode/extensions.json

Each feature flag is optional and defaults to false. The compositor always generates package.json, tsconfig.json, .gitignore, and README.md. pnpm-workspace.yaml is added automatically when packageManager is "pnpm".

License

MIT