Configuration

Srcpack looks for configuration in the following order:

1. srcpack.config.ts (recommended)
2. srcpack.config.js
3. srcpack field in package.json

Basic Structure

import { defineConfig } from "srcpack";

export default defineConfig({
  outDir: ".srcpack",
  bundles: {
    // bundle definitions
  },
  upload: {
    // optional upload config
  },
});

Options

Option	Type	Default	Description
outDir	string	.srcpack	Output directory for bundles
bundles	object	—	Named bundles (required)
upload	object	—	Upload destination

Bundle Definitions

Each bundle can be defined in three ways:

String (Simple Glob)

bundles: {
  app: "src/**/*",
}

Array (Multiple Patterns)

Use ! prefix to exclude:

bundles: {
  api: ["src/**/*", "!src/**/*.test.ts"],
}

Object (Full Options)

bundles: {
  docs: {
    include: "docs/**/*.md",
    outfile: "~/Downloads/docs.txt",
    index: false,
  },
}

Bundle options:

Option	Type	Default	Description
include	string | string[]	—	Glob pattern(s)
outfile	string	{outDir}/{name}.txt	Custom output path
index	boolean	true	Include index header

Pattern Syntax

Patterns follow standard glob syntax with special prefixes:

Pattern	Matches
src/**/*	All files under src/
*.ts	TypeScript files in root
**/*.ts	TypeScript files anywhere
!**/*.test.ts	Exclude test files
+**/*.local.md	Force-include, bypass .gitignore
{src,lib}/**/*	Files in src/ or lib/

Force-Include (+ prefix)

Use + to include files that would normally be excluded by .gitignore:

bundles: {
  docs: [
    "docs/**/*",           // all docs (respects .gitignore)
    "+docs/**/*.local.md", // force-include local notes
  ],
}

Automatic Exclusions

Srcpack automatically excludes:

• Files matching .gitignore patterns
• Binary files (images, fonts, compiled assets)
• node_modules/
• .git/
• Lock files (package-lock.json, yarn.lock, etc.)

Examples

Monorepo

export default defineConfig({
  bundles: {
    web: "apps/web/**/*",
    api: "apps/api/**/*",
    shared: "packages/shared/**/*",
  },
});

Frontend + Backend

export default defineConfig({
  bundles: {
    client: ["src/client/**/*", "src/shared/**/*"],
    server: ["src/server/**/*", "src/shared/**/*"],
  },
});

Exclude Tests and Mocks

export default defineConfig({
  bundles: {
    app: [
      "src/**/*",
      "!src/**/*.test.ts",
      "!src/**/*.spec.ts",
      "!src/**/__mocks__/**",
    ],
  },
});

Package.json Config

{
  "srcpack": {
    "bundles": {
      "app": "src/**/*"
    }
  }
}

TypeScript Support

The defineConfig helper provides type checking and autocomplete:

import { defineConfig } from "srcpack";

export default defineConfig({
  // Full autocomplete here
});